{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper: Image URLs, Thumbnails, Sources", "description": "Search Google Images by keyword, country and language. Get the image URL, thumbnail, title, source page, domain and position of every result, with Google's own filters (size, type, color, format, license, date). Many searches per run.", "version": "0.1", "x-build-id": "ohhRNoTTP2ud8swm5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quarra~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quarra-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/quarra~google-images-scraper/runs": { "post": { "operationId": "runs-sync-quarra-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/quarra~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-quarra-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": "What to search for in Google Images, as a user would type it. One search per line, up to 5,000. A Google Images link is read as its search term. Operators such as site: and filetype: work; a search with one of them is charged as 5 searches. Available on paid Apify plans only. The prefilled example also runs on the free plan, from stored results.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Images per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many images to collect for each search term. Google serves about 100 per search page and at most 200 per term; to go further, repeat the term with different filters.", "default": 100 }, "maxItems": { "title": "Maximum images in total", "minimum": 1, "type": "integer", "description": "Stops the run once this many images are delivered, across all searches. Leave empty for no limit." }, "countryCode": { "title": "Country", "type": "string", "description": "Two-letter country code (US, GB, FR, DE, CA, AU, IN...) or the country name. Results are those a user in that country sees.", "default": "US" }, "languageCode": { "title": "Language", "type": "string", "description": "Language code (en, fr, de, es, pt-BR, zh-CN, ja...) or the language name.", "default": "en" }, "imageSize": { "title": "Size", "enum": [ "any", "large", "medium", "icon" ], "type": "string", "description": "Google's size filter. Cannot be combined with Minimum resolution.", "default": "any" }, "minResolution": { "title": "Minimum resolution", "enum": [ "any", "400x300", "640x480", "800x600", "1024x768", "2mp", "4mp", "6mp", "8mp", "10mp", "12mp", "15mp", "20mp", "40mp", "70mp" ], "type": "string", "description": "Only images at least this large (Google's \"larger than\" filter).", "default": "any" }, "imageType": { "title": "Type", "enum": [ "any", "photo", "clipart", "lineDrawing", "animated", "face" ], "type": "string", "description": "Google's type filter.", "default": "any" }, "color": { "title": "Color", "enum": [ "any", "fullColor", "blackAndWhite", "transparent", "red", "orange", "yellow", "green", "teal", "blue", "purple", "pink", "white", "gray", "black", "brown" ], "type": "string", "description": "Google's color filter: a color mode or one color.", "default": "any" }, "fileType": { "title": "File format", "enum": [ "any", "jpg", "png", "gif", "webp", "svg", "bmp", "avif", "ico", "raw" ], "type": "string", "description": "Only images in this format.", "default": "any" }, "aspectRatio": { "title": "Shape", "enum": [ "any", "tall", "square", "wide", "panoramic" ], "type": "string", "description": "Google's shape filter.", "default": "any" }, "usageRights": { "title": "Usage rights", "enum": [ "any", "creativeCommons", "commercial" ], "type": "string", "description": "Google's license filter. Check each image's license on its page before reuse.", "default": "any" }, "uploadedWithin": { "title": "Time", "enum": [ "any", "day", "week", "month", "year" ], "type": "string", "description": "Only images Google dates within this period.", "default": "any" }, "safeSearch": { "title": "SafeSearch", "type": "boolean", "description": "Turn Google SafeSearch on 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 } } } } } } } } } }