Quickstart

1. Find your brands

Most endpoints take a brand name. Get the exact spelling from here rather than typing it — the match is on the name as we store it.

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

2. Read its visibility

How often the brand shows up in AI answers over the last 30 days, with its average rank and sentiment.

curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  "https://app.mentionbird.ai/api/v1/visibility?brand=Acme"

Add group_by=day for a time series, or group_by=provider to compare ChatGPT, Claude, Gemini, Perplexity and Grok.

3. See who you are losing to

The brands named most often across the same prompts, each with its own sentiment.

curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  "https://app.mentionbird.ai/api/v1/brands/top-mentioned?brand=Acme"

Reading more than one page

Endpoints that take limit also take offset. Every list reply carries total_count and has_more. While has_more is true, repeat the call with offset raised by limit.

total_count is the true size of the matching set, not the size of the page you were handed.

Dates

Endpoints that accept start_date and end_date take them as YYYY-MM-DD. Leave them out and you get the last 30 days.

Every reply echoes what it actually used under filters_applied, so you can confirm a filter was understood.