Recrawl Competitor Site

POST

competitors

{id}

site

recrawl

curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/site/recrawl \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
    "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "site_key": "globex.com",
    "recrawl_started": true
  }
}

{
  "success": false,
  "error": {
    "code": "TOO_SOON",
    "message": "This website was read less than a day ago. You can read it again after Oct 10, 06:00 UTC."
  }
}

Read a competitor’s website again now instead of waiting for the monthly refresh, for example right after you changed its website_url. The read runs in the background: Get Competitor Site shows it when it is done, and the customers it finds appear after the competitor’s next run. It needs an API key created by a workspace admin (403 ADMIN_REQUIRED otherwise), and runs at most once a day per site: within 24 hours of the last read the answer is 429 TOO_SOON.

curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/site/recrawl \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
    "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "site_key": "globex.com",
    "recrawl_started": true
  }
}

{
  "success": false,
  "error": {
    "code": "TOO_SOON",
    "message": "This website was read less than a day ago. You can read it again after Oct 10, 06:00 UTC."
  }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Path Parameters

string

required

The competitor's Clustr ID (cmp_…), from List Competitors. The id from earlier responses also works.

Response

The read started

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/site/recrawl \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
    "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "site_key": "globex.com",
    "recrawl_started": true
  }
}

{
  "success": false,
  "error": {
    "code": "TOO_SOON",
    "message": "This website was read less than a day ago. You can read it again after Oct 10, 06:00 UTC."
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

Recrawl Competitor Site

Authorizations

Path Parameters

Response