1. Labels
swonkie.dev
  • Introduction
  • Quick Start
  • Changelog
  • Social Networks
    • Facebook
    • Instagram
    • LinkedIn
    • TikTok
    • Threads
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Insights
    • Getting Started
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • List Posts
      GET
    • Get a Post
      GET
    • Create a Post
      POST
    • Update a Post
      PUT
    • Validate a Post
      GET
    • Delete a Post
      DELETE
    • Change Post Stage
      PATCH
  • Labels
    • Getting Started
    • List Labels
      GET
    • Create a Label
      POST
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Labels

List Labels

GET
/labels/
Retrieves a paginated list of all labels (tags) in your workspace. Labels are used to organize and categorize posts, making it easier to filter and manage your content calendar. Each label has a name and an optional color for visual identification in the interface.

Notes#

Labels are workspace-specific - you can only see labels from your own workspace.
Use the label IDs when creating or updating posts to tag them with specific labels.
Labels help organize your content calendar and can be used to filter posts in the GET /posts endpoint.
Labels are also available within Insights Posts, allowing filter and agregate analytical data.
The color field is optional and used for visual identification in the user interface.

Request

Query Params

Header Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.swonkie.dev/v2/labels/?skip=0&take=100' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'
Response Response Example
{
    "items": [
        {
            "id": "TGFiZWxJZDExMTExMTEx",
            "name": "Product Launch",
            "color": "#FF5733"
        },
        {
            "id": "TGFiZWxJZDIyMjIyMjIy",
            "name": "Marketing Campaign",
            "color": "#00BFFF"
        },
        {
            "id": "TGFiZWxJZDMzMzMzMzMz",
            "name": "Social Media",
            "color": "#32CD32"
        }
    ],
    "total": 15,
    "skip": 0,
    "take": 20
}
Modified at 2026-03-11 19:13:35
Previous
Getting Started
Next
Create a Label
Built with