{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper: Full Size Image URLs, Sizes, Sources", "description": "Scrape Google Images for any search terms: full size image URL, width and height, thumbnail, source page, site name and domain, plus price when the image is a shop listing. Pick country and language and filter by size, type, colour, time or usage rights. No login, no browser.", "version": "0.1", "x-build-id": "8G7P8nNTqbHOHM1cv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~google-images-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-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/themineworks~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search terms", "type": "array", "description": "One search term per line, typed as you would in Google Images (red sneakers, modern kitchen interior, golden retriever puppy). Each term is searched on its own and gets its own rows. Up to 500 per run.", "default": [ "red sneakers", "modern kitchen interior" ], "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Images per search term", "minimum": 20, "maximum": 1000, "type": "integer", "description": "Most images to deliver for each term, 20 to 1,000. Google serves about 100 images a page and usually about 300 to 400 for a common term in all, so a large number returns everything Google has. You pay only for images delivered.", "default": 100 }, "country": { "title": "Country", "pattern": "^[a-zA-Z]{2}$", "type": "string", "description": "Two letter country code Google ranks the results for (Google's gl setting): us, gb, ca, au, in, de, fr, es, it, br, jp and so on.", "default": "us" }, "language": { "title": "Language", "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z]{2,4})?$", "type": "string", "description": "Google interface language, a code such as en, de, fr, es, pt-BR, ja or zh-CN (Google's hl setting). It sets the language of the page Google answers with; titles stay as the source pages wrote them.", "default": "en" }, "imageSize": { "title": "Size", "enum": [ "any", "large", "medium", "icon" ], "type": "string", "description": "Google's size filter.", "default": "any" }, "imageType": { "title": "Type", "enum": [ "any", "photo", "clipart", "lineart", "animated", "face" ], "type": "string", "description": "Google's type filter.", "default": "any" }, "imageColor": { "title": "Colour", "enum": [ "any", "color", "blackAndWhite", "transparent", "red", "orange", "yellow", "green", "teal", "blue", "purple", "pink", "white", "gray", "black", "brown" ], "type": "string", "description": "Google's colour filter.", "default": "any" }, "timeRange": { "title": "Time", "enum": [ "any", "day", "week", "month", "year" ], "type": "string", "description": "Google's time filter: images Google found in that period.", "default": "any" }, "usageRights": { "title": "Usage rights", "enum": [ "any", "creativeCommons", "commercial" ], "type": "string", "description": "Google's usage rights filter. Google reads licence details from the page; always check the licence on the source page before you reuse an image.", "default": "any" }, "safeSearch": { "title": "SafeSearch", "type": "boolean", "description": "Turn on Google SafeSearch to filter explicit images.", "default": false } } }, "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 } } } } } } } } } }