v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Post Labels

List Labels

List the labels that you can use to organize your posts.

get/api/{account}/posts/labels

Query parameters

limitstring

Number of labels to return (default = 10)

Number of labels to return (default = 10)

offsetstring

Number of labels to skip for pagination

Number of labels to skip for pagination

Response

Success

Example response

{
  "data": {
    "list": [
      {
        "id": "archived",
        "name": "Archive",
        "type": "archived",
        "isClearInProgress": false,
        "postsCount": 0,
        "posts": []
      },
      {
        "id": "private_archived",
        "name": "Private Archive",
        "type": "private_archived",
        "isClearInProgress": false,
        "postsCount": 0,
        "posts": []
      },
      {
        "id": 123,
        "name": "My new label",
        "type": "custom",
        "isClearInProgress": false,
        "postsCount": 123,
        "posts": []
      }
    ],
    "order": "asc",
    "sort": "default",
    "hasMore": false,
    "nextOffset": 10,
    "hashSort": "abc123"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999940,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49987
    }
  }
}