Get company competitors
Returns the competitive landscape for a company, a ranked list of competitors, the dimensions the market splits on, and a short summary of the competitive landscape.
What you need
A Specter companyId in the path. If you only have a domain, website, or name, get the ID first with Find company ID (batch, free), or find it by name with Search entities by name.
Behaviour
- Cache-first: a company that’s already been analysed returns instantly; one that’s never been analysed computes the full landscape on demand and is slower.
- Results older than 30 days are recomputed automatically, so the landscape is never more than 30 days stale.
last_updatedreports when it was last computed. - At most 30 competitors are returned;
limit(1–30) only narrows that set; it can’t raise the ceiling above 30. - The request body is optional; omit it to use the default
limitof 30. - Returns
404if the company doesn’t exist.
What you do next
- Enrich the landscape. Follow each competitor’s
company_idto Get company by ID for its full profile. - Track the set. Add the competitors to a company list with Create company list to monitor them over time.
Authorizations
Path Parameters
The Specter company ID.
Body
Maximum number of competitors to return. 30 is also the hard ceiling - the endpoint never returns more than 30.
1 <= x <= 30Response
The company's competitive landscape, ranked competitors, the dimensions the market splits on, and a summary of the competitive landscape.
Competitors ranked by how directly they compete (closest first).
The dimensions the market splits on for this company.
A one-line headline summarising the competitive set.
"A crowded payments market led by full-stack platforms."
A short summary of the competitive landscape.
ISO 8601 timestamp of when this landscape was last computed. Results older than 30 days are recomputed automatically, so this is never more than 30 days in the past.
"2026-06-01T00:00:00Z"