DataForAEOby Advance Labs
Docs menu

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.

Parameters

NameTypeRequiredDescription
user_agentstringYesThe full User-Agent header, up to 1,000 characters.
ipstringNoIPv4 or IPv6. Without it, verification is "unknown".

Try it

Try it

Calls the live API from your browser. No key needed.

Errors

HTTPcodeMeaning
400invalid_requestThe body is not JSON with a user_agent string.
400invalid_ipip is not an IPv4 or IPv6 address.
429rate_limited30 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.
  • verification is null when the User-Agent is not a known AI bot.
Request
curl -X POST https://dataforaeo.dev/api/v1/ai-crawlers/verify \
  -H 'Content-Type: application/json' \
  -d '{"user_agent":"Mozilla/5.0; ChatGPT-User/1.0","ip":"203.0.113.7"}'
Response (trimmed, illustrative values)
{ "ok": true, "cost": { "checks": 0 }, "result": {
  "ai_bot": true, "bot": "ChatGPT-User", "vendor": "openai",
  "kind": "user", "verification": "unverified" } }