GraphQL API

Last updated Apr 23, 2026 AI Crawl Control analytics are available through Cloudflare's GraphQL Analytics 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 ↗︎, or capture the exact queries the dashboard uses via Chrome DevTools.

Key filters

Filter Description Availability
requestSource: "eyeball" Real client requests only. Excludes internal Cloudflare traffic. All plans
userAgent_like: "%...%" Filter by user agent. 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. Paid plans only
botDetectionIds_hasany: [...] Filter by detection IDs. Reliably verified by Cloudflare. Bot Management

Query examples

<details>

<summary>

Get AI crawler requests over time using detection IDs

</summary>

{
    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
                }
            }
        }
    }
}

</details>

<details>

<summary>

Get AI crawler requests over time using user agent

</summary>

{
    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
                }
            }
        }
    }
}

</details>

<details>

<summary>

Get top crawled paths

</summary>

{
    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
                }
            }
        }
    }
}

</details>

<details>

<summary>

Get AI referral traffic

</summary>

{
    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
                }
            }
        }
    }
}

</details>

<details>

<summary>

Get data transfer by crawler

</summary>

{
    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
                }
            }
        }
    }
}

</details>

Was this helpful?

YesNo

On this page

GraphQL API - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-crawl-control/reference/graphql-api/#page","headline":"GraphQL API","description":"Query AI Crawl Control analytics data using the GraphQL Analytics API.","url":"https://developers.cloudflare.com/ai-crawl-control/reference/graphql-api/","inLanguage":"en","image":"https://developers.cloudflare.com/ai-crawl-control/reference/graphql-api/og.png?v=71d819741b1e4017","dateModified":"2026-04-23","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Redirect AI training crawlers to canonical URLs. title: Redirects for AI Training image: https://developers.cloudflare.com/ai-crawl-control/reference/redirects-for-ai-training/og.png?v=707c206e0651ce02

Skip to content

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