List keywords

Keywords behind this brand’s topics, most-seen first.


GET /brands/{brand_id}/keywords

Authorization

Header	Type	Required
`Authorization`	`Bearer asky_sk_…`	required

Path parameters

Parameter	Type	Required	Description
`brand_id`	`uuid`	required	From List brands

Query parameters

Parameter	Type	Required	Description
`limit`	`integer`	optional	Rows per page, 1 to 100. Defaults to 20.
`cursor`	`string`	optional	Opaque cursor from the previous response. Treat it as a token, never construct one.
`topic_id`	`uuid`	optional	Only keywords linked to this topic. Keywords link to topics many-to-many, so one keyword can appear under several. Includes the topic and its subtopics. A root topic returns everything beneath it; a subtopic returns only itself.
`search`	`string`	optional	Case-insensitive substring of the keyword.
`language`	`string`	optional	Two-letter language code, e.g. en.

Request


curl https://api.askylabs.com/v1/brands/BRAND_ID/keywords \
  -H "Authorization: Bearer $ASKY_API_KEY"

Response


{
  "data": [
    {
      "id": "0040b9b0-c938-481e-8c7e-55043d2c5483",
      "keyword": "content operations",
      "topics": [
        {
          "id": "69f00661-a909-4e4e-8ea4-96507d2168b0",
          "is_primary": true
        }
      ],
      "mention_count": 0,
      "language": "en",
      "gsc_position": null,
      "first_seen_at": "2026-08-08T16:55:54.104155+00:00",
      "last_seen_at": "2026-08-08T16:55:54.104155+00:00"
    },
    {
      "id": "005246b2-5597-45a0-a82a-ef7384759021",
      "keyword": "how often ai mentions us",
      "topics": [
        {
          "id": "1fe547fc-f083-4b58-b808-5f955ce61d50",
          "is_primary": true
        }
      ],
      "mention_count": 0,
      "language": "en",
      "gsc_position": null,
      "first_seen_at": "2026-08-08T16:52:50.676043+00:00",
      "last_seen_at": "2026-08-08T16:52:50.676043+00:00"
    }
  ],
  "pagination": {
    "limit": 2,
    "has_more": true,
    "next_cursor": "eyJ2IjoxLCJvIjoyLCJsIjoyfQ"
  },
  "meta": {
    "total": 1052
  },
  "request_id": "req_5e4632dfd5c6423b81fa"
}