Skip to main content
Competitors are brands that appear alongside yours in AI responses. Topify.ai auto-detects them and lets you choose which ones to actively track.

​
List competitors

GET /api/v2/competitors/list

List competitors for a project.
Query parameters:
ParamTypeDescription
project_idstring (UUID)Target project
user_idstring (UUID)Your user ID
statusstringFilter by state: active, pending, or inactive
Response: List of competitors with brand name, website, state, visibility, sentiment, position, and total mention count.

​
Track a competitor

POST /api/v2/competitors/track

Activate a suggested competitor or add a new one.
Request body:
FieldTypeRequiredDescription
project_idstring (UUID)YesTarget project
brand_namestringYesCompetitor brand name
Tracking a competitor starts daily metric collection. Active competitor counts are subject to your plan’s limit.

​
Reject a competitor

POST /api/v2/competitors/reject

Reject a suggested competitor.
Request body:
FieldTypeRequiredDescription
project_idstring (UUID)YesTarget project
competitor_idstring (UUID)YesCompetitor to reject
Rejected competitors move to the inactive state and are no longer shown as suggestions.