> ## Documentation Index > Fetch the complete documentation index at: https://chatobserver.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Explore cited sources > Reads the current workspace only, subject to current product access. MCP requires the matching sources or competitors read permission. ## OpenAPI ````yaml GET /api/v2/sources/explorer openapi: 3.1.1 info: title: chatobserver public API version: '2026-09-09' description: >- Track AI visibility, manage prompts, inspect collected answers and citations, and integrate workspace data with your own tools. Visibility endpoints use workspace API keys. Data endpoints use scoped service-account keys; spreadsheet client endpoints use authorised client sessions. See the authentication guide for each credential type. contact: name: chatobserver support url: https://chatobserver.com/contact email: support@chatobserver.com servers: - url: https://app.chatobserver.com description: Production API security: - WorkspaceKey: [] - BearerKey: [] tags: - name: Workspace description: Validate access and list the workspace project and available platforms. - name: Prompts description: Create, schedule, organise, activate and retrieve tracked prompts. - name: Answers description: Retrieve collected AI answers, their analysis and visibility trends. - name: Brands description: Manage brands and compare their visibility in AI answers. - name: Sources and citations description: Analyse cited domains, pages and ownership across answers. - name: Visitor analytics description: Read website visitor and crawler analytics for the workspace. - name: Content opportunities description: Retrieve content-gap findings and recommendations for tracked prompts. - name: Usage description: Read workspace consumption and allowance summaries. - name: Data connections description: Discover authorised connections, source accounts and connector catalogues. - name: Data queries description: >- Create versioned queries, publish definitions and inspect integration contracts. - name: Data operations description: >- Execute, validate, cancel and inspect operations and page through result rows. - name: Data delivery description: Manage schedules, transfers, destinations and import workflows. - name: Data definitions description: Manage reusable definitions and their immutable versions. - name: Data webhooks description: >- Configure event delivery, inspect deliveries, replay events and rotate secrets. - name: Client authorisation description: Authorise spreadsheet clients using a user-approved challenge exchange. - name: Spreadsheet clients description: >- Access document-bound client sessions, queries, schedules, bindings and write claims. - name: AI visibility audits description: Create website visibility audits and retrieve their report links. - name: Version 1 description: Integrate with the version 1 visibility and analytics endpoints. paths: /api/v2/sources/explorer: get: tags: - Sources summary: Explore cited sources description: >- Reads the current workspace only, subject to current product access. MCP requires the matching sources or competitors read permission. operationId: getV2SourcesExplorer parameters: - name: view in: query required: true schema: type: string enum: - overview - domains - domain-detail - prompt-runs - prompt-run-count - name: windowDays in: query required: false schema: type: integer minimum: 1 maximum: 365 - name: start in: query required: false schema: type: string format: date-time - name: end in: query required: false schema: type: string format: date-time - name: promptId in: query required: false schema: type: integer exclusiveMinimum: 0 - name: groupId in: query required: false schema: type: integer exclusiveMinimum: 0 - name: rootDomain in: query required: false schema: type: string maxLength: 255 - name: platform in: query required: false schema: type: string maxLength: 64 - name: region in: query required: false schema: type: string maxLength: 64 - name: metric in: query required: false schema: enum: - mentions - influence type: string - name: domain in: query required: false schema: type: string maxLength: 255 - name: domainSearch in: query required: false schema: type: string maxLength: 255 - name: domainLimit in: query required: false schema: type: integer minimum: 1 maximum: 200 - name: page in: query required: false schema: type: integer minimum: 1 maximum: 1000000 - name: ownership in: query required: false schema: type: string enum: - all - owned - competitor - third_party - name: limit in: query required: false schema: type: integer minimum: 10 maximum: 100 - name: cursor in: query required: false schema: type: string maxLength: 4096 - name: sortKey in: query required: false schema: type: string enum: - default - promptCount - change - rootDomain - promptSummary - mentionCount - influenceScore - citationCount - linkCount - firstSeenAt - lastSeenAt - promptRunId - promptLabel - runCompletedAt - name: sortDirection in: query required: false schema: type: string enum: - asc - desc - name: pagesPage in: query required: false schema: type: integer minimum: 1 maximum: 100000 - name: evidencePage in: query required: false schema: type: integer minimum: 1 maximum: 100000 - name: pagesSort in: query required: false schema: type: string enum: - default - url - citations - links - answers - prompts - lastSeen - name: evidenceSort in: query required: false schema: type: string enum: - default - prompt - date - citations - links - name: pagesDirection in: query required: false schema: type: string enum: - asc - desc - name: evidenceDirection in: query required: false schema: type: string enum: - asc - desc responses: '200': description: Successful operation. content: application/json: schema: oneOf: - type: object properties: view: type: string const: overview data: type: object properties: window: type: object properties: start: type: string end: type: string days: type: number required: - start - end - days additionalProperties: false filters: type: object properties: promptId: type: - number - 'null' rootDomain: type: - string - 'null' platform: type: - string - 'null' region: type: - string - 'null' groupId: type: - number - 'null' windowDays: type: number required: - promptId - rootDomain - platform - region - groupId - windowDays additionalProperties: false metadata: type: object properties: platformOptions: type: array items: type: object properties: value: type: string label: type: string count: type: number required: - value - label - count additionalProperties: false regionOptions: type: array items: type: object properties: value: type: string label: type: string count: type: number required: - value - label - count additionalProperties: false groupOptions: type: array items: type: object properties: id: type: number name: type: string promptCount: type: number required: - id - name - promptCount additionalProperties: false ownedDomains: type: array items: type: string competitorDomains: type: array items: type: string required: - platformOptions - regionOptions - groupOptions - ownedDomains - competitorDomains additionalProperties: false stats: type: object properties: mentionCount: type: number influenceScore: type: number citationCount: type: number linkCount: type: number uniqueDomains: type: number activePrompts: type: number latestActivityAt: type: - string - 'null' required: - mentionCount - influenceScore - citationCount - linkCount - uniqueDomains - activePrompts - latestActivityAt additionalProperties: false domainAggregates: type: array items: type: object properties: rootDomain: type: string mentionCount: type: number influenceScore: type: number required: - rootDomain - mentionCount - influenceScore additionalProperties: false domainOptions: type: array items: type: object properties: rootDomain: type: string mentionCount: type: number required: - rootDomain - mentionCount additionalProperties: false dailyTotals: type: array items: type: object properties: bucketDay: type: string mentionCount: type: number influenceScore: type: number required: - bucketDay - mentionCount - influenceScore additionalProperties: false dailyMentions: type: array items: type: object properties: bucketDay: type: - string - 'null' rootDomain: type: - string - 'null' promptId: type: - number - 'null' promptLabel: type: - string - 'null' mentionCount: type: number influenceScore: type: number required: - bucketDay - rootDomain - promptId - promptLabel - mentionCount - influenceScore additionalProperties: false comparison: type: object properties: days: type: number hasComparison: type: boolean window: type: object properties: mentionCount: type: number domainCount: type: number promptCount: type: number ownedMentionCount: type: number competitorMentionCount: type: number required: - mentionCount - domainCount - promptCount - ownedMentionCount - competitorMentionCount additionalProperties: false prior: type: object properties: mentionCount: type: number domainCount: type: number promptCount: type: number ownedMentionCount: type: number competitorMentionCount: type: number required: - mentionCount - domainCount - promptCount - ownedMentionCount - competitorMentionCount additionalProperties: false recent: type: object properties: mentionCount: type: number domainCount: type: number promptCount: type: number ownedMentionCount: type: number competitorMentionCount: type: number required: - mentionCount - domainCount - promptCount - ownedMentionCount - competitorMentionCount additionalProperties: false required: - days - hasComparison - window - prior - recent additionalProperties: false insights: type: array items: anyOf: - type: object properties: id: type: string const: top-domain rootDomain: type: string mentionCount: type: number share: type: - number - 'null' required: - id - rootDomain - mentionCount - share additionalProperties: false - type: object properties: id: type: string const: rising-domain rootDomain: type: string delta: type: number latest: type: number previous: type: number momentumPercent: type: - number - 'null' required: - id - rootDomain - delta - latest - previous - momentumPercent additionalProperties: false - type: object properties: id: type: string const: top-prompt promptId: type: - number - 'null' promptLabel: type: - string - 'null' mentionCount: type: number share: type: - number - 'null' required: - id - promptId - promptLabel - mentionCount - share additionalProperties: false - type: object properties: id: type: string const: latest-activity activityAt: type: string required: - id - activityAt additionalProperties: false generatedAt: type: string required: - window - filters - metadata - stats - domainAggregates - domainOptions - dailyTotals - dailyMentions - comparison - insights - generatedAt additionalProperties: false required: - view - data additionalProperties: false - type: object properties: view: type: string const: domains data: type: object properties: pageInfo: type: object properties: page: type: number pageSize: type: number total: type: number counts: type: object properties: all: type: number owned: type: number competitor: type: number third_party: type: number required: - all - owned - competitor - third_party additionalProperties: false required: - page - pageSize - total - counts additionalProperties: false domainTotals: type: array items: type: object properties: rootDomain: type: - string - 'null' mentionCount: type: number influenceScore: type: number citationCount: type: number linkCount: type: number category: type: string enum: - owned - competitor - editorial - community - review - marketplace ownership: type: string enum: - owned - competitor - third_party classificationSource: type: string enum: - manual - brand - system isTracked: type: boolean targetUrl: type: - string - 'null' notes: type: - string - 'null' firstSeenAt: type: - string - 'null' lastSeenAt: type: - string - 'null' dailyMentions: type: array items: type: object properties: day: type: string mentionCount: type: number required: - day - mentionCount additionalProperties: false prompts: type: array items: type: object properties: id: type: - number - 'null' label: type: - string - 'null' required: - id - label additionalProperties: false required: - rootDomain - mentionCount - influenceScore - citationCount - linkCount - category - ownership - classificationSource - isTracked - targetUrl - notes - firstSeenAt - lastSeenAt - prompts additionalProperties: false generatedAt: type: string required: - domainTotals - generatedAt additionalProperties: false required: - view - data additionalProperties: false - type: object properties: view: type: string const: domain-detail data: type: object properties: pagination: type: object properties: pageSize: type: number pagesTotal: type: number evidenceTotal: type: number required: - pageSize - pagesTotal - evidenceTotal additionalProperties: false domain: type: string window: type: object properties: start: type: string end: type: string days: type: number required: - start - end - days additionalProperties: false profile: type: object properties: domain: type: string category: type: string enum: - owned - competitor - editorial - community - review - marketplace ownership: type: string enum: - owned - competitor - third_party classificationSource: type: string enum: - manual - brand - system isTracked: type: boolean targetUrl: type: - string - 'null' notes: type: - string - 'null' updatedAt: type: - string - 'null' required: - domain - category - ownership - classificationSource - isTracked - targetUrl - notes - updatedAt additionalProperties: false matchedCompetitor: anyOf: - type: object properties: id: type: number label: type: string isOwnBrand: type: boolean required: - id - label - isOwnBrand additionalProperties: false - type: 'null' summary: type: object properties: mentionCount: type: number influenceScore: type: number citationCount: type: number linkCount: type: number promptCount: type: number answerCount: type: number firstSeenAt: type: - string - 'null' lastSeenAt: type: - string - 'null' required: - mentionCount - influenceScore - citationCount - linkCount - promptCount - answerCount - firstSeenAt - lastSeenAt additionalProperties: false daily: type: array items: type: object properties: bucketDay: type: string mentionCount: type: number citationCount: type: number linkCount: type: number required: - bucketDay - mentionCount - citationCount - linkCount additionalProperties: false pages: type: array items: type: object properties: pageKey: type: string url: type: string rawUrl: type: string title: type: - string - 'null' citationCount: type: number linkCount: type: number answerCount: type: number promptCount: type: number firstSeenAt: type: - string - 'null' lastSeenAt: type: - string - 'null' required: - pageKey - url - rawUrl - title - citationCount - linkCount - answerCount - promptCount - firstSeenAt - lastSeenAt additionalProperties: false evidence: type: array items: type: object properties: promptRunId: type: number promptId: type: number promptLabel: type: string mentionCount: type: number citationCount: type: number linkCount: type: number occurredAt: type: - string - 'null' required: - promptRunId - promptId - promptLabel - mentionCount - citationCount - linkCount - occurredAt additionalProperties: false groups: type: array items: type: object properties: id: type: number name: type: string answerCount: type: number promptCount: type: number required: - id - name - answerCount - promptCount additionalProperties: false generatedAt: type: string required: - domain - window - profile - matchedCompetitor - summary - daily - pages - evidence - groups - generatedAt additionalProperties: false required: - view - data additionalProperties: false - type: object properties: view: type: string const: prompt-runs data: type: object properties: rows: type: array items: type: object properties: promptRunId: type: - number - 'null' promptId: type: - number - 'null' promptLabel: type: - string - 'null' rootDomain: type: - string - 'null' mentionCount: type: number influenceScore: type: number firstSeenAt: type: - string - 'null' lastSeenAt: type: - string - 'null' runCompletedAt: type: - string - 'null' required: - promptRunId - promptId - promptLabel - rootDomain - mentionCount - influenceScore - firstSeenAt - lastSeenAt - runCompletedAt additionalProperties: false pageInfo: type: object properties: limit: type: number nextCursor: type: - string - 'null' hasMore: type: boolean required: - limit - nextCursor - hasMore additionalProperties: false generatedAt: type: string required: - rows - pageInfo - generatedAt additionalProperties: false required: - view - data additionalProperties: false - type: object properties: view: type: string const: prompt-run-count data: type: object properties: totalItems: type: number generatedAt: type: string required: - totalItems - generatedAt additionalProperties: false required: - view - data additionalProperties: false '400': description: Invalid input. '403': description: Scope, role or feature access denied. '404': description: Record not found in this workspace. '409': description: Conflict with an existing alias or retry receipt. components: securitySchemes: WorkspaceKey: type: apiKey in: header name: x-chatobserver-key description: >- A workspace API key. Data endpoints require a service-account key with the specified scopes. BearerKey: type: http scheme: bearer description: The workspace or service-account API key as a bearer token. ````