Enrich citations end-to-end

GET/domains/{domainId}/explorer/citations

POST/domains/{domainId}/sources/enrichment

The full "Sources" workflow: pull citation rows, collect their unique URLs, ask the enrichment endpoint for each URL's category and any brand mentions on the page, then join back by URL.

How this example works

Enrichment is keyed by reportId. Brand-mention and crawl fields come from the crawl that produced the citations — pass the citations' reportId, or detectedBrands and content fields come back empty.
POST /sources/enrichment caps the batch max 100 URLs per call — batch larger sets into chunks of 100 (the example does this).
The response is a map keyed by URL; URLs with no category and no crawl data are omitted. Treat a missing key as "not enriched".

curl "https://api.getmint.ai/api/domains/$DOMAIN_ID/explorer/citations?page=1&limit=100&promptCategory=visibility" \
  -H "X-API-Key: $MINT_API_KEY"

curl -X POST "https://api.getmint.ai/api/domains/$DOMAIN_ID/sources/enrichment" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $MINT_API_KEY" \
  -d '{
    "urls": ["https://techcrunch.com/2026/01/10/footwear-trends", "https://g2.com/products/nike/reviews"],
    "reportId": "507f1f77bcf86cd799439011"
  }'

Response (enrichment map, trimmed; full shape in API reference):

{
  "https://techcrunch.com/2026/01/10/footwear-trends": {
    "sourceCategory": "Internet and Telecom > Technology News",
    "detectedBrands": [
      { "name": "Nike", "count": 12, "isBrand": true },
      { "name": "Adidas", "count": 8, "isBrand": false }
    ],
    "contentLength": 4820,
    "wordCount": 780,
    "publicationDate": "2026-01-10T00:00:00.000Z"
  }
}

Request body (sources enrichment)

Prop

Type

Variations

Change	Effect
`promptCategory=visibility` on the fetch	Only citations from visibility analysis (brand mentioned or not)
Keep merged rows whose `detectedBrands` has `isBrand: false`	Surface which sources mention your competitors
Flatten fetched citations to columns (`promptText`, `source`, `link`, `model`, `topicName`)	Export citations to CSV
Tally `sourceCategory` across the enrichment map	Build a source-category breakdown of your citations

Common follow-ups

Citation Share for owned domains

Turn the merged rows into an owned-vs-rest citation share.

Citations & Sources reference

Full parameter reference, response fields, and error codes.

Ask an agent instead

The list_explorer_citations MCP tool returns citation rows, agent-ready.

curl "https://api.getmint.ai/api/domains/$DOMAIN_ID/explorer/citations?page=1&limit=100&promptCategory=visibility" \ -H "X-API-Key: $MINT_API_KEY" curl -X POST "https://api.getmint.ai/api/domains/$DOMAIN_ID/sources/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $MINT_API_KEY" \ -d '{ "urls": ["https://techcrunch.com/2026/01/10/footwear-trends", "https://g2.com/products/nike/reviews"], "reportId": "507f1f77bcf86cd799439011" }'

{ "https://techcrunch.com/2026/01/10/footwear-trends": { "sourceCategory": "Internet and Telecom > Technology News", "detectedBrands": [ { "name": "Nike", "count": 12, "isBrand": true }, { "name": "Adidas", "count": 8, "isBrand": false } ], "contentLength": 4820, "wordCount": 780, "publicationDate": "2026-01-10T00:00:00.000Z" } }

Variations

Change	Effect
`promptCategory=visibility` on the fetch	Only citations from visibility analysis (brand mentioned or not)
Keep merged rows whose `detectedBrands` has `isBrand: false`	Surface which sources mention your competitors
Flatten fetched citations to columns (`promptText`, `source`, `link`, `model`, `topicName`)	Export citations to CSV
Tally `sourceCategory` across the enrichment map	Build a source-category breakdown of your citations