Content

REST endpoints for Content. Base URL https://api.competlab.com; every request needs a CL-API-Key header (see Authentication). Responses wrap in { item } or { items }; errors in { error }.

Get latest content intelligence data

GET/v1/projects/{projectId}/content

Get the latest content intelligence data for all competitors in a project. Returns URL counts, content categorization, strategic URL analysis, and competitive gap assessment. Use this to understand the content landscape across competitors.

Returns · { item }

Path parameters

Name	Type	Description
`projectId`	`string`	Project ID

Request


curl "https://api.competlab.com/v1/projects/507f1f77bcf86cd799439011/content" \
  -H "CL-API-Key: YOUR_COMPETLAB_API_KEY"

Response 200 OK

Example


{
  "item": {
    "lastUpdatedAt": "2026-03-15T10:00:00.000Z",
    "summary": {
      "sitemapsChecked": 8,
      "sitemapsSuccessful": 7,
      "customer": {
        "domain": "yoursite.com",
        "totalUrls": 350,
        "strategicUrls": 280,
        "categorizedCounts": {
          "blog": 120,
          "docs": 80,
          "tools": 5,
          "landing": 30,
          "legal": 10,
          "caseStudies": 0,
          "comparison": 3,
          "integrations": 25,
          "changelog": 15,
          "webinars": 2,
          "other": 60
        }
      },
      "topCompetitor": {
        "domain": "rival.com",
        "strategicUrls": 420
      },
      "strategicUrlGap": -140,
      "overallRank": 3,
      "comparableCompetitors": 4,
      "criticalGaps": [
        {
          "category": "caseStudies",
          "categoryLabel": "Case Studies",
          "competitorsWithContent": 3,
          "leader": {
            "domain": "competitor.com",
            "count": 42,
            "exampleUrls": [
              "https://competitor.com/blog/post-1",
              "https://competitor.com/blog/post-2"
            ]
          },
          "actionHint": "Create 3-5 case studies showcasing customer success stories"
        }
      ],
      "significantGaps": [
        {
          "category": "blog",
          "categoryLabel": "Blog Posts",
          "customerCount": 5,
          "competitorAverage": 25,
          "competitorMax": 42,
          "gapPercentage": -80,
          "leader": {
            "domain": "competitor.com",
            "count": 42,
            "exampleUrls": [
              "https://competitor.com/blog/post-1",
              "https://competitor.com/blog/post-2"
            ]
          },
          "actionHint": "Increase blog output to at least match competitor average of 25 posts"
        }
      ],
      "advantages": [
        {
          "category": "docs",
          "categoryLabel": "Documentation",
          "customerCount": 120,
          "competitorMax": 45,
          "leadAmount": 75
        }
      ],
      "onTrack": [
        {
          "category": "landing",
          "categoryLabel": "Landing Pages",
          "customerCount": 30,
          "competitorMax": 35,
          "differencePercent": -14
        }
      ],
      "totalCriticalGaps": 2,
      "totalSignificantGaps": 1,
      "totalAdvantages": 3,
      "totalOnTrack": 4
    },
    "competitors": [
      {
        "domain": "competitor.com",
        "isOwn": false,
        "totalUrls": 450,
        "strategicUrls": 380,
        "categorizedCounts": {
          "blog": 150,
          "docs": 100,
          "tools": 10,
          "landing": 40,
          "legal": 15,
          "caseStudies": 8,
          "comparison": 5,
          "integrations": 30,
          "changelog": 20,
          "webinars": 7,
          "other": 65
        },
        "sitemapCount": 2
      }
    ]
  }
}

Fields

item — object

Field	Type	Description
`lastUpdatedAt`	`string`	When this data was last updated (ISO-8601)
`summary`	`object`	Run summary with content gap analysis. See `item.summary`.
`competitors`	`array<object>`	Per-competitor content data. See `item.competitors[]`.

item.summary — object

