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.
API Key for programmatic access
In: header
Path Parameters
UUID of the domain
uuidQuery Parameters
Page number (1-based)
1 <= value1Items per page (1-1000, default 50)
1 <= value <= 100050Start of the report date range (ISO 8601)
End of the report date range (ISO 8601)
Global filter: LLM models the report was run with (repeat the param, or send one comma-separated value)
Group rows by source domain, or list individual cited URLs (default: domain)
Value in
- "domain"
- "url"
Multi-select filter on LLM model (repeat the param, or send one comma-separated value)
Filter by exact prompt texts (use repeated params, not comma-separated)
Partial match on the source/domain column
Sort direction (default: desc)
Value in
- "asc"
- "desc"
Restrict to one topic
View the sources as they look for this competitor instead of the tracked brand
Multi-select filter on source category codes (repeat the param, or send one comma-separated value)
Filter by source ownership relative to the brand and its topic competitors (comma-separated)
Keep only results from prompts carrying at least one of these tag UUIDs (OR semantics, comma-separated)
Field to sort by (default: needAttentionScore). Ties are ordered by source
Value in
- "source"
- "volume"
- "mentionRate"
- "needAttentionScore"
Compute filterOptions with the page (default: true). When false, filterOptions is null; read them from /sources/visibility/filter-options
trueResponse Body
application/json
curl -X GET "https://example.com/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}