Browse the documentation

Get Owned vs Earned Share

How citations split between domains the brand owns, competitor-owned domains and earned third-party coverage.

GET /sources/owned-share

Query parameters

Name	Type	Description
brand required	string	Tracked brand name, exactly as returned by listTrackedBrands.
start_date	string	ISO start date (YYYY-MM-DD). Defaults to 30 days ago.
end_date	string	ISO end date (YYYY-MM-DD). Defaults to today.
llm_provider	string	Filter to one AI platform. One of: `openai` `claude` `gemini` `perplexity` `grok`

Example request

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

Example response

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

{
  "competitor": 0,
  "competitor_pct": 0.0,
  "earned": 0,
  "earned_pct": 0.0,
  "filters_applied": {
    "brand": "Acme",
    "end_date": "2026-09-24",
    "llm_provider": null,
    "start_date": "2026-08-26"
  },
  "no_owned_domains_declared": true,
  "total": 0,
  "yours": 0,
  "yours_pct": 0.0
}

Responses

200: Ownership breakdown.
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.