Browse the documentation
List Tracked Prompts
List the prompts tracked for a brand, with their search-volume and difficulty buckets and the prompt ID token other endpoints need.
GET
/queries
Query parameters
| Name | Type | Description |
|---|---|---|
| brand required | string | Tracked brand name, exactly as returned by listTrackedBrands. |
| query_tag | string | Filter to one tag slug — see listQueryTags. |
| include_archived |
boolean
default False |
Also list archived prompts. |
Example request
curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
"https://api.mentionbird.ai/api/v1/queries?brand=Acme"
Example response
Recorded from a live call against a demo workspace, so the shape is exactly what the endpoint returns.
{
"has_more": false,
"items": [
{
"archived": false,
"archived_llms": [],
"brand_prompt_id": "bp:1:pNyl51MRfDXTGNpGSGObq_I3JkpWzDiIPFU8ItHOXPs",
"country": "ZZ",
"difficulty_bucket": 4,
"llms": [
"openai"
],
"search_volume_bucket": 7,
"tags": [
"comparison"
],
"text": "best crm"
}
],
"returned_count": 1,
"total_count": 1
}
Responses
- 200
- Tracked prompts. llms lists the AI platforms each runs on, archived_llms the ones it was removed from, and archived is true when it runs on none.
- 400
- Validation error — check the message in `error.message`.
- 401
- Unauthorized — missing, invalid or revoked bearer token.
- 403
- Forbidden — the plan lacks API access, the key is read-only, or addTrackedBrand would pass the tracked-brand limit.
- 404
- Not found — the brand, prompt or resource does not exist.
- 405
- Method not allowed.
- 429
- Too many requests — over the key's per-minute or per-day limit. Wait the seconds in the `Retry-After` header, then retry.
- 500
- Internal error — logged; retry is safe for reads.