Introduction
End-to-end recipes for recreating the GetMint dashboards with the public API
Every page here is a recipe — a runnable walkthrough that recreates one dashboard element from the public REST API alone. Each names its endpoint, flags the gotchas that matter, and gives the same example in curl, TypeScript, and Python (your choice sticks between recipes).
What you'll need
- An API key — sent as X-API-Key on every call.
- Your domain ID (and usually a topic ID) — the first recipe looks both up.
- Any HTTP client — TypeScript examples use plain
fetch(Node 18+), Python usesrequests.
All calls target one base URL:
https://api.getmint.ai/apiGive your AI assistant context
Building with an AI assistant? Paste this in first to prevent common mistakes:
GetMint API conventions:
- Base URL https://api.getmint.ai/api, auth header X-API-Key.
- Dates are ISO (YYYY-MM-DD), inclusive. Omitting startDate = last 6 months (not all-time).
- "Variation" fields compare an equal-length window immediately before the requested one.
- Array query params (models, tagIds) are comma-separated.
- Pagination is 1-indexed: page/limit, responses carry total/totalPages (most add hasNext/hasPrev; the mentions leaderboard omits them — page off page < totalPages).
- Rate limit: 200 requests/min per key, shared between REST and MCP.
- Visibility scores are 0-100 mention rates, not ranks. Competitors are defined per topic.Prefer working from an agent? The MCP server exposes the same data as tools — each recipe links its agent-ready equivalent.
Recipes
Setup
Conventions & gotchas
Read once: windows, variation semantics, arrays, pagination.
Data model
How organizations, domains, topics, prompts, and reports nest.
Endpoints at a glance
Every recipe endpoint and its key response field, one table.
Find your domain ID
Every call needs a domainId. Look yours up programmatically.
List topics & competitors
Topics carry the competitor lists every visibility response uses.
Visibility
Visibility Score for one asset
The headline tile: score for a window plus change vs the prior window.
Visibility over time
Build the visibility line chart from chartData[].
Headline score and the daily series, together
One call returns both — and why averaging the series won't match.
Top-N leaderboard
Rank every brand by share of voice on a topic.
Compare your asset to competitors over time
Multi-line chart from the per-competitor time series.
Segment Visibility by model, region, or persona
models, market-language pairs, and prompt tags as segmentation axes.
Citations
Citation Share for your owned domains
What share of AI citations point at properties you own.
Citation Share and volume over time
Daily share line and citation volume from one response.
Citation Rank by domain (with deltas)
Leaderboard of cited domains with period-over-period movement.
Enrich citations end-to-end
Fetch citations, enrich with categories and brand mentions, merge.