← Ai Crawl Control / ai-crawl-control / features / pay-per-crawl / use-pay-per-crawl-as-ai-owner

Crawl pages

graph LR
A[Set up your<br>Cloudflare Account] --> B[Verify your<br>AI crawler]
B --> C[Discover<br>payable content]
C --> D[Connect to<br>Stripe]
D --> E[Crawl pages]:::highlight
classDef highlight fill:#F6821F,color:white

Once your AI crawler complies with Web Bot Auth, you can begin to crawl webpages. For more information on how pay per crawl works, refer to What is Pay Per Crawl?

When an AI crawler makes a request to a page protected by pay per crawl, the server will respond with HTTP/2 402 Payment Required. This response will also include the crawler-price header which specifies the cost to access the content. For example, a response may look like the following:

HTTP/2 402
date: Fri, 06 Jun 2025 08:42:38 GMT
crawler-price: USD 0.01

To access this content, the AI crawler must provide headers for paid access.

Your AI crawler can specify the price it is willing to pay by providing one of two headers:

• crawler-exact-price: This is the exact price the AI crawler is configured to pay for access. This value should exactly match the price set in the response header crawler-price. Include this header in your second request if your AI crawler first received a HTTP status code 402, and you wish to access the content by paying the crawler-price.
• crawler-max-price: This is the maximum price the AI crawler is configured to pay for access on any content. Use this option if you wish to access any pay per crawl content with a crawl price equal or lower than the maximum price. If a page's crawler-price is higher than your crawler-max-price, your AI crawler will receive a HTTP 402 response.

Include Web Bot Auth headers by following the steps in Sign your requests.

When you specify a header to indicate payment, you may receive one of two responses:

The value of the crawler-charged header indicates the exact amount that will be billed to your Cloudflare account for the request.

HTTP 200
date: Fri, 06 Jun 2025 08:42:38 GMT
crawler-charged: USD 0.01

If the request is unsuccessful, you will receive an error response with a crawler-error header indicating the specific issue.

HTTP/2 402
date: Fri, 06 Jun 2025 08:42:38 GMT
content-type: text/plain; charset=utf-8
crawler-price: USD 0.01
crawler-error: InvalidCrawlerExactPrice

Refer to Pay Per Crawl error codes for a complete list of error codes and troubleshooting guidance.

When you successfully access pay per crawl content (response with HTTP status code 200), the response will include crawler-charged. For example:

crawler-charged: USD 0.01

Cloudflare strongly recommends tracking and saving these values to keep an accurate record of the bill your AI crawler has accrued.

You may wish to refer to the following resources.

• Discover payable content
• Pay Per Crawl error codes
• Pay Per Crawl FAQs