Cookbook
Find your domain id
List the domains your API key can see and read the domainId every other recipe starts from
GET
/domainsEvery recipe needs a domainId; this call lists the domains your API key can reach with each one's id, displayName, url, and market.
How this example works
idis an opaque string identifier — the value you pass everywhere asdomainId. Always read theidfield; treat it as opaque and never parse or construct it yourself.- The response lists every domain this key can access. There is no lookup-by-URL endpoint — fetch the list once and match on
urlyourself. marketLanguageCodePairsis what feedsmarketLanguageCodePairIdlater. Each entry is{ id, market, languageCode }whereidis<marketCode>-<languageCode>(e.g."US-en"); note the pairs available here before scoping an aggregated query to one market.
curl "https://api.getmint.ai/api/domains" \
-H "X-API-Key: $MINT_API_KEY"Response (an array, trimmed; full shape in API reference):
[
{
"id": "69b0495c672f51c1d55da2d1",
"displayName": "Nike",
"name": "nike",
"url": "https://nike.com",
"market": "US",
"aliases": ["Nike Inc."],
"ownedSources": ["nike.com"],
"marketLanguageCodePairs": [
{ "id": "US-en", "market": "US", "languageCode": "en" }
]
}
]