SurfacedBySurfacedBy Docs
DocumentationAPIReference

Competitors

Read the set of domains that AI platforms mention alongside yours for your tracked keywords.

Ask an AI:Open in ChatGPTOpen in Claude

Competitors are derived from each scan's answer set: when an AI platform names another domain in a response to one of your tracked prompts, that domain becomes a candidate. The list endpoint returns the rolled-up view; the single-competitor endpoint drills into the prompts and scans where a specific domain was mentioned.

Competitor data is read-only for both Professional and Business. To change which competitors a scan considers, edit tracked prompts in the dashboard or via the Prompts endpoints.

GET
/domains/{domain_id}/competitors
/domains/{domain_id}/competitors

Path Parameters

domain_id
Required
Domain Id

Query Parameters

cursorCursor

Header Parameters

X-API-KeyX-Api-Key

curl -X GET "https://example.com/domains/string/competitors?cursor=string" \
  -H "X-API-Key: string"

Successful Response

null

GET
/domains/{domain_id}/competitors/{competitor_id}
/domains/{domain_id}/competitors/{competitor_id}

Path Parameters

domain_id
Required
Domain Id

competitor_id
Required
Competitor Id

Header Parameters

X-API-KeyX-Api-Key

curl -X GET "https://example.com/domains/string/competitors/string" \
  -H "X-API-Key: string"

Successful Response

null