Skip to main content
GET
/
api
/
v1
/
public
/
competitors
/
citations
Get Competitor Citations
curl --request GET \
  --url https://api.tryhikoo.com/api/v1/public/competitors/citations \
  --header 'Authorization: Bearer <token>'
{
  "entities": [
    {
      "id": 123,
      "name": "<string>",
      "url": "<string>",
      "citation_count": 123,
      "is_website": true,
      "logo_url": "<string>"
    }
  ],
  "total_citations": 123,
  "others_count": 123
}

Authorizations

Authorization
string
header
required

Personal API key created in the dashboard (Settings > API keys).

Headers

authorization
string | null

Bearer <api_key>

X-MCP-Secret
string | null

Query Parameters

time_range
enum<string> | null
Available options:
all_time,
1y,
1m,
1w,
1d
platforms[]
enum<string>[] | null
Available options:
ChatGPT,
Gemini,
AI Overviews,
Google AI Mode,
Perplexity,
Mistral,
Claude,
DeepSeek,
Grok,
Copilot
localizations[]
string[] | null
topic_ids[]
integer[] | null
website_id
integer
required

Target website id

Response

Successful Response

Response with citation counts per entity for a time range.

others_count = citations where neither the website nor any active (in-plan) competitor was cited. Used by the competitors-page donut as a dedicated slice so the chart denominator stays coherent without front-side arithmetic on total_citations.

entities
EntityCitationCount · object[]
required
total_citations
integer
required
others_count
integer
required