Get paginated visibility sources with NAS metrics
Returns the sources cited by visibility answers, grouped by domain or listed per URL, with a Need Attention Score (NAS = 100 × V* × (1 − M_shrunk)) computed on the fly. Supports server-side filtering and sorting, and returns the filter option values needed to build multi-select dropdowns (skip them with includeFilterOptions=false). A page past the end returns no rows and the true total. Responses are cached for 60 seconds.
X-API-Key<token>API Key for programmatic access
domainId*stringUUID of the domain
uuidpage?numberPage number (1-based)
1 <= value1limit?numberItems per page (1-1000, default 50)
1 <= value <= 100050startDate?stringStart of the report date range (ISO 8601)
endDate?stringEnd of the report date range (ISO 8601)
models?array<string>Global filter: LLM models the report was run with (repeat the param, or send one comma-separated value)
viewMode?stringGroup rows by source domain, or list individual cited URLs (default: domain)
"domain""url"filterModels?array<string>Multi-select filter on LLM model (repeat the param, or send one comma-separated value)
filterPrompts?array<string>Filter by exact prompt texts (use repeated params, not comma-separated)
sourceSearch?stringPartial match on the source/domain column
sortOrder?stringSort direction (default: desc)
"asc""desc"topicId?stringRestrict to one topic
competitorName?stringView the sources as they look for this competitor instead of the tracked brand
filterCategories?array<number>Multi-select filter on source category codes (repeat the param, or send one comma-separated value)
filterOwnership?array<>Filter by source ownership relative to the brand and its topic competitors (comma-separated)
tagIds?array<string>Keep only results from prompts carrying at least one of these tag UUIDs (OR semantics, comma-separated)
sortBy?stringField to sort by (default: needAttentionScore). Ties are ordered by source
"source""volume""mentionRate""needAttentionScore"includeFilterOptions?booleanCompute filterOptions with the page (default: true). When false, filterOptions is null; read them from /sources/visibility/filter-options
truePaginated visibility sources with NAS metrics and filter options
application/json- response
data*array<>Paginated source rows with NAS metrics
total*numberTotal number of sources matching filters
page*numberCurrent page number (1-indexed)
limit*numberNumber of items per page
totalPages*numberTotal number of pages
hasNext*booleanWhether there is a next page
hasPrev*booleanWhether there is a previous page
filterOptions*|nullFilter options for dropdowns. Null when the request set includeFilterOptions=false.
maxVolume*numberMaximum volume for bar chart scaling
curl -X GET 'https://api.getmint.ai/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/sources/visibility'{ "data": [ { "source": "techcrunch.com", "volume": 42, "mentionRate": 65, "mentionRateDecimal": 0.65, "vStar": 0.82, "mShrunk": 0.6, "needAttentionScore": 33, "categories": [ "Internet and Telecom / Technology News" ] } ], "total": 142, "page": 1, "limit": 50, "totalPages": 3, "hasNext": true, "hasPrev": false, "filterOptions": { "models": [ { "value": "chatgpt", "label": "GPT-5", "score": 72 } ], "prompts": [ { "value": "chatgpt", "label": "GPT-5", "score": 72 } ], "allModelsScore": 72, "allPromptsScore": 68, "categories": [ { "code": 10020, "name": "Internet and Telecom / Technology News" } ] }, "maxVolume": 120}