Competitors
Read the confirmed competitors for a tracked domain.
The competitors endpoints return a domain's confirmed competitors: the same list the dashboard's Competitors page uses. Competitors that are still unreviewed, that were dismissed, or that the dashboard hides are not returned. The single-competitor endpoint returns one row from that list, and a competitor outside the list returns 404 not_found. A domain the key cannot read returns 404 domain_not_found.
Both endpoints are read-only and available on Professional and Agency. Confirming, dismissing, or adding competitors is done in the dashboard.
Competitor object
| Field | Description |
|---|---|
id | Competitor id, used as competitor_id. |
domain_id | The tracked domain this competitor belongs to. |
competitor_domain | The competitor's domain. |
display_name | The name the competitor's own site declares, or null. It is never guessed from the domain. |
discovery_source | added_by_you when someone in your workspace entered the competitor (in the dashboard or during setup), detected when SurfacedBy found it in AI answers. |
user_confirmed | Whether the competitor is confirmed. Always true in these responses. |
discovered_at | When the competitor was first found. |
last_updated | When the competitor record last changed. The list is sorted by this field, newest first. |
GET
/
domains/{domain_id}/competitorsPath Parameters
domain_idRequiredDomain Id
Query Parameters
cursorCursor
Header Parameters
X-API-KeyX-Api-Key
Successful Response
GET
/
domains/{domain_id}/competitors/{competitor_id}Path Parameters
domain_idRequiredDomain Id
competitor_idRequiredCompetitor Id
Header Parameters
X-API-KeyX-Api-Key
Successful Response