Lumirank Update a competitor
/v1/competitors/{competitor_id}Changes the status of a competitor to tracked, suggested, or dismissed, the same as the Competitors page of the dashboard. Reports use the new status at once, for past dates too.
Your own brand's id gets status 400, because the status of your own brand cannot change.
Authorization
apiKey An API key that you create in the Lumirank dashboard, on the Settings > API keys page. Send it in the Authorization header: Bearer lr_....
In: header
Path Parameters
The id of the competitor.
uuidRequest Body
application/json
The new status.
TypeScript Definitions
Use the request body type in TypeScript.
The new status of the competitor.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/competitors/c77d2e91-5b4a-4f3c-8d2e-7a6b5c4d3e21" \ -H "Content-Type: application/json" \ -d '{ "status": "tracked" }'competitor
{ "id": "c77d2e91-5b4a-4f3c-8d2e-7a6b5c4d3e21", "name": "Globex", "aliases": [ "Globex CRM", "Globex Corp" ], "domain": "globex.com", "domain_verified": true, "status": "tracked", "first_seen_at": "2026-07-03T04:00:00Z", "last_seen_at": "2026-10-07T05:12:00Z"}Get a competitor GET
Returns 1 competitor of your brand, in any status. Your own brand's id, and the id of another brand's competitor, get status `404`, the same as an id that does not exist.
List answers GET
Returns AI answers with their text, 1 row per answer, oldest first. The list has only complete answers, the same answers as the Results page of the dashboard: an answer that is still running or that failed is not in the list. `start_date` and `end_date` select answers by `answered_at`. To get the brands and sources in each answer, call `/v1/mentions` and `/v1/citations`, and match their rows to the answers by `answer_id`. The answers of archived prompts are left out unless you send `include_archived=true`.