BotLedger – AI bot verification API
Check whether a request claiming to be an AI crawler (GPTBot, ClaudeBot, PerplexityBot, Googlebot, Applebot and others) really comes from the operator's…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Check whether a request claiming to be an AI crawler (GPTBot, ClaudeBot, PerplexityBot, Googlebot, Applebot and others) really comes from the operator's officially published IP ranges, and verify Web Bot Auth (HTTP Message Signatures) from signed AI agents. Data refreshed daily from each operator's official lists. Docs: https://botledger.website/api-docs
Endpoints 3
- GETVerify an AI crawler by IP + user agent
/v1/verify?ip=20.171.207.10&ua=Mozilla/5.0; compatible; GPTBot/1.4; +https://openai.com/gptbotReturns which bot the user agent claims to be and whether the IP is inside that operator's published ranges. - POSTVerify a Web Bot Auth signature
/v1/verify-signatureVerifies the Signature / Signature-Input / Signature-Agent headers of a request from a signed AI agent (draft-ietf-webbotauth-httpsig-protocol, Ed25519). Keys… - GETCurrent month's usage for your key
/v1/usage
API details
- Base URL
https://botledger.website/api/aibots- Authentication
- An API key in the X-API-Key header
- Operations
- 3 operations on 3 pathsGET 2POST 1
- Response formats
application/json- Description format
- OpenAPI 3.0.3, API version
1.0.0 - Links
- OpenAPI document · Terms of service · Support
- Listed from
- Kaderagha's published OpenAPI description
How to test the BotLedger – AI bot verification API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the BotLedger – AI bot verification API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Verify an AI crawler by IP + user agent” (GET /v1/verify?ip=20.171.207.10&ua=Mozilla/5.0; compatible; GPTBot/1.4; +https://openai.com/gptbot), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the BotLedger – AI bot verification API?
Check whether a request claiming to be an AI crawler (GPTBot, ClaudeBot, PerplexityBot, Googlebot, Applebot and others) really comes from the operator's… It is listed under Identity & security and has 3 endpoints.
Who publishes the BotLedger – AI bot verification API?
It is listed from Kaderagha's public API description (an OpenAPI document), not published by Kaderagha on Swastik Codes. Anyone who controls aibots.kaderagha.com can claim the profile by adding a DNS TXT record.
What is the base URL of the BotLedger – AI bot verification API?
Requests go to https://botledger.website/api/aibots. Endpoint paths are added to this base URL.
How do I authenticate with the BotLedger – AI bot verification API?
With an API key in the X-API-Key header.
How many endpoints does the BotLedger – AI bot verification API have?
3 operations on 3 paths (2 GET, 1 POST).
Is forking the BotLedger – AI bot verification API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.