POST · no key · Free
Verify an AI crawler
Is this request really an AI bot? Send the User-Agent and IP from your logs. We match the bot and check the IP against the ranges its vendor publishes: verified, unverified (the example uses a documentation address, so it fails), or unknown when the vendor publishes no list. Nothing is stored.
- Endpoint
POST https://dataforaeo.dev/api/v1/ai-crawlers/verify- Authentication
- None. No key needed.
- Cost
- Free. How cost is counted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_agent | string | Yes | The full User-Agent header, up to 1,000 characters. |
ip | string | No | IPv4 or IPv6. Without it, verification is "unknown". |
Try it
Errors
| HTTP | code | Meaning |
|---|---|---|
| 400 | invalid_request | The body is not JSON with a user_agent string. |
| 400 | invalid_ip | ip is not an IPv4 or IPv6 address. |
| 429 | rate_limited | 30 calls a minute per IP without a key. Wait for retry-after. |
Every error code and the response envelope
Notes
- CORS is open on this endpoint, so a browser page can call it.
- The request body is capped at 4,000 bytes; the User-Agent is cut to its first 1,000 characters.
verificationisnullwhen the User-Agent is not a known AI bot.