{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper - Source Pages & Prices", "description": "[$0.90 / 1K images] Scrape Google Images with the source page and its title, the domain, file size, dominant colour and exact dimensions - plus price, rating and brand on shopping results. Full filter set. No start fee.", "version": "0.1", "x-build-id": "NigNNROeoxk9QNxYh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-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/webdata_labs~google-images-scraper/runs": { "post": { "operationId": "runs-sync-webdata_labs-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/webdata_labs~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-webdata_labs-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 search term per line. Each term is a separate search and returns up to 100 images.", "items": { "type": "string" } }, "searchUrls": { "title": "Google Images URLs", "type": "array", "description": "Paste Google Images search URLs straight from your browser. A pasted URL keeps its own filters, so use this when you have already narrowed a search on Google and want exactly that result set.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Images per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Google serves at most 100 images per search and has no page two, so 100 is the ceiling. Use filters below to reach different images for the same term.", "default": 100 }, "imageSize": { "title": "Image size", "enum": [ "any", "large", "medium", "icon", "400x300", "640x480", "800x600", "1024x768", "2mp", "4mp", "8mp", "15mp", "40mp", "exact" ], "type": "string", "description": "Google's own size buckets. \"Larger than\" options return only images at least that big.", "default": "any" }, "exactWidth": { "title": "Exact width (px)", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Only used when image size is set to \"Exactly\". Both width and height must be set. Google honours this for roughly four rows in five and fills the rest with near matches." }, "exactHeight": { "title": "Exact height (px)", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Only used when image size is set to \"Exactly\". Both width and height must be set." }, "imageColor": { "title": "Colour", "enum": [ "any", "color", "grayscale", "transparent", "red", "orange", "yellow", "green", "teal", "blue", "purple", "pink", "white", "gray", "black", "brown" ], "type": "string", "description": "Full colour, black and white, transparent background, or images dominated by one colour.", "default": "any" }, "imageType": { "title": "Type", "enum": [ "any", "photo", "clipart", "lineart", "animated", "face" ], "type": "string", "description": "Photographs, clip art, line drawings, GIFs, or images containing faces.", "default": "any" }, "aspectRatio": { "title": "Aspect ratio", "enum": [ "any", "tall", "square", "wide", "panoramic" ], "type": "string", "description": "Applied to the results, not sent to Google: Google accepts its own aspect filter on image search and then ignores it, so this Actor filters the rows itself using each image's exact dimensions. Narrow shapes therefore return fewer than 100 rows, and you are only charged for the rows you get.", "default": "any" }, "fileType": { "title": "File type", "enum": [ "any", "jpg", "png", "gif", "svg", "webp", "bmp", "ico" ], "type": "string", "description": "Restrict results to one image format.", "default": "any" }, "usageRights": { "title": "Usage rights", "enum": [ "any", "creative-commons", "commercial-and-other" ], "type": "string", "description": "Google's own licence filter. It reports what the source site claims and is not legal advice - always check the licence on the source page before reusing an image.", "default": "any" }, "timePeriod": { "title": "Published", "enum": [ "any", "past-24-hours", "past-week", "past-month", "past-year" ], "type": "string", "description": "Restrict results to images Google first saw within this window.", "default": "any" }, "site": { "title": "Only this domain", "type": "string", "description": "Restrict results to one site, e.g. wikipedia.org. Leave empty to search the whole web." }, "safeSearch": { "title": "SafeSearch", "enum": [ "off", "active" ], "type": "string", "description": "Google's explicit-content filter.", "default": "off" }, "language": { "title": "Interface language", "enum": [ "en", "de", "fr", "es", "it", "pt", "nl", "pl", "sv", "tr", "ja", "ko", "zh-CN", "hi", "ar", "id", "vi", "th" ], "type": "string", "description": "Google's hl parameter. Affects result titles and ranking.", "default": "en" }, "country": { "title": "Country", "enum": [ "us", "gb", "de", "fr", "es", "it", "nl", "pl", "se", "ca", "au", "in", "br", "mx", "jp", "kr", "id", "tr", "ae", "za" ], "type": "string", "description": "Google's gl parameter. Results and product prices follow the country you pick.", "default": "us" } } }, "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 } } } } } } } } } }