rattlesnakesbymail

Look up a documented crawler on Rattlesnakes By Mail by name, slug, or user-agent string, and return identity fields, current claims, publication dates, and evidence URLs. Use lookup_crawler when the crawler is already named, or when the user agent is already known to belong to a documented crawler.

{
  "type": "object",
  "properties": {
    "name_or_ua": {
      "type": "string",
      "description": "A crawler name, slug, or full user-agent string."
    }
  },
  "required": [
    "name_or_ua"
  ]
}

Match an unrecognized raw User-Agent header against the crawlers documented on Rattlesnakes By Mail, and return the matched crawler plus instructions for verifying the request. Use identify_user_agent when the crawler behind the User-Agent header is not yet known.

{
  "type": "object",
  "properties": {
    "user_agent": {
      "type": "string",
      "description": "A raw User-Agent header string."
    }
  },
  "required": [
    "user_agent"
  ]
}

List recorded changes to claims on Rattlesnakes By Mail, newest first, with the change date and the affected crawler. Filter by date with since, by crawler with entity, or by both. Use list_changes to detect crawler policy updates published after a given date.

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "description": "An ISO date; only changes on or after this date are returned."
    },
    "entity": {
      "type": "string",
      "description": "An entity slug to filter changes to one crawler."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum rows to return, up to 200.",
      "maximum": 200
    }
  }
}

Match a free-text question against the claims published on Rattlesnakes By Mail, and return the matching claims, or no match when no published claim covers the question. Every question sent to ask is recorded, and a recorded question may be published on the public questions page at Rattlesnakes By Mail. Do not send private or identifying text to ask.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "A free-text question about crawlers, agents, or claims."
    }
  },
  "required": [
    "question"
  ]
}

Submit a correction or note about a claim, an entity, or a question on Rattlesnakes By Mail. Requires a client token issued out of band by the publisher. Every note is stored as pending, and an editor reviews every pending note before publication.

{
  "type": "object",
  "properties": {
    "target_type": {
      "type": "string",
      "enum": [
        "claim",
        "entity",
        "question"
      ],
      "description": "The kind of record the note is about."
    },
    "target_id": {
      "type": "string",
      "description": "The id or slug of the claim or entity, or the id or hash of the question, the note is about."
    },
    "body": {
      "type": "string",
      "description": "The note text, up to 2000 characters.",
      "maxLength": 2000
    },
    "token": {
      "type": "string",
      "description": "A client token issued by Rattlesnakes By Mail."
    }
  },
  "required": [
    "target_type",
    "target_id",
    "body",
    "token"
  ]
}