> ## Documentation Index > Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get content gap evidence > Returns the tracked prompts and cited pages behind one content gap from List content gaps. Pass its gapType and targetKey with the same windowDays. Evidence is published with the gap, so it covers the same fixed window and asOfDate. A source gap matches its URL, a brand gap the pages cited on its domain, and a topic gap every page cited in answers recorded under that topic. Each item groups one prompt, recorded topic, cited URL, recorded domain and sourceType. The same prompt and URL can appear in several items when those recorded attributes differ; pagination counts those groups, ordered by the prompt's citations of the gap, then by the page's citations. Counts are the gap's own citations split by the tracked prompt that produced them, so attribution.attributedCitations falls short of gap.citationCount only by citations no tracked prompt produced. Prompt text and topic names are current values; promptStatus says whether the prompt is still tracked. Coverage is unavailable with reason window_not_measured before the window is rolled up, and evidence_not_published when the window was published without evidence, because it includes days measured before evidence was recorded, holds more evidence than one publish includes, or had its gaps last recalculated from current topic and competitor settings rather than from the recorded citations; neither is a measured zero. Pass coverage.snapshotId on later pages: if the window is republished meanwhile, the request returns 409 with reason snapshot_changed rather than mixing two windows. A gap that is not in the published window returns 404. ## OpenAPI ````yaml /openapi.json get /projects/{projectId}/content-gaps/evidence openapi: 3.1.0 info: title: DevTune API version: 2.0.0 description: >- API for programmatic access to your AI visibility data, webhook subscriptions, and automation workflows. Use this API to integrate DevTune data into CI/CD pipelines, BI tools, AI agents, and operational systems. servers: - url: https://devtune.ai/api/v2 description: Production security: - bearerAuth: [] paths: /projects/{projectId}/content-gaps/evidence: get: summary: Get content gap evidence description: >- Returns the tracked prompts and cited pages behind one content gap from List content gaps. Pass its gapType and targetKey with the same windowDays. Evidence is published with the gap, so it covers the same fixed window and asOfDate. A source gap matches its URL, a brand gap the pages cited on its domain, and a topic gap every page cited in answers recorded under that topic. Each item groups one prompt, recorded topic, cited URL, recorded domain and sourceType. The same prompt and URL can appear in several items when those recorded attributes differ; pagination counts those groups, ordered by the prompt's citations of the gap, then by the page's citations. Counts are the gap's own citations split by the tracked prompt that produced them, so attribution.attributedCitations falls short of gap.citationCount only by citations no tracked prompt produced. Prompt text and topic names are current values; promptStatus says whether the prompt is still tracked. Coverage is unavailable with reason window_not_measured before the window is rolled up, and evidence_not_published when the window was published without evidence, because it includes days measured before evidence was recorded, holds more evidence than one publish includes, or had its gaps last recalculated from current topic and competitor settings rather than from the recorded citations; neither is a measured zero. Pass coverage.snapshotId on later pages: if the window is republished meanwhile, the request returns 409 with reason snapshot_changed rather than mixing two windows. A gap that is not in the published window returns 404. operationId: getContentGapEvidence parameters: - name: projectId in: path required: true schema: type: string format: uuid - name: gapType in: query required: true schema: type: string enum: - topic - source - brand description: gapType of the listed content gap. - name: targetKey in: query required: true schema: type: string minLength: 1 maxLength: 8192 pattern: ^[^\u0000]+$ description: >- targetKey of the listed content gap, exactly as listed: a topic id, a cited URL or a domain. - name: windowDays in: query schema: type: integer enum: - 30 - 90 default: 30 description: >- Fixed rolling window in days. Supported values are 30 and 90. Defaults to 30. - name: offset in: query schema: type: integer minimum: 0 maximum: 2147483647 default: 0 - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 25 - name: snapshotId in: query schema: type: string format: uuid description: >- coverage.snapshotId from the first page. The request returns 409 if the window was republished since. responses: '200': description: Content gap evidence content: application/json: schema: type: object properties: data: type: object properties: gap: type: - object - 'null' description: >- The gap as published in this window. Null when coverage is unavailable. properties: gapType: type: string enum: - topic - source - brand targetKey: type: string targetLabel: type: string windowDays: type: integer enum: - 30 - 90 asOfDate: type: string format: date citationCount: type: integer minimum: 0 primaryCitations: type: integer minimum: 0 competitorCitations: type: integer minimum: 0 averagePosition: type: - number - 'null' share: type: - number - 'null' minimum: 0 maximum: 1 required: - gapType - targetKey - targetLabel - windowDays - asOfDate - citationCount - primaryCitations - competitorCitations - averagePosition - share evidence: type: array maxItems: 100 items: type: object properties: promptId: type: string format: uuid promptText: type: - string - 'null' description: >- Current prompt text. Null when the prompt no longer exists. promptStatus: type: string enum: - active - paused - deleted - removed description: >- Whether the prompt is tracked now. Its citations in the window count whatever its status. promptCitationCount: type: integer minimum: 1 description: >- Citations this prompt contributed to the gap across every page. topicId: type: - string - 'null' format: uuid description: >- Topic the citations were recorded under, the topic the gap counts them under. topicName: type: - string - 'null' description: Current topic name. url: type: string domain: type: - string - 'null' sourceType: type: string enum: - primary - competitor - other title: type: - string - 'null' platforms: type: array items: type: string citationCount: type: integer minimum: 1 averagePosition: type: - number - 'null' required: - promptId - promptText - promptStatus - promptCitationCount - topicId - topicName - url - domain - sourceType - title - platforms - citationCount - averagePosition attribution: type: - object - 'null' description: >- Totals across every evidence item for the gap, not just this page. Null when coverage is unavailable. properties: attributedCitations: type: integer minimum: 0 promptCount: type: integer minimum: 0 pageCount: type: integer minimum: 0 required: - attributedCitations - promptCount - pageCount coverage: type: object description: >- Whether the window has been rolled up, and how much of it the rollup actually covers. An unavailable window has no measurement yet, which is not the same as a measured zero. A partial window has a finalized watermark but fewer covered days than requested, so its totals describe only the days in availableDays. asOfDate is the rollup watermark the window ends on, and it is reported here as well as on each item so a measured but empty page still identifies its snapshot. properties: status: type: string enum: - available - unavailable windowDays: type: integer enum: - 30 - 90 availableDays: type: integer minimum: 0 isPartial: type: boolean asOfDate: type: - string - 'null' format: date description: >- Rollup watermark the window ends on. Null when coverage is unavailable. reason: type: - string - 'null' enum: - window_not_measured - evidence_not_published - null description: Why coverage is unavailable. Null when available. snapshotId: type: - string - 'null' format: uuid description: >- Identifies this publish of the window. Pass it on later pages. required: - status - windowDays - availableDays - isPartial - asOfDate - reason - snapshotId pagination: type: object properties: offset: type: integer minimum: 0 limit: type: integer minimum: 1 maximum: 100 totalCount: type: - integer - 'null' minimum: 0 description: >- Evidence groups for the gap, each identified by promptId, recorded topicId, URL, domain and sourceType. Null when coverage is unavailable. required: - offset - limit - totalCount window: type: object properties: days: type: integer dateFrom: type: string format: date dateTo: type: string format: date required: - days - dateFrom - dateTo required: - gap - evidence - attribution - coverage - pagination - window meta: $ref: '#/components/schemas/Meta' required: - data - meta '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '404': $ref: '#/components/responses/NotFoundError' '409': $ref: '#/components/responses/ConflictError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid Error: type: object properties: error: type: string message: type: string reason: type: string description: >- Why the request was refused, for an error with more than one cause, such as a refused content-draft start. details: type: object additionalProperties: true description: >- Machine-readable facts about the refusal, such as shortfall_credits when an Agent Picks start is refused for insufficient_credits. status: type: integer required: - error - message - status responses: BadRequestError: description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' ForbiddenError: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' NotFoundError: description: Not found content: application/json: schema: $ref: '#/components/schemas/Error' ConflictError: description: Request conflicts with current resource state content: application/json: schema: $ref: '#/components/schemas/Error' RateLimitExceededError: description: Rate limit exceeded headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' headers: X-RateLimit-Limit: description: Maximum requests per window schema: type: integer X-RateLimit-Remaining: description: Requests remaining in current window schema: type: integer X-RateLimit-Reset: description: Unix timestamp when the window resets schema: type: integer securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.