Skip to Content
APIEndpointsList keywords

List keywords

Not available yet. This endpoint is switched off while keywords are being reworked, and requests to it return 404. Asky still uses keywords behind the scenes; to steer what it tracks, create prompts instead.

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

GET /brands/{brand_id}/keywords

Authorization

HeaderTypeRequired
AuthorizationBearer asky_sk_…required

Path parameters

ParameterTypeRequiredDescription
brand_iduuidrequiredFrom List brands

Query parameters

ParameterTypeRequiredDescription
limitintegeroptionalRows per page, 1 to 100. Defaults to 20.
cursorstringoptionalOpaque cursor from the previous response. Treat it as a token, never construct one.
topic_iduuidoptionalOnly 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.
searchstringoptionalCase-insensitive substring of the keyword.
languagestringoptionalTwo-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" }
Last updated on