Skip to main content
GET
/
projects
/
{projectId}
/
content-gaps
/
list
List content gaps
curl --request GET \
  --url https://devtune.ai/api/v2/projects/{projectId}/content-gaps/list \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "contentGaps": [
      {
        "candidateKey": "<string>",
        "signalStrength": 123,
        "confidenceScore": 123,
        "freshnessScore": 123,
        "actionabilityScore": 123,
        "targetType": "<string>",
        "targetLabel": "<string>",
        "title": "<string>",
        "summary": "<string>",
        "signals": {
          "promptCount": 123,
          "primaryCitations": 123,
          "competitorCitations": 123,
          "thirdPartyCitations": 123,
          "primaryShare": 123,
          "dominanceRatio": 123,
          "averagePrimaryPosition": 123,
          "windowDays": 123
        },
        "evidence": {
          "examplePrompts": [
            {}
          ],
          "topCompetitors": [
            {}
          ],
          "topThirdPartySource": {},
          "sourceRefs": [
            {}
          ],
          "factCount": 123
        },
        "windowStart": "2023-12-25",
        "windowEnd": "2023-12-25"
      }
    ],
    "gaps": [
      {}
    ],
    "coverage": {
      "availableDays": 1,
      "dateFrom": "2023-12-25",
      "dateTo": "2023-12-25",
      "factMinDate": "2023-12-25",
      "factMaxDate": "2023-12-25",
      "isPartial": true
    },
    "emptyState": {
      "reason": "<string>",
      "message": "<string>"
    },
    "pagination": {
      "pageSize": 50,
      "cursor": "<string>",
      "nextCursor": "<string>",
      "hasMore": true
    },
    "window": {
      "days": 123,
      "dateFrom": "2023-12-25",
      "dateTo": "2023-12-25"
    }
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

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.

Authorizations

Authorization
string
header
required

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.

Path Parameters

projectId
string<uuid>
required

Query Parameters

windowDays
enum<integer>
default:30

Fixed rolling window in days. Supported values are 30 and 90. Defaults to 30.

Available options:
30,
90
cursor
string

Opaque cursor from the previous response.

pageSize
integer
default:25
Required range: 1 <= x <= 100

Response

Content gaps

data
object
meta
object