Detection

Detect censorship for many domains (batch)

Changed on

Verify up to 50 domains in one country in a single call. Same status/basis semantics as /hydra/v1/detect, plus a summary of blocked/accessible/unknown counts. While the accessibility source is held, every domain is unmeasured and returns unknown (basis unmeasured); the static known-blocked list sets no verdict. Built for bulk verification jobs.

post/hydra/v1/detect/batch

Request

  • Base URL
    https://api.voidly.ai
  • URL
    https://api.voidly.ai/hydra/v1/detect/batch
  • Auth
    API key in header X-API-Key

Request body

countrystring required
targetsstring[] required

Example request

{
  "country": "IR",
  "targets": [
    "twitter.com",
    "whatsapp.com",
    "github.com"
  ]
}

Response

Batch detection result

countrystring
countinteger
notestring

Changes

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      endpoint added