> ## 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. # List content gaps > Returns measured rollup facts for topic, source, and brand content gaps over a fixed 30 or 90 day window. Your own sources and brand are excluded, as are topics you hold at least half the citations on: those are your presence rather than a gap. Excluded targets are absent from the list and from totalCount. Every count is a citation: content-gap rollups are built only from cited results, so this endpoint reports no mention counts. This is a breaking contract change: pipeline-derived impactScore, confidenceScore, freshnessScore, actionabilityScore, signalStrength, signals, evidence, candidateKey, summary, prompt counts, and third-party citation counts were removed because the rollups cannot reproduce them without inventing evidence. An unavailable coverage state means the content-gap window has not been rolled up yet, not that measurement found zero gaps; an available window still reports availableDays and isPartial so a partly covered window is not read as a complete one. ## OpenAPI ````yaml /openapi.json get /projects/{projectId}/content-gaps/list 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/list: get: summary: List content gaps description: >- Returns measured rollup facts for topic, source, and brand content gaps over a fixed 30 or 90 day window. Your own sources and brand are excluded, as are topics you hold at least half the citations on: those are your presence rather than a gap. Excluded targets are absent from the list and from totalCount. Every count is a citation: content-gap rollups are built only from cited results, so this endpoint reports no mention counts. This is a breaking contract change: pipeline-derived impactScore, confidenceScore, freshnessScore, actionabilityScore, signalStrength, signals, evidence, candidateKey, summary, prompt counts, and third-party citation counts were removed because the rollups cannot reproduce them without inventing evidence. An unavailable coverage state means the content-gap window has not been rolled up yet, not that measurement found zero gaps; an available window still reports availableDays and isPartial so a partly covered window is not read as a complete one. operationId: listContentGaps parameters: - name: projectId in: path required: true schema: type: string format: uuid - 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: gapType in: query schema: type: string enum: - topic - source - brand description: Filter by rollup key type. - name: search in: query schema: type: string minLength: 1 maxLength: 200 description: Case-insensitive search on the display label. - name: offset in: query schema: type: integer minimum: 0 default: 0 - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 25 responses: '200': description: Content gaps content: application/json: schema: type: object properties: data: type: object properties: contentGaps: type: array maxItems: 100 items: type: object 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 description: >- Citations recorded for this target in the window. Content-gap rollups are built only from citation results, so this endpoint reports no mention counts. primaryCitations: type: integer minimum: 0 competitorCitations: type: integer minimum: 0 averagePosition: type: - number - 'null' share: type: - number - 'null' minimum: 0 maximum: 1 description: >- Primary citations divided by primary plus competitor citations. Null when the denominator is zero. estimated: type: boolean const: false description: >- Always false because every field is a measured rollup fact. required: - gapType - targetKey - targetLabel - windowDays - asOfDate - citationCount - primaryCitations - competitorCitations - averagePosition - share - estimated 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. required: - status - windowDays - availableDays - isPartial - asOfDate pagination: type: object properties: offset: type: integer minimum: 0 limit: type: integer minimum: 1 maximum: 100 totalCount: type: integer minimum: 0 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: - contentGaps - coverage - pagination - window meta: $ref: '#/components/schemas/Meta' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '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 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' 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.