Skip to content
MentionBird.ai
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.