Field	Type	Description
`sitemapsChecked`	`number`	Number of sitemaps checked in this run
`sitemapsSuccessful`	`number`	Number of sitemaps successfully processed
`customer`	`object`	Your domain’s content metrics. See `item.summary.customer`.
`topCompetitor`	`object \| null`	Competitor with the most strategic URLs, or null if no competitors checked. Nullable. See `item.summary.topCompetitor`.
`strategicUrlGap`	`number`	Your strategic URL count minus top competitor (negative = you are behind)
`overallRank`	`number \| null`	Your rank by strategic content among the sites that returned comparable content data — your own site plus `comparableCompetitors` competitors (field size = comparableCompetitors + 1). Null when fewer than two competitors had usable data, or when your own site returned no usable data to rank. Nullable.
`comparableCompetitors`	`number`	Competitors (excluding your own site) that returned usable content data — the sample size behind the gap and advantage comparisons. The overall rank is taken over this set plus your own site, so the rank’s field size is `comparableCompetitors + 1`.
`criticalGaps`	`array<object>`	Content categories where you have zero content but competitors do. See `item.summary.criticalGaps[]`.
`significantGaps`	`array<object>`	Content categories where you are significantly behind (>50%). See `item.summary.significantGaps[]`.
`advantages`	`array<object>`	Content categories where you lead all competitors. See `item.summary.advantages[]`.
`onTrack`	`array<object>`	Content categories where you are competitive (within threshold). See `item.summary.onTrack[]`.
`totalCriticalGaps`	`number`	Total number of critical content gaps
`totalSignificantGaps`	`number`	Total number of significant content gaps
`totalAdvantages`	`number`	Total number of content advantages
`totalOnTrack`	`number`	Total number of on-track categories

item.competitors[] — each entry

Field	Type	Description
`domain`	`string`	Competitor domain
`isOwn`	`boolean`	Whether this is the project’s own domain
`totalUrls`	`number`	Total URLs discovered across all sitemaps for this competitor
`strategicUrls`	`number`	Strategic URLs (excludes legal/other categories)
`categorizedCounts`	`object \| null`	URL counts by content category, or null if categorization unavailable. Nullable.
`sitemapCount`	`number`	Number of sitemaps discovered for this competitor

item.summary.customer — object

Field	Type	Description
`domain`	`string`	Your domain
`totalUrls`	`number`	Total URLs discovered across all sitemaps
`strategicUrls`	`number`	Strategic URLs (excludes legal/other categories)
`categorizedCounts`	`object`	URL counts broken down by content category

item.summary.topCompetitor — object

Field	Type	Description
`domain`	`string`	Top competitor domain by strategic URLs
`strategicUrls`	`number`	Their strategic URL count

item.summary.criticalGaps[] — each entry

Field	Type	Description
`category`	`string`	Content category where you have zero content
`categoryLabel`	`string`	Human-readable category name
`competitorsWithContent`	`number`	Number of competitors that have content in this category
`leader`	`object`	Competitor leading in this category. See `item.summary.criticalGaps[].leader`.
`actionHint`	`string`	Actionable guidance for addressing this gap

item.summary.significantGaps[] — each entry

Field	Type	Description
`category`	`string`	Content category where you are significantly behind
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorAverage`	`number`	Average competitor URL count
`competitorMax`	`number`	Maximum competitor URL count
`gapPercentage`	`number`	How far behind you are as a percentage (negative = behind)
`leader`	`object`	Competitor leading in this category. See `item.summary.significantGaps[].leader`.
`actionHint`	`string`	Actionable guidance for addressing this gap

item.summary.advantages[] — each entry

Field	Type	Description
`category`	`string`	Content category where you lead
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorMax`	`number`	Maximum competitor URL count
`leadAmount`	`number`	How many more URLs you have than the best competitor

item.summary.onTrack[] — each entry

