# Get AI crawler traffic

> Which AI bots read the brand's pages, how often and which pages. Needs Cloudflare or the GetIntel script. Pro and Growth plans.

Source: https://getintel.ai/docs/api/reference/operations/aicrawlers/

## GET /ai-crawlers

`GET https://app.getintel.ai/api/v1/ai-crawlers`

### Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `brand_id` | query | no | integer | The brand to read, from GET /brands. Required when the account has more than one brand. |
| `market` | query | no | string | The market to read, from GET /markets: its code (IN-hi, or just IN) or id. Default: the primary market. |
| `days` | query | no | integer | How many days back, ending today. Default 7. Ignored when from is given. |
| `from` | query | no | string, date | Start date (YYYY-MM-DD). At most 90 days before to. |
| `to` | query | no | string, date | End date (YYYY-MM-DD). Default today. |

### Responses

- **200**: OK
- **400**: Invalid parameter, or brand_id missing on a multi-brand account (brand_required). (`Error`)
- **401**: Missing, revoked or unknown API key (invalid_api_key). (`Error`)
- **403**: The plan doesn't include this data (feature_not_in_plan) or the plan isn't active (plan_inactive). (`Error`)
- **404**: The brand or the requested item doesn't exist (brand_not_found, not_found). (`Error`)
- **409**: The integration this needs isn't connected (integration_not_connected). (`Error`)
- **429**: Monthly read limit reached (quota_exceeded) or more than 60 requests a minute (rate_limited). (`Error`)
- **502**: An upstream service failed; retry later (upstream_error). (`Error`)