API Reference
Get raw visibility results (prompts and responses) for a topic
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
Domain ID
topicId*string
Topic ID
Query Parameters
startDate?string
Start date for the report range (ISO 8601). On aggregated endpoints, omit to default to the last 6 months (there is no "all time"); an explicit start is honoured at any length.
endDate?string
End date for the report range (ISO 8601). Defaults to now when omitted.
models?array<array<any>>
Filter by specific models
promptId?string
Filter raw results to a single prompt ID. Used by the sentiment heatmap drawer to lazy-load one cell's LLM response instead of bundling all responses in the aggregate.
includeVariation?boolean
Include variation calculation comparing to previous period
Default
truepage?number
Page number for paginated responses
Range
1 <= valueDefault
1limit?number
Items per page for paginated responses
Range
1 <= value <= 100Default
50marketLanguageCodePairId?string
Filter by specific market/language pair ID
tagIds?array<array<any>>
Filter by tag IDs (visibility_result joined with prompt_tag)
Response Body
application/json
curl -X GET "https://example.com/api/domains/507f1f77bcf86cd799439011/topics/507f1f77bcf86cd799439012/visibility/raw-results"{ "results": [ { "id": "507f1f77bcf86cd799439011-0", "prompt": "What are the best payment processing solutions?", "response": "Based on my research, several payment processing solutions stand out...", "model": "chatgpt", "brandMentioned": true, "citations": [ { "url": "https://techcrunch.com/2025/01/10/payment-apis-compared", "title": "Payment APIs Compared: Stripe vs Square vs PayPal", "text": "Stripe continues to lead in developer experience...", "website": "techcrunch.com", "brandMentioned": true, "brandMentionContext": "...Stripe continues to lead in developer experience..." }, { "url": "https://g2.com/products/stripe/reviews", "title": "Stripe Reviews 2025", "text": "Rated 4.5/5 by over 3,000 developers...", "website": "g2.com", "brandMentioned": true, "brandMentionContext": "...Stripe Reviews 2025..." } ], "topOfMind": [ "Stripe", "PayPal", "Square" ], "responseDomains": [ { "domain": "techcrunch.com", "categories": [ "Internet and Telecom > Technology News" ] }, { "domain": "g2.com", "categories": [ "Computers and Electronics > Software Reviews" ] } ], "reportDate": "2025-03-15T10:30:00.000Z", "reportId": "507f1f77bcf86cd799439011" } ], "pagination": { "page": 1, "limit": 50, "total": 24, "totalPages": 1 }}