Field	Type	Description
`category`	`string`	Content category where you are competitive
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorMax`	`number`	Maximum competitor URL count
`differencePercent`	`number`	Percentage difference from the best competitor

item.summary.criticalGaps[].leader — object

Field	Type	Description
`domain`	`string`	Leader competitor domain
`count`	`number`	Number of URLs in this category
`exampleUrls`	`array<string>`	Example URLs for inspiration (3-5)

item.summary.significantGaps[].leader — object

Field	Type	Description
`domain`	`string`	Leader competitor domain
`count`	`number`	Number of URLs in this category
`exampleUrls`	`array<string>`	Example URLs for inspiration (3-5)

Errors

Status	Code	Meaning
401	`api_key_missing` · `api_key_invalid` · `api_key_revoked` · `api_key_expired` · `insufficient_scope`	The `CL-API-Key` is missing, malformed, revoked, expired, or lacks the required scope.
404	`project_not_found`	No `project` matches the id in the path.

Every error uses the shared { error: { code, message, status } } envelope; code is one of the values listed above.


{
  "error": {
    "code": "api_key_invalid",
    "message": "Invalid API key",
    "status": 401
  }
}

Get content intelligence run history

GET/v1/projects/{projectId}/content/history

Get paginated history of content intelligence monitoring runs for a project. Each entry includes run timing and summary statistics with gap analysis.

Returns · { items, pagination }

Path parameters

Name	Type	Description
`projectId`	`string`	Project ID

Query parameters

Name	Type	Required	Description
`page`	`number`		Page number (1-indexed). Default `1`. Min `1`.
`limit`	`number`		Number of items per page. Default `20`. Range `1`–`100`.

Request


curl "https://api.competlab.com/v1/projects/507f1f77bcf86cd799439011/content/history?page=1&limit=20" \
  -H "CL-API-Key: YOUR_COMPETLAB_API_KEY"

Response 200 OK

Example


{
  "items": [
    {
      "runId": "507f1f77bcf86cd799439011",
      "completedAt": "2026-03-15T10:00:00.000Z",
      "summary": {
        "sitemapsChecked": 8,
        "sitemapsSuccessful": 7,
        "customer": {
          "domain": "yoursite.com",
          "totalUrls": 350,
          "strategicUrls": 280,
          "categorizedCounts": {
            "blog": 120,
            "docs": 80,
            "tools": 5,
            "landing": 30,
            "legal": 10,
            "caseStudies": 0,
            "comparison": 3,
            "integrations": 25,
            "changelog": 15,
            "webinars": 2,
            "other": 60
          }
        },
        "topCompetitor": {
          "domain": "rival.com",
          "strategicUrls": 420
        },
        "strategicUrlGap": -140,
        "overallRank": 3,
        "comparableCompetitors": 4,
        "criticalGaps": [
          {
            "category": "caseStudies",
            "categoryLabel": "Case Studies",
            "competitorsWithContent": 3,
            "leader": {
              "domain": "competitor.com",
              "count": 42,
              "exampleUrls": [
                "https://competitor.com/blog/post-1",
                "https://competitor.com/blog/post-2"
              ]
            },
            "actionHint": "Create 3-5 case studies showcasing customer success stories"
          }
        ],
        "significantGaps": [
          {
            "category": "blog",
            "categoryLabel": "Blog Posts",
            "customerCount": 5,
            "competitorAverage": 25,
            "competitorMax": 42,
            "gapPercentage": -80,
            "leader": {
              "domain": "competitor.com",
              "count": 42,
              "exampleUrls": [
                "https://competitor.com/blog/post-1",
                "https://competitor.com/blog/post-2"
              ]
            },
            "actionHint": "Increase blog output to at least match competitor average of 25 posts"
          }
        ],
        "advantages": [
          {
            "category": "docs",
            "categoryLabel": "Documentation",
            "customerCount": 120,
            "competitorMax": 45,
            "leadAmount": 75
          }
        ],
        "onTrack": [
          {
            "category": "landing",
            "categoryLabel": "Landing Pages",
            "customerCount": 30,
            "competitorMax": 35,
            "differencePercent": -14
          }
        ],
        "totalCriticalGaps": 2,
        "totalSignificantGaps": 1,
        "totalAdvantages": 3,
        "totalOnTrack": 4
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 47,
    "totalPages": 3,
    "hasMore": true
  }
}

Fields

items[] — each entry

Field	Type	Description
`runId`	`string`	Run ID
`completedAt`	`string`	When this run completed (ISO-8601)
`summary`	`object`	Run summary statistics. See `items[].summary`.

pagination — object

Field	Type	Description
`page`	`number`	Current page number (1-indexed)
`limit`	`number`	Number of items per page
`total`	`number`	Total number of items across all pages
`totalPages`	`number`	Total number of pages
`hasMore`	`boolean`	Whether more pages exist after the current page

items[].summary — object

Field	Type	Description
`sitemapsChecked`	`number`	Number of sitemaps checked in this run
`sitemapsSuccessful`	`number`	Number of sitemaps successfully processed
`customer`	`object`	Your domain’s content metrics. See `items[].summary.customer`.
`topCompetitor`	`object \| null`	Competitor with the most strategic URLs, or null if no competitors checked. Nullable. See `items[].summary.topCompetitor`.
`strategicUrlGap`	`number`	Your strategic URL count minus top competitor (negative = you are behind)
`overallRank`	`number \| null`	Your rank by strategic content among the sites that returned comparable content data — your own site plus `comparableCompetitors` competitors (field size = comparableCompetitors + 1). Null when fewer than two competitors had usable data, or when your own site returned no usable data to rank. Nullable.
`comparableCompetitors`	`number`	Competitors (excluding your own site) that returned usable content data — the sample size behind the gap and advantage comparisons. The overall rank is taken over this set plus your own site, so the rank’s field size is `comparableCompetitors + 1`.
`criticalGaps`	`array<object>`	Content categories where you have zero content but competitors do. See `items[].summary.criticalGaps[]`.
`significantGaps`	`array<object>`	Content categories where you are significantly behind (>50%). See `items[].summary.significantGaps[]`.
`advantages`	`array<object>`	Content categories where you lead all competitors. See `items[].summary.advantages[]`.
`onTrack`	`array<object>`	Content categories where you are competitive (within threshold). See `items[].summary.onTrack[]`.
`totalCriticalGaps`	`number`	Total number of critical content gaps
`totalSignificantGaps`	`number`	Total number of significant content gaps
`totalAdvantages`	`number`	Total number of content advantages
`totalOnTrack`	`number`	Total number of on-track categories

items[].summary.customer — object

Field	Type	Description
`domain`	`string`	Your domain
`totalUrls`	`number`	Total URLs discovered across all sitemaps
`strategicUrls`	`number`	Strategic URLs (excludes legal/other categories)
`categorizedCounts`	`object`	URL counts broken down by content category

items[].summary.topCompetitor — object

Field	Type	Description
`domain`	`string`	Top competitor domain by strategic URLs
`strategicUrls`	`number`	Their strategic URL count

items[].summary.criticalGaps[] — each entry

Field	Type	Description
`category`	`string`	Content category where you have zero content
`categoryLabel`	`string`	Human-readable category name
`competitorsWithContent`	`number`	Number of competitors that have content in this category
`leader`	`object`	Competitor leading in this category. See `items[].summary.criticalGaps[].leader`.
`actionHint`	`string`	Actionable guidance for addressing this gap

items[].summary.significantGaps[] — each entry

Field	Type	Description
`category`	`string`	Content category where you are significantly behind
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorAverage`	`number`	Average competitor URL count
`competitorMax`	`number`	Maximum competitor URL count
`gapPercentage`	`number`	How far behind you are as a percentage (negative = behind)
`leader`	`object`	Competitor leading in this category. See `items[].summary.significantGaps[].leader`.
`actionHint`	`string`	Actionable guidance for addressing this gap

