Crawler summary
Counts of AI crawler hits on your own site over a window. This is the other half of AI visibility: being cited is downstream of being fetched, and a brand that no answer engine crawls will not appear in answers however good its content is.
Two views in one response. totals groups by operator bucket (ChatGPT, Perplexity, Claude, Google, Microsoft, Other), which is what you
report on. by_crawler gives the exact bot names underneath, which is what you debug with —
GPTBot training your content is a different fact from ChatGPT-User fetching it to answer a
live question.
GET /v1/brands/{brand_id}/crawler/summaryAuthorization
| Header | Type | Required |
|---|---|---|
Authorization | Bearer asky_sk_… | required |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brand_id | uuid | required | From List brands |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date | YYYY-MM-DD | optional | Inclusive lower bound, YYYY-MM-DD in UTC. Narrows the population before metrics are computed. |
end_date | YYYY-MM-DD | optional | Inclusive upper bound, YYYY-MM-DD in UTC. Narrows the population before metrics are computed. |
scope | string | optional | Which requests count. pages (default) keeps the visits to the brand’s own pages plus robots.txt, llms.txt and sitemaps, as Crawler Logs shows them; all adds every other request, old links and scanners included. |
Request
cURL
curl --request GET \
--url 'https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/crawler/summary?start_date=2026-07-14&end_date=2026-08-13' \
--header 'Authorization: Bearer <api-key>'Response
200
{
"data": {
"totals": {
"ChatGPT": 1402,
"Perplexity": 318,
"Claude": 190,
"Google": 806,
"Microsoft": 42,
"Other": 61,
"all": 2819
},
"by_crawler": {
"GPTBot": 980,
"ChatGPT-User": 422,
"PerplexityBot": 318,
"ClaudeBot": 190,
"Google-Extended": 806
}
},
"meta": {
"period": { "start_date": "2026-07-14", "end_date": "2026-08-13" },
"scope": "pages",
"timezone": "UTC"
},
"request_id": "req_4a7d09fe23b1487cb562"
}Response fields
| Field | Type | Description |
|---|---|---|
meta.period | object | required. { start_date, end_date } actually used |
meta.timezone | string | required. Always UTC |
meta.scope | string | required. pages or all: which requests the figures count |
data.totals | object | required. One count per operator bucket, plus all |
data.by_crawler | object | required. Exact bot name to hit count, for example { "GPTBot": 412 } |
request_id | string | required. Also returned as the x-request-id header. Quote it when contacting support |
Errors
| Status | Code | When |
|---|---|---|
| 400 | invalid_request | A parameter is unknown or malformed. The message names it |
| 401 | invalid_token | The key is missing, malformed, or does not exist |
| 401 | token_expired | The key passed its expiry date |
| 401 | token_revoked | The key was revoked |
| 404 | not_found | The brand does not exist, or this key is not allowed to reach it. The two are deliberately indistinguishable |
| 429 | rate_limited | Over 300 requests per minute. See the Retry-After header |
Notes
Your pages by default. The figures count the visits to pages Asky lists for the brand, plus
robots.txt, llms.txt and sitemaps, as Crawler Logs does. Requests for anything else (old links,
scanners probing for .env files under a crawler’s name) are left out unless you pass scope=all. For a brand
with no pages listed, both scopes count every request.
Bot traffic only. Ordinary human visits are excluded before anything is counted, and they are the large majority of raw log rows. A figure here is therefore never comparable to a pageview count from your analytics tool.
Requires the crawler log integration to be connected. Without it this returns zeros rather than an
error, so check totals.all before drawing conclusions from a quiet chart.