> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recrawl Competitor Site

> Read a competitor's website again now

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](https://docs.clustr-ai.com/api-reference/get-competitor-site.md) 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`.

```bash cURL theme={null}
curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/site/recrawl \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json 202 theme={null}
{
  "success": true,
  "data": {
    "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
    "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "site_key": "globex.com",
    "recrawl_started": true
  }
}
```

```json 429 theme={null}
{
  "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."
  }
}
```


## OpenAPI

````yaml POST /competitors/{id}/site/recrawl
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /competitors/{id}/site/recrawl:
    post:
      tags:
        - Competitor Monitoring
      summary: Recrawl Competitor Site
      description: >
        Read a competitor's website again now instead of waiting for the monthly
        refresh, for

        example after changing its `website_url`. Workspace admins only, at most
        once a day per

        site. The read runs in the background.
      operationId: recrawlCompetitorSite
      parameters:
        - name: id
          in: path
          required: true
          description: >-
            The competitor's Clustr ID (`cmp_…`), from [List
            Competitors](/api-reference/list-competitors).

            The id from earlier responses also works.
          schema:
            type: string
          example: cmp_mgtxymmcd1zd0qf3k802ennc6q
      responses:
        '202':
          description: The read started
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      clustr_competitor_id:
                        type: string
                        description: >-
                          The competitor's Clustr ID, for example
                          `cmp_tq9stvg9gbazmkj8q15hevbxv1`.
                        example: cmp_tq9stvg9gbazmkj8q15hevbxv1
                      competitor_id:
                        type: string
                        description: >-
                          Kept for integrations built before Clustr IDs. New
                          integrations should use `clustr_competitor_id`.
                      site_key:
                        type: string
                        example: globex.com
                      recrawl_started:
                        type: boolean
                        example: true
        '401':
          description: Invalid or missing API key
        '403':
          description: >-
            Not a workspace admin (`ADMIN_REQUIRED`), or competitor monitoring
            is not enabled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Competitor not found
        '422':
          description: The competitor has no website or domain (`NO_WEBSITE`)
        '429':
          description: The site was read less than a day ago (`TOO_SOON`)
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            message:
              type: string
              example: Invalid request body
            code:
              type: string
              example: BAD_REQUEST
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.