Lumirank Get a competitor
/v1/competitors/{competitor_id}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.
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.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/competitors/c77d2e91-5b4a-4f3c-8d2e-7a6b5c4d3e21"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"}List competitors GET
Returns the brands that AI answers name next to yours, sorted by name. By default the list has the tracked and suggested competitors. To see the dismissed competitors, send `status=dismissed`. Your own brand is not in this list. To read it, call `GET /v1/brand`.
Update a competitor PATCH
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.