Reference

Crawlers API

The crawlers Agentscan can verify, and how each one is checked. No key needed.

List verifiable crawlers

GET/v1/crawlers
No key needed

Response fields

  • crawlers[].slugstring

    Identifier to pass as bot when verifying.

  • crawlers[].tokensstring[]

    User-agent tokens the crawler sends.

  • crawlers[].methodstring

    How the crawler is verified, such as ip-list+reverse-dns.

  • crawlers[].verifiableboolean

    True when the operator publishes something to check against.

  • crawlers[].reverseDnsstring[]

    Hostname suffixes a genuine request resolves to.

  • crawlers[].prefixFilesstring[]

    Published IP range files used for the check.

  • countinteger

    Number of crawlers listed.

curl https://ipscanner.io/v1/crawlers
Response
{
  "count": 36,
  "crawlers": [
    {
      "slug": "googlebot",
      "name": "Googlebot",
      "tokens": [
        "googlebot"
      ],
      "method": "ip-list+reverse-dns",
      "verifiable": true,
      "reverseDns": [
        "googlebot.com",
        "google.com"
      ],
      "prefixFiles": [
        "https://developers.google.com/static/search/apis/ipranges/googlebot.json"
      ],
      "docs": "https://developers.google.com/search/docs/crawling-indexing/verifying-googlebot"
    },
    {
      "slug": "gptbot",
      "name": "GPTBot",
      "tokens": [
        "gptbot"
      ],
      "method": "ip-list",
      "verifiable": true,
      "prefixFiles": [
        "https://openai.com/gptbot.json"
      ],
      "docs": "https://platform.openai.com/docs/bots"
    }
  ],
  "note": "Crawlers this service can verify by evidence the operator publishes."
}