Skip to content
MentionBird.ai
Browse the documentation

List Tracked Brands

List every brand this workspace tracks. Call this first — other endpoints take the brand name exactly as returned here.

GET /brands/tracked

Example request

curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  "https://app.mentionbird.ai/api/v1/brands/tracked"

Example response

Recorded from a live call against a demo workspace, so the shape is exactly what the endpoint returns.

{
  "has_more": false,
  "items": [
    {
      "brand": "Acme",
      "domain": "acme.com"
    }
  ],
  "returned_count": 1,
  "total_count": 1
}

Responses

200
List of tracked brands.
400
Validation error — check the message in `error.message`.
401
Unauthorized — missing, invalid or revoked bearer token.
403
Forbidden — plan lacks API access, or key is read-only.
404
Not found — the brand, prompt or resource does not exist.
405
Method not allowed.
500
Internal error — logged; retry is safe for reads.