items[].summary.advantages[] — each entry

Field	Type	Description
`category`	`string`	Content category where you lead
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorMax`	`number`	Maximum competitor URL count
`leadAmount`	`number`	How many more URLs you have than the best competitor

items[].summary.onTrack[] — each entry

Field	Type	Description
`category`	`string`	Content category where you are competitive
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorMax`	`number`	Maximum competitor URL count
`differencePercent`	`number`	Percentage difference from the best competitor

items[].summary.criticalGaps[].leader — object

Field	Type	Description
`domain`	`string`	Leader competitor domain
`count`	`number`	Number of URLs in this category
`exampleUrls`	`array<string>`	Example URLs for inspiration (3-5)

items[].summary.significantGaps[].leader — object

Field	Type	Description
`domain`	`string`	Leader competitor domain
`count`	`number`	Number of URLs in this category
`exampleUrls`	`array<string>`	Example URLs for inspiration (3-5)

Paginated — pass page and limit query parameters and follow pagination.hasMore to page through the full set.

Errors

Status	Code	Meaning
401	`api_key_missing` · `api_key_invalid` · `api_key_revoked` · `api_key_expired` · `insufficient_scope`	The `CL-API-Key` is missing, malformed, revoked, expired, or lacks the required scope.

Every error uses the shared { error: { code, message, status } } envelope; code is one of the values listed above.


