---
title: GraphQL API
description: Query AI Crawl Control analytics data using the GraphQL Analytics API.
image: https://edgetunnel-b2h.pages.dev/core-services-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://edgetunnel-b2h.pages.dev/ai-crawl-control/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

# GraphQL API

AI Crawl Control analytics are available through Cloudflare's [GraphQL Analytics API](https://edgetunnel-b2h.pages.dev/analytics/graphql-api/). You can query the same data shown in the dashboard to build custom reports, integrate with monitoring systems, or export for analysis. Test queries using the [GraphQL API Explorer ↗](https://graphql.cloudflare.com/), or capture the exact queries the dashboard uses via [Chrome DevTools](https://edgetunnel-b2h.pages.dev/analytics/graphql-api/tutorials/capture-graphql-queries-from-dashboard/).

## Key filters

| Filter                           | Description                                                                                                                     | Availability                                                                         |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| requestSource: "eyeball"         | Real client requests only. Excludes internal Cloudflare traffic.                                                                | All plans                                                                            |
| userAgent\_like: "%...%"         | Filter by [user agent](https://edgetunnel-b2h.pages.dev/ai-crawl-control/reference/bots/). Can be spoofed.                     | All plans                                                                            |
| edgeResponseStatus\_geq / \_lt   | Filter by HTTP status code range.                                                                                               | All plans                                                                            |
| clientRequestPath\_like: "%...%" | Filter by URL path pattern.                                                                                                     | All plans                                                                            |
| clientRefererHost\_like: "%...%" | Filter by [referrer domain](https://edgetunnel-b2h.pages.dev/ai-crawl-control/reference/bots/#referrer-domains-by-operator).   | Paid plans only                                                                      |
| botDetectionIds\_hasany: \[...\] | Filter by [detection IDs](https://edgetunnel-b2h.pages.dev/ai-crawl-control/reference/bots/). Reliably verified by Cloudflare. | [Bot Management](https://edgetunnel-b2h.pages.dev/bots/get-started/bot-management/) |

## Query examples

Get AI crawler requests over time using detection IDs

```graphql
{
  viewer {
    zones(filter: { zoneTag: "<ZONE_ID>" }) {
      httpRequestsAdaptiveGroups(
        filter: {
          datetime_geq: "2027-01-01T00:00:00Z"
          datetime_leq: "2027-01-02T00:00:00Z"
          requestSource: "eyeball"
          # 123815556 = GPTBot, 132995013 = ChatGPT-User, 126255384 = OAI-SearchBot
          botDetectionIds_hasany: [123815556, 132995013, 126255384]
        }
        limit: 5000
      ) {
        count
        dimensions {
          datetimeHour
          botDetectionIds
          clientRequestHTTPHost
        }
        sum {
          edgeResponseBytes
        }
      }
    }
  }
}
```

Get AI crawler requests over time using user agent

```graphql
{
  viewer {
    zones(filter: { zoneTag: "<ZONE_ID>" }) {
      httpRequestsAdaptiveGroups(
        filter: {
          datetime_geq: "2027-01-01T00:00:00Z"
          datetime_leq: "2027-01-02T00:00:00Z"
          requestSource: "eyeball"
          userAgent_like: "%GPTBot%"
        }
        limit: 5000
      ) {
        count
        dimensions {
          datetimeHour
          userAgent
          clientRequestHTTPHost
        }
        sum {
          edgeResponseBytes
        }
      }
    }
  }
}
```

Get top crawled paths

```graphql
{
  viewer {
    zones(filter: { zoneTag: "<ZONE_ID>" }) {
      httpRequestsAdaptiveGroups(
        filter: {
          datetime_geq: "2027-01-01T00:00:00Z"
          datetime_leq: "2027-01-02T00:00:00Z"
          requestSource: "eyeball"
          edgeResponseStatus_geq: 200
          edgeResponseStatus_lt: 400
          userAgent_like: "%GPTBot%"
        }
        limit: 5000
        orderBy: [count_DESC]
      ) {
        count
        dimensions {
          clientRequestPath
          clientRequestHTTPHost
        }
      }
    }
  }
}
```

Get AI referral traffic

```graphql
{
  viewer {
    zones(filter: { zoneTag: "<ZONE_ID>" }) {
      httpRequestsAdaptiveGroups(
        filter: {
          datetime_geq: "2027-01-01T00:00:00Z"
          datetime_leq: "2027-01-02T00:00:00Z"
          requestSource: "eyeball"
          OR: [
            { clientRefererHost_like: "%.chatgpt.com%" }
            { clientRefererHost: "chatgpt.com" }
            { clientRefererHost_like: "%.perplexity.ai%" }
            { clientRefererHost: "perplexity.ai" }
          ]
        }
        limit: 5000
        orderBy: [count_DESC]
      ) {
        count
        dimensions {
          datetimeHour
          clientRefererHost
        }
      }
    }
  }
}
```

Get data transfer by crawler

```graphql
{
  viewer {
    zones(filter: { zoneTag: "<ZONE_ID>" }) {
      httpRequestsAdaptiveGroups(
        filter: {
          datetime_geq: "2027-01-01T00:00:00Z"
          datetime_leq: "2027-01-02T00:00:00Z"
          requestSource: "eyeball"
          userAgent_like: "%GPTBot%"
        }
        limit: 5000
        orderBy: [sum_edgeResponseBytes_DESC]
      ) {
        count
        dimensions {
          userAgent
        }
        sum {
          edgeResponseBytes
        }
      }
    }
  }
}
```

## Related

* [Bot reference](https://edgetunnel-b2h.pages.dev/ai-crawl-control/reference/bots/) — Detection IDs and user agents
* [GraphQL Analytics API](https://edgetunnel-b2h.pages.dev/analytics/graphql-api/) — Full API documentation

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://edgetunnel-b2h.pages.dev/ai-crawl-control/reference/graphql-api/#page","headline":"GraphQL API · Cloudflare AI Crawl Control docs","description":"Query AI Crawl Control analytics data using the GraphQL Analytics API.","url":"https://edgetunnel-b2h.pages.dev/ai-crawl-control/reference/graphql-api/","inLanguage":"en","image":"https://edgetunnel-b2h.pages.dev/core-services-preview.png","dateModified":"2026-04-23","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://edgetunnel-b2h.pages.dev/#website","name":"Cloudflare Docs","url":"https://edgetunnel-b2h.pages.dev/"}}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/ai-crawl-control/","name":"AI Crawl Control"}},{"@type":"ListItem","position":3,"item":{"@id":"/ai-crawl-control/reference/","name":"Reference"}},{"@type":"ListItem","position":4,"item":{"@id":"/ai-crawl-control/reference/graphql-api/","name":"GraphQL API"}}]}
```