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.