{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Images Scraper: past the 300-image limit",
    "description": "Scrape Google Images without a browser or SerpApi, past Google's 300-image limit per search: full-size URL, size, title, source page, a stable image ID. Filters for size, type, color and period. New-image watch.",
    "version": "0.1",
    "x-build-id": "fux90muBvGGbo3WFY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~google-images-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-google-images-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/alexmorain~google-images-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-google-images-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/alexmorain~google-images-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-google-images-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "queries": {
            "title": "Search terms",
            "type": "array",
            "description": "One image search per line, as you would type it in Google Images: <code>espresso machine</code>, <code>golden retriever puppy</code>. Each line is one search.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "us",
              "gb",
              "ca",
              "au",
              "de",
              "fr",
              "es",
              "it",
              "nl",
              "in",
              "br",
              "mx",
              "jp"
            ],
            "type": "string",
            "description": "Which Google to ask: it sets the domain (google.com, google.de...) and the country of the sites Google favors. Without this, Google would answer for the country of the proxy's IP address.",
            "default": "us"
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Interface language of Google, a two-letter code such as <code>en</code>, <code>de</code>, <code>fr</code>. Empty uses the main language of the country."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Optional. A place more precise than the country, written as Google names it, from the smallest to the largest: <code>Austin,Texas,United States</code>, <code>Lyon,Auvergne-Rhone-Alpes,France</code>. Maximum 63 characters. Leave empty to use the country."
          },
          "startUrls": {
            "title": "Google Images URLs",
            "type": "array",
            "description": "Optional. Google Images search URLs, such as <code>https://www.google.com/search?q=espresso+machine&amp;udm=2</code> (or <code>tbm=isch</code>). The search text, <code>hl</code>, <code>gl</code> and the size, type, color and period filters (<code>tbs</code>) are read from the URL. A filter set in this form wins over the one in the URL. The license filter is not supported: Google ignores it without a browser.",
            "items": {
              "type": "string"
            }
          },
          "maxItemsPerQuery": {
            "title": "Max images per search",
            "minimum": 1,
            "type": "integer",
            "description": "Images returned for each search. One Google page gives 50 to 100 images and the pages of one search stop at about 330. Complete coverage goes further, up to the number of Google requests allowed below.",
            "default": 100
          },
          "maxItems": {
            "title": "Max images",
            "minimum": 1,
            "type": "integer",
            "description": "Total images returned by the run, across all searches.",
            "default": 1000
          },
          "completeCoverage": {
            "title": "Complete coverage",
            "type": "boolean",
            "description": "On: when the pages of your search do not give enough images, read the related searches Google suggests (and theirs) until nothing new comes back, up to <b>Max requests per search</b>. Off: only the pages of your own search (about 330 images at most). Images found through a related search are marked in <code>variant</code> and are about the same subject, not always the exact words of your search.",
            "default": true
          },
          "maxRequestsPerQuery": {
            "title": "Max requests per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Budget of Google requests for each search (each returns up to 100 images). The Actor stops earlier when 5 requests in a row find fewer than 50 new images.",
            "default": 40
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Google requests in flight at once, 1 to 16.",
            "default": 10
          },
          "imageSize": {
            "title": "Size",
            "enum": [
              "any",
              "large",
              "medium",
              "icon"
            ],
            "type": "string",
            "description": "Google's size filter: <b>Large</b> (the usual 800 pixels and more), <b>Medium</b> or <b>Icon</b> (small, up to about 300 pixels). Applied by Google; for an exact minimum use the two fields below.",
            "default": "any"
          },
          "imageType": {
            "title": "Type",
            "enum": [
              "any",
              "clipart",
              "lineart",
              "animated"
            ],
            "type": "string",
            "description": "Google's type filter: <b>Clip art</b>, <b>Line drawing</b> or <b>Animated</b> (GIF). The photo and face filters are not offered: Google does not apply them without a browser.",
            "default": "any"
          },
          "color": {
            "title": "Color",
            "enum": [
              "any",
              "gray",
              "transparent",
              "red",
              "orange",
              "yellow",
              "green",
              "teal",
              "blue",
              "purple",
              "pink",
              "white",
              "black",
              "brown"
            ],
            "type": "string",
            "description": "Google's color filter: black and white (<code>gray</code>), <code>transparent</code> background, or one dominant color.",
            "default": "any"
          },
          "timePeriod": {
            "title": "Time period",
            "enum": [
              "any",
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string",
            "description": "Only images Google dated within the last day, week, month or year.",
            "default": "any"
          },
          "minWidth": {
            "title": "Minimum width (px)",
            "minimum": 1,
            "type": "integer",
            "description": "Keep images at least this wide. Checked on the size Google reports for each image: a smaller one is dropped, not charged."
          },
          "minHeight": {
            "title": "Minimum height (px)",
            "minimum": 1,
            "type": "integer",
            "description": "Keep images at least this tall. Checked like the minimum width."
          },
          "monitorMode": {
            "title": "Watch",
            "enum": [
              "off",
              "newOnly"
            ],
            "type": "string",
            "description": "Remembers the images returned by earlier runs. <b>New images only</b> returns only images not delivered before, and charges only those. The first run returns everything that matches. Schedule it daily for a feed that never repeats. The set Google shows changes from one pass to the next: the watch is a feed of images not seen yet, not a complete state.",
            "default": "off"
          },
          "monitorName": {
            "title": "Monitor name (Watch)",
            "type": "string",
            "description": "Without a name, the memory belongs to each search as typed. With a name, every run using that name shares it. The memory lives in your key-value store <code>google-images-monitor</code>."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "If set, the Actor POSTs a small JSON summary to this URL at the end of the run, <b>only when at least one image was returned</b>: <code>actor</code>, <code>runId</code>, <code>datasetId</code>, <code>images</code>, <code>monitorMode</code> and one line per search. Use the final URL: a redirect is not followed, except a 307 or 308. An unreachable webhook is logged and never fails the run. Stored encrypted."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}