Skip to content

Conversation

@CameronWhiteside
Copy link
Contributor

@CameronWhiteside CameronWhiteside commented Nov 19, 2025

Summary

This PR adds documentation for new Pay Per Crawl features that enable both AI crawler operators and site owners to have more control and flexibility:

For AI crawler operators:

  • Discovery API: New authenticated endpoint to programmatically discover domains participating in Pay Per Crawl, eliminating trial-and-error discovery
  • Payment header signature requirement: Enhanced security requiring payment headers to be included in Web Bot Auth signatures
  • crawler-error header: new standardized error codes for robust programmatic error handling for crawlers attempting to access paid content

For site owners:

  • Custom pricing (in-band pricing): Set dynamic, content-specific prices via origin headers or Cloudflare Workers based on URL paths, bot characteristics, or request properties
  • Configure free pages: Use Configuration Rules to selectively disable Pay Per Crawl for specific URI patterns (homepages, navigation, discovery pages, etc.)

Documentation updates:

  • New page: discover-payable-content.mdx - Complete Discovery API documentation with authentication, request/response schemas, and examples
  • New page: advanced-configuration.mdx - Consolidated guide for custom pricing and URI pattern configuration
  • New changelog: 2025-11-18-pay-per-crawl-enhancements.mdx
  • Updated existing pages to reflect new workflows
  • Added glossary entry for "in-band pricing"

The documentation emphasizes practical implementation with Worker examples, caching strategies, and clear setup steps for dashboard configuration. More to come very soon on more dash-UI native configuration flexibility

Documentation checklist

Copy link
Contributor

@Oxyjun Oxyjun left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just two quick suggestions:

  • Should we put the error codes in a separate page?
  • The free paths - we mention it's free "by default". Aren't these always free?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants