Skip to content

Commit 753c554

Browse files
author
Cameron Whiteside
committed
AI Crawl Control: add docs for Terms URL
Pay Per Crawl: update terms URL information for crawler operators Pay Per Crawl: update code example and changelog dates Pay Per Crawl: update code example and changelog dates
1 parent 1258630 commit 753c554

File tree

3 files changed

+40
-8
lines changed

3 files changed

+40
-8
lines changed
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: Custom terms URL for Pay Per Crawl
3+
description: Site owners can now provide a custom terms URL that will be included in HTTP responses to crawlers.
4+
date: 2025-12-05
5+
---
6+
7+
:::note[Pay per crawl closed beta]
8+
Pay per crawl is currently in closed beta.
9+
10+
To find out how to join the beta program, reach out to us at [Pay per crawl signup](http://www.cloudflare.com/paypercrawl-signup/), or contact your account executive if you are an existing Enterprise customer.
11+
12+
To learn more about pay per crawl, refer to Cloudflare blog: [Introducing pay per crawl: enabling content owners to charge AI crawlers for access](https://blog.cloudflare.com/introducing-pay-per-crawl/).
13+
:::
14+
15+
Site owners using [Pay Per Crawl](/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/) can now optionally configure a **Terms URL** in **AI Crawl Control** > **Settings**. The URL is included in the `Link` header of HTTP 200 and 402 responses served to crawlers, allowing you to provide custom terms and conditions for crawler access to your paid content.
16+
17+
Learn more about [setting a pay per crawl Terms URL](/ai-crawl-control/features/pay-per-crawl/use-pay-per-crawl-as-site-owner/set-a-pay-per-crawl-price/).

src/content/docs/ai-crawl-control/features/pay-per-crawl/use-pay-per-crawl-as-ai-owner/crawl-pages.mdx

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ When an AI crawler makes a request to a page protected by pay per crawl, the ser
2323

2424
```txt
2525
HTTP/2 402
26-
date: Fri, 06 Jun 2025 08:42:38 GMT
2726
crawler-price: USD 0.01
2827
```
2928

@@ -56,7 +55,6 @@ The value of the `crawler-charged` header indicates the exact amount that will b
5655

5756
```txt
5857
HTTP/2 200
59-
date: Fri, 06 Jun 2025 08:42:38 GMT
6058
crawler-charged: USD 0.01
6159
```
6260

@@ -66,11 +64,16 @@ If the request is unsuccessful due to an incorrect price header, you will receiv
6664

6765
```txt
6866
HTTP/2 402
69-
date: Fri, 06 Jun 2025 08:42:38 GMT
7067
content-type: text/plain; charset=utf-8
7168
crawler-price: USD 0.01
7269
```
7370

71+
### 2.4. Check for custom terms
72+
73+
Before using paid content, check if the response includes a `Link` header. If present, the site owner has provided custom terms and conditions that supersede the default Pay Per Crawl agreement. Review these terms before proceeding with payment.
74+
75+
This header may be present in both HTTP 200 and 402 responses.
76+
7477
## 3. Track your spending
7578

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

src/content/docs/ai-crawl-control/features/pay-per-crawl/use-pay-per-crawl-as-site-owner/set-a-pay-per-crawl-price.mdx

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,22 +21,34 @@ click D "/ai-crawl-control/features/pay-per-crawl/use-pay-per-crawl-as-site-owne
2121
click E "/ai-crawl-control/features/pay-per-crawl/use-pay-per-crawl-as-site-owner/manage-payouts/"
2222
```
2323

24-
Once your domain's visibility is set to **Visible** in Account Settings, you can set a pay per crawl price and enable pay per crawl for that domain.
24+
Once your domain's visibility is set to **Visible** in Account Settings, you can set a pay per crawl price, configure a Terms URL, and enable pay per crawl for that domain.
2525

2626
{/* prettier-ignore */}
2727
<Steps>
2828
1. Go to **AI Crawl Control**.
2929

30-
<DashButton url="/?to=/:account/:zone/ai" />
30+
<DashButton url="/?to=/:account/:zone/ai" />
3131

3232
2. Go to the **Settings** tab.
3333
3. In the **Pay Per Crawl** card, select **Enable**.
3434
4. Set your per crawl price - this is the amount charged for each successful content retrieval (HTTP 200 response) by an AI crawler.
35-
5. Select **Save**.
36-
</Steps>
35+
5. (Optional) Set a **Terms URL** - a valid URL to custom terms and conditions that will be included in the `Link` header of HTTP 200 and 402 responses to crawlers.
36+
6. Select **Save**.
37+
</Steps>
3738

38-
After enabling and setting a price, the domain's status in Account Settings will change to **Enabled**.
39+
## Crawl price
40+
41+
The crawl price is the amount charged for each successful content retrieval (HTTP 200 response) by an AI crawler that is set to **Charge**.
3942

4043
:::note[Pricing considerations]
4144
The minimum price is $0.01 USD per crawl. Consider your content value and expected crawler volume when setting your price.
4245
:::
46+
47+
After setting a crawl price the first time, the domain's status in Account Settings will update to **Enabled**.
48+
49+
## Terms URL (optional)
50+
51+
You can optionally provide a **Terms URL** that points to custom terms and conditions for crawlers paying to access to your content. When configured:
52+
53+
- The URL is included in the `Link` header of HTTP 200 and 402 responses served to crawlers by Pay Per Crawl.
54+
- Crawler operators are responsible for reviewing your custom terms before using your content.

0 commit comments

Comments
 (0)