Skip to content
MentionBird.ai
Browse the documentation

Add Owned Domains

Declare domains as the brand's own, or a competitor's. Citations of them are then labelled yours or competitor:<name> instead of earned. Requires a write-enabled API key.

POST /brands/owned-domains

Request body

Send as application/json. This endpoint needs a write-enabled API key.

Field Type Description
brand required string Tracked brand name.
domains required array of string Domains, e.g. example.com. Allowed: 1–50 items, each up to 255 characters.
competitor string A competitor's name, from listCompetitors, to act on that competitor. Omit it to act on the brand itself.
include_subdomains boolean Match subdomains too.

Example request

curl -X POST -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "brand": "Acme",
  "domains": [
    "openai"
  ]
}' \
  "https://api.mentionbird.ai/api/v1/brands/owned-domains"

Responses

200
Done. The body reports the outcome for each item.
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.