List topics & competitors

GET/domains/{domainId}/topics

Topics are where visibility and competition live; this call lists a domain's topics with each one's id, name, market, language, and configured competitors.

How this example works

Competitors are defined per topic, not per domain. Each competitors entry is an object { id, name, urls, aliases }, and its name is exactly what keys the chartData.competitors map in visibility responses — a competitor absent here never appears in a comparison chart.
Topics carry their own market and language. A domain tracked in several markets has parallel topics, one set per market, rather than one topic covering many locales.
keywords drive prompt generation for the topic — they shape the questions asked of the models, which in turn produce the visibility reports.

curl "https://api.getmint.ai/api/domains/$DOMAIN_ID/topics" \
  -H "X-API-Key: $MINT_API_KEY"

Response (an array, trimmed; full shape in API reference):

[
  {
    "id": "6a329f667302e8920567835c",
    "name": "Running shoes",
    "market": "US",
    "language": "en",
    "keywords": ["running shoes", "trail running", "marathon shoes"],
    "competitors": [
      { "id": "6736c1a8a0b2f1e2d3c4b5a6", "name": "Adidas", "urls": ["https://adidas.com"], "aliases": [] },
      { "id": "6736c1a8a0b2f1e2d3c4b5a7", "name": "New Balance", "urls": ["https://newbalance.com"], "aliases": ["NB"] }
    ]
  }
]

Common follow-ups

Visibility Score

Get this topic's headline score and its change vs the previous period.

Compare competitors

Turn these competitor names into a multi-line comparison chart.

[ { "id": "6a329f667302e8920567835c", "name": "Running shoes", "market": "US", "language": "en", "keywords": ["running shoes", "trail running", "marathon shoes"], "competitors": [ { "id": "6736c1a8a0b2f1e2d3c4b5a6", "name": "Adidas", "urls": ["https://adidas.com"], "aliases": [] }, { "id": "6736c1a8a0b2f1e2d3c4b5a7", "name": "New Balance", "urls": ["https://newbalance.com"], "aliases": ["NB"] } ] } ]