{
"openapi": "3.0.1",
"info": {
"title": "Google Images Scraper",
"description": "[$3.50/1K images] Scrape Google Images search results: image URL, thumbnail, title, alt text, source site, page URL, width, height, aspect ratio, orientation, format. Many search terms and 213 countries per run, Google's size, color, type, time and licence filters. No run fee.",
"version": "0.1",
"x-build-id": "R8o14qesV0Bp4oYzp"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/blueskyscraper~google-images-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-blueskyscraper-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/blueskyscraper~google-images-scraper/runs": {
"post": {
"operationId": "runs-sync-blueskyscraper-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/blueskyscraper~google-images-scraper/run-sync": {
"post": {
"operationId": "run-sync-blueskyscraper-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": "Enter one Google Images search per line, exactly as you would type it into Google Images (e.g. bali beach, modern kitchen interior, golden retriever puppy). Every search term runs in every country below. Plain words only: search operators such as site: or filetype: are not supported.",
"default": [
"bali beach"
],
"items": {
"type": "string"
}
},
"countries": {
"title": "📍 Countries",
"type": "array",
"description": "Enter one country per line, by name or two-letter code (United States, US, United Kingdom, GB, Germany, DE, Indonesia, ID…). All 213 countries Google serves are supported. Each country is a separate Google Images search with that country's local results.",
"default": [
"United States"
],
"items": {
"type": "string"
}
},
"maxImagesPerQuery": {
"title": "💯 Max images per search",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Set how many images to return for each search term in each country (1–200). Google Images shows about 100 images on the first screen; up to 200 are available per search.",
"default": 20
},
"language": {
"title": "🗣️ Language",
"type": "string",
"description": "Optional: Google interface language for every country, by name or code (English, en, German, de, Indonesian, id…). Leave empty to use each country's main language (United States → English, Germany → German, Japan → Japanese)."
},
"imageSize": {
"title": "📐 Size",
"enum": [
"any",
"large",
"medium",
"icon"
],
"type": "string",
"description": "Choose Google's image size filter (Tools → Size on Google Images).",
"default": "any"
},
"color": {
"title": "🎨 Color",
"enum": [
"any",
"black_and_white",
"transparent",
"red",
"orange",
"yellow",
"green",
"teal",
"blue",
"purple",
"pink",
"white",
"gray",
"black",
"brown"
],
"type": "string",
"description": "Choose Google's color filter (Tools → Color): black and white, transparent background, or a dominant color.",
"default": "any"
},
"imageType": {
"title": "🖼️ Type",
"enum": [
"any",
"clipart",
"line_drawing",
"gif"
],
"type": "string",
"description": "Choose Google's image type filter (Tools → Type).",
"default": "any"
},
"timeRange": {
"title": "🕒 Time",
"enum": [
"any",
"past_day",
"past_week",
"past_month",
"past_year"
],
"type": "string",
"description": "Choose Google's time filter (Tools → Time): only images Google found within this period.",
"default": "any"
},
"usageRights": {
"title": "©️ Usage rights",
"enum": [
"any",
"creative_commons"
],
"type": "string",
"description": "Choose Google's usage rights filter (Tools → Usage rights). Creative Commons limits results to images Google has marked as CC-licensed; always check the licence on the source page before reuse.",
"default": "any"
},
"safeSearch": {
"title": "🛡️ SafeSearch",
"type": "boolean",
"description": "Switch on to filter explicit images with Google SafeSearch.",
"default": false
},
"readImageDetails": {
"title": "📏 Read image size and format",
"type": "boolean",
"description": "Keep on to read the first bytes of each image file and add width, height, aspect ratio, orientation, file format and file size. Images whose host refuses the request get the aspect ratio and orientation from Google's thumbnail instead. Switch off for faster runs with links only. Same price either way.",
"default": true
}
}
},
"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
}
}
}
}
}
}
}
}
}
}