{
  "error": {
    "code": "api_key_invalid",
    "message": "Invalid API key",
    "status": 401
  }
}

Get content intelligence data for a specific run

GET/v1/projects/{projectId}/content/history/{runId}

Get full content intelligence data for a specific historical monitoring run, including per-competitor URL counts, content categorization, and strategic URL metrics.

Returns · { item }

Path parameters

Name	Type	Description
`runId`	`string`	Run ID
`projectId`	`string`	Project ID

Request


curl "https://api.competlab.com/v1/projects/507f1f77bcf86cd799439011/content/history/507f1f77bcf86cd799439012" \
  -H "CL-API-Key: YOUR_COMPETLAB_API_KEY"

Response 200 OK

Example


{
  "item": {
    "runId": "507f1f77bcf86cd799439011",
    "completedAt": "2026-03-15T10:00:00.000Z",
    "summary": {
      "sitemapsChecked": 8,
      "sitemapsSuccessful": 7,
      "customer": {
        "domain": "yoursite.com",
        "totalUrls": 350,
        "strategicUrls": 280,
        "categorizedCounts": {
          "blog": 120,
          "docs": 80,
          "tools": 5,
          "landing": 30,
          "legal": 10,
          "caseStudies": 0,
          "comparison": 3,
          "integrations": 25,
          "changelog": 15,
          "webinars": 2,
          "other": 60
        }
      },
      "topCompetitor": {
        "domain": "rival.com",
        "strategicUrls": 420
      },
      "strategicUrlGap": -140,
      "overallRank": 3,
      "comparableCompetitors": 4,
      "criticalGaps": [
        {
          "category": "caseStudies",
          "categoryLabel": "Case Studies",
          "competitorsWithContent": 3,
          "leader": {
            "domain": "competitor.com",
            "count": 42,
            "exampleUrls": [
              "https://competitor.com/blog/post-1",
              "https://competitor.com/blog/post-2"
            ]
          },
          "actionHint": "Create 3-5 case studies showcasing customer success stories"
        }
      ],
      "significantGaps": [
        {
          "category": "blog",
          "categoryLabel": "Blog Posts",
          "customerCount": 5,
          "competitorAverage": 25,
          "competitorMax": 42,
          "gapPercentage": -80,
          "leader": {
            "domain": "competitor.com",
            "count": 42,
            "exampleUrls": [
              "https://competitor.com/blog/post-1",
              "https://competitor.com/blog/post-2"
            ]
          },
          "actionHint": "Increase blog output to at least match competitor average of 25 posts"
        }
      ],
      "advantages": [
        {
          "category": "docs",
          "categoryLabel": "Documentation",
          "customerCount": 120,
          "competitorMax": 45,
          "leadAmount": 75
        }
      ],
      "onTrack": [
        {
          "category": "landing",
          "categoryLabel": "Landing Pages",
          "customerCount": 30,
          "competitorMax": 35,
          "differencePercent": -14
        }
      ],
      "totalCriticalGaps": 2,
      "totalSignificantGaps": 1,
      "totalAdvantages": 3,
      "totalOnTrack": 4
    },
    "competitors": [
      {
        "domain": "competitor.com",
        "isOwn": false,
        "totalUrls": 450,
        "strategicUrls": 380,
        "categorizedCounts": {
          "blog": 150,
          "docs": 100,
          "tools": 10,
          "landing": 40,
          "legal": 15,
          "caseStudies": 8,
          "comparison": 5,
          "integrations": 30,
          "changelog": 20,
          "webinars": 7,
          "other": 65
        },
        "sitemapCount": 2
      }
    ]
  }
}

Fields

item — object

Field	Type	Description
`runId`	`string`	Run ID
`completedAt`	`string`	When this run completed (ISO-8601)
`summary`	`object`	Run summary statistics. See `item.summary`.
`competitors`	`array<object>`	Per-competitor content data for this run. See `item.competitors[]`.

item.summary — object

Field	Type	Description
`sitemapsChecked`	`number`	Number of sitemaps checked in this run
`sitemapsSuccessful`	`number`	Number of sitemaps successfully processed
`customer`	`object`	Your domain’s content metrics. See `item.summary.customer`.
`topCompetitor`	`object \| null`	Competitor with the most strategic URLs, or null if no competitors checked. Nullable. See `item.summary.topCompetitor`.
`strategicUrlGap`	`number`	Your strategic URL count minus top competitor (negative = you are behind)
`overallRank`	`number \| null`	Your rank by strategic content among the sites that returned comparable content data — your own site plus `comparableCompetitors` competitors (field size = comparableCompetitors + 1). Null when fewer than two competitors had usable data, or when your own site returned no usable data to rank. Nullable.
`comparableCompetitors`	`number`	Competitors (excluding your own site) that returned usable content data — the sample size behind the gap and advantage comparisons. The overall rank is taken over this set plus your own site, so the rank’s field size is `comparableCompetitors + 1`.
`criticalGaps`	`array<object>`	Content categories where you have zero content but competitors do. See `item.summary.criticalGaps[]`.
`significantGaps`	`array<object>`	Content categories where you are significantly behind (>50%). See `item.summary.significantGaps[]`.
`advantages`	`array<object>`	Content categories where you lead all competitors. See `item.summary.advantages[]`.
`onTrack`	`array<object>`	Content categories where you are competitive (within threshold). See `item.summary.onTrack[]`.
`totalCriticalGaps`	`number`	Total number of critical content gaps
`totalSignificantGaps`	`number`	Total number of significant content gaps
`totalAdvantages`	`number`	Total number of content advantages
`totalOnTrack`	`number`	Total number of on-track categories

item.competitors[] — each entry

Field	Type	Description
`domain`	`string`	Competitor domain
`isOwn`	`boolean`	Whether this is the project’s own domain
`totalUrls`	`number`	Total URLs discovered across all sitemaps for this competitor
`strategicUrls`	`number`	Strategic URLs (excludes legal/other categories)
`categorizedCounts`	`object \| null`	URL counts by content category, or null if categorization unavailable. Nullable.
`sitemapCount`	`number`	Number of sitemaps discovered for this competitor

item.summary.customer — object

Field	Type	Description
`domain`	`string`	Your domain
`totalUrls`	`number`	Total URLs discovered across all sitemaps
`strategicUrls`	`number`	Strategic URLs (excludes legal/other categories)
`categorizedCounts`	`object`	URL counts broken down by content category

item.summary.topCompetitor — object

Field	Type	Description
`domain`	`string`	Top competitor domain by strategic URLs
`strategicUrls`	`number`	Their strategic URL count

item.summary.criticalGaps[] — each entry

Field	Type	Description
`category`	`string`	Content category where you have zero content
`categoryLabel`	`string`	Human-readable category name
`competitorsWithContent`	`number`	Number of competitors that have content in this category
`leader`	`object`	Competitor leading in this category. See `item.summary.criticalGaps[].leader`.
`actionHint`	`string`	Actionable guidance for addressing this gap

item.summary.significantGaps[] — each entry

Field	Type	Description
`category`	`string`	Content category where you are significantly behind
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorAverage`	`number`	Average competitor URL count
`competitorMax`	`number`	Maximum competitor URL count
`gapPercentage`	`number`	How far behind you are as a percentage (negative = behind)
`leader`	`object`	Competitor leading in this category. See `item.summary.significantGaps[].leader`.
`actionHint`	`string`	Actionable guidance for addressing this gap

item.summary.advantages[] — each entry

Field	Type	Description
`category`	`string`	Content category where you lead
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorMax`	`number`	Maximum competitor URL count
`leadAmount`	`number`	How many more URLs you have than the best competitor

item.summary.onTrack[] — each entry

Field	Type	Description
`category`	`string`	Content category where you are competitive
`categoryLabel`	`string`	Human-readable category name
`customerCount`	`number`	Your URL count in this category
`competitorMax`	`number`	Maximum competitor URL count
`differencePercent`	`number`	Percentage difference from the best competitor

item.summary.criticalGaps[].leader — object

Field	Type	Description
`domain`	`string`	Leader competitor domain
`count`	`number`	Number of URLs in this category
`exampleUrls`	`array<string>`	Example URLs for inspiration (3-5)

item.summary.significantGaps[].leader — object

Field	Type	Description
`domain`	`string`	Leader competitor domain
`count`	`number`	Number of URLs in this category
`exampleUrls`	`array<string>`	Example URLs for inspiration (3-5)

Errors

Status	Code	Meaning
401	`api_key_missing` · `api_key_invalid` · `api_key_revoked` · `api_key_expired` · `insufficient_scope`	The `CL-API-Key` is missing, malformed, revoked, expired, or lacks the required scope.
404	`run_not_found`	No `run` matches the id in the path.

Every error uses the shared { error: { code, message, status } } envelope; code is one of the values listed above.


{
  "error": {
    "code": "api_key_invalid",
    "message": "Invalid API key",
    "status": 401
  }
}

Get content changelog

GET/v1/projects/{projectId}/content/changelog

Get paginated changelog of detected URL changes across competitor sitemaps. Each item shows numeric counts per category plus up to 3 sample URLs per category by default — safe for any token budget. Supports filtering by competitorId and category query parameters. Pass allUrlsPerCategory=true for the full URL list per category (warning: high-activity competitors can produce large responses; combine with filters to scope, and check the truncated flag in the response — when true, the byte cap fired and items/URLs were trimmed).

Returns · { items, pagination, truncated }

Path parameters

Name	Type	Description
`projectId`	`string`	Project ID

Query parameters

Name	Type	Description
`page`	`number`	Page number (1-indexed). Default `1`. Min `1`.
`limit`	`number`	Number of items per page. Default `20`. Range `1`–`100`.
`competitorId`	`string`	Filter by competitor ID
`category`	`string`	Filter by content category (blog, docs, tools, landing, legal, caseStudies, comparison, integrations, changelog, webinars, other)
`allUrlsPerCategory`	`boolean`	By default each item returns up to 3 sample URLs per category. Set true to return the full URL list per category. High-activity competitors can produce large responses — combine with `category` and `competitorId` filters to scope. Subject to an internal byte cap; check `truncated` in the response.

Request


curl "https://api.competlab.com/v1/projects/507f1f77bcf86cd799439011/content/changelog?page=1&limit=20&competitorId=507f1f77bcf86cd799439011&category=blog&allUrlsPerCategory=false" \
  -H "CL-API-Key: YOUR_COMPETLAB_API_KEY"

Response 200 OK

Example


{
  "items": [
    {
      "competitorDomain": "competitor.com",
      "sitemapUrl": "https://competitor.com/sitemap.xml",
      "checkedAt": "2026-03-15T10:00:00.000Z",
      "totalAdded": 5,
      "totalRemoved": 2,
      "addedByCategory": {
        "blog": [
          "https://competitor.com/blog/new-post"
        ],
        "docs": [
          "https://competitor.com/docs/new-guide"
        ]
      },
      "removedByCategory": {
        "landing": [
          "https://competitor.com/old-landing"
        ]
      },
      "addedCounts": {
        "blog": 1,
        "docs": 1
      },
      "removedCounts": {
        "landing": 1
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 47,
    "totalPages": 3,
    "hasMore": true
  },
  "truncated": false
}

Field	Type	Description
`competitorDomain`	`string`	Competitor domain
`sitemapUrl`	`string`	Sitemap URL where changes were detected
`checkedAt`	`string`	When this change was detected (ISO-8601)
`totalAdded`	`number`	Total number of URLs added
`totalRemoved`	`number`	Total number of URLs removed
`addedByCategory`	`object`	Added URLs grouped by content category. By default each category is capped at 3 sample URLs (numeric totals remain accurate via `addedCounts`). Pass `allUrlsPerCategory=true` to return full URL lists.
`removedByCategory`	`object`	Removed URLs grouped by content category. By default each category is capped at 3 sample URLs (numeric totals remain accurate via `removedCounts`). Pass `allUrlsPerCategory=true` to return full URL lists.
`addedCounts`	`object`	Count of added URLs per category
`removedCounts`	`object`	Count of removed URLs per category

Paginated — pass page and limit query parameters and follow pagination.hasMore to page through the full set.

Errors

Status	Code	Meaning
401	`api_key_missing` · `api_key_invalid` · `api_key_revoked` · `api_key_expired` · `insufficient_scope`	The `CL-API-Key` is missing, malformed, revoked, expired, or lacks the required scope.

Every error uses the shared { error: { code, message, status } } envelope; code is one of the values listed above.


{
  "error": {
    "code": "api_key_invalid",
    "message": "Invalid API key",
    "status": 401
  }
}