{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper: Image Search Results & URLs", "description": "Google Images results in bulk for any keyword, country and language: each image's original URL, width and height, thumbnail, title, source page and site, file size and dominant color, in Google's order. Filter by size, color, type, time and usage rights. Use the API or paste a Google Images link.", "version": "0.1", "x-build-id": "Gma0ygxC2MGhnch4Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kaleidoscopelabs~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kaleidoscopelabs-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/kaleidoscopelabs~google-images-scraper/runs": { "post": { "operationId": "runs-sync-kaleidoscopelabs-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/kaleidoscopelabs~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-kaleidoscopelabs-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": "Searches", "maxItems": 1000, "type": "array", "description": "One search a line, as you would type it in Google Images, or a Google Images search link (its country, language, filters and SafeSearch are kept for that line). A line that is neither is skipped and said in the log; a line that repeats an earlier one is read once.", "default": [ "wooden coffee table" ], "items": { "type": "string" } }, "maxResults": { "title": "Results per search", "minimum": 1, "maximum": 400, "type": "integer", "description": "How many images to store for each search, in Google's order: up to 400. Google Images shows a few hundred for most searches; you get as many as it shows, up to this number.", "default": 100 }, "country": { "title": "Country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "The country to search from, by its two-letter code such as US, GB or DE: Google Images' results differ by country. A search link's own country is kept for its line.", "default": "US" }, "language": { "title": "Language", "pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$", "type": "string", "description": "The language of Google's interface, by its code such as en, de or pt-BR: it changes the titles Google shows and some of the results.", "default": "en" }, "size": { "title": "Size", "enum": [ "any", "large", "medium", "icon" ], "type": "string", "description": "Only images of this size, as Google Images' Tools menu offers.", "default": "any" }, "color": { "title": "Color", "enum": [ "any", "color", "grayscale", "transparent" ], "type": "string", "description": "Only images in color, in black and white, or with a transparent background.", "default": "any" }, "type": { "title": "Type", "enum": [ "any", "photo", "clipart", "lineart", "animated" ], "type": "string", "description": "Only photos, clip art, line drawings or animated images.", "default": "any" }, "time": { "title": "Time", "enum": [ "any", "day", "week", "month", "year" ], "type": "string", "description": "Only images Google found within this time.", "default": "any" }, "usageRights": { "title": "Usage rights", "enum": [ "any", "creativeCommons", "commercial" ], "type": "string", "description": "Only images Google lists under Creative Commons licenses, or under commercial and other licenses. Check each image's license on its page before you use it.", "default": "any" }, "safeSearch": { "title": "SafeSearch", "type": "boolean", "description": "Filter explicit results, as Google's SafeSearch does. A search link's own setting is kept for its line.", "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 } } } } } } } } } }