GoogleImagesRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/crawlerdata-com/json-schema/crawlerdata-com-google-images-request-schema.json",
  "title": "GoogleImagesRequest",
  "description": "Google Images results. 1 credit.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/crawlerdata-com-openapi.json#/components/schemas/GoogleImagesRequest",
  "type": "object",
  "required": [
    "endpoint",
    "params"
  ],
  "properties": {
    "endpoint": {
      "type": "string",
      "enum": [
        "google-images"
      ]
    },
    "params": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        },
        "country": {
          "type": "string",
          "description": "Two-letter country code. Defaults to \"us\", or to the country of location.",
          "enum": [
            "us",
            "gb",
            "uk",
            "ca",
            "au",
            "de",
            "fr",
            "nl",
            "it",
            "es",
            "pt",
            "be",
            "at",
            "ch",
            "se",
            "no",
            "dk",
            "fi",
            "ie",
            "pl",
            "cz",
            "il",
            "ae",
            "in",
            "jp",
            "kr",
            "sg",
            "mx",
            "br",
            "nz",
            "za",
            "tr",
            "ar",
            "cl",
            "co",
            "pe",
            "hk",
            "tw",
            "th",
            "vn",
            "id",
            "my",
            "ph",
            "pk",
            "bd",
            "sa",
            "eg",
            "qa",
            "kw",
            "gr",
            "hu",
            "ro",
            "bg",
            "hr",
            "sk",
            "si",
            "ua",
            "rs",
            "lt",
            "lv",
            "ee",
            "lu",
            "ng",
            "ke",
            "ma",
            "is",
            "cy",
            "mt",
            "ba",
            "mk",
            "me",
            "md",
            "ge",
            "am",
            "az",
            "kz",
            "uz",
            "ec",
            "uy",
            "py",
            "bo",
            "cr",
            "pa",
            "do",
            "gt",
            "sv",
            "pr",
            "ve",
            "lk",
            "np",
            "kh",
            "jo",
            "lb",
            "om",
            "bh",
            "gh",
            "tz",
            "ug",
            "dz",
            "tn"
          ]
        },
        "language": {
          "type": "string",
          "pattern": "^[a-zA-Z]{2}$",
          "default": "en"
        },
        "page": {
          "type": "integer",
          "default": 1
        },
        "location": {
          "type": "string",
          "minLength": 2,
          "maxLength": 200,
          "description": "Search from a city, region or postal code: a Google canonical location name, \"City,Region,Country\" (Google Ads geotarget format), e.g. \"Austin,Texas,United States\". When country is omitted it is taken from the location."
        },
        "uule": {
          "type": "string",
          "pattern": "^[A-Za-z][+ ][A-Za-z0-9+/_=-]{4,1000}$",
          "description": "Advanced: a raw Google uule value (\"w+...\", \"a+...\", \"j+...\"), plain or URL-encoded as copied from a Google URL. Use location instead unless you already have uule values."
        }
      },
      "required": [
        "query"
      ],
      "additionalProperties": false
    },
    "queue": {
      "$ref": "#/$defs/Queue"
    },
    "postbackUrl": {
      "type": "string",
      "format": "uri",
      "description": "Webhook that receives the result (fast and regular queues)."
    },
    "custom_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Your own id for this request, returned unchanged on the job and in its webhook."
    }
  },
  "$defs": {
    "Queue": {
      "type": "string",
      "enum": [
        "live",
        "fast",
        "regular"
      ],
      "default": "fast",
      "description": "live = synchronous; fast/regular = asynchronous. Same price."
    }
  }
}