{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper", "description": "[💰 $2.0/1K] Extract image results from Google Imagesm image URLs, thumbnails, dimensions, titles, source pages, and domains. Batch multiple queries, paste full image-search URLs, and filter by size, color, type, aspect ratio, time, and usage rights. Localized across 45+ countries and 20+ languages.", "version": "1.1", "x-build-id": "HTgUBS7hFYmwkeDAU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~google-images-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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 Queries", "type": "array", "description": "Keywords to search on Google Images (e.g., 'golden retriever puppies' or 'minimalist kitchen'). Each query runs independently and returns its own set of images. Maximum 100 queries and URLs combined per run — split larger batches across multiple runs. Leave empty if you only want to scrape pasted image-search URLs.", "items": { "type": "string" } }, "searchUrls": { "title": "Image Search URLs", "type": "array", "description": "Optional: paste full Google Images result URLs (e.g., 'https://www.google.com/search?q=sunset&udm=2&tbm=isch'). Any filters already encoded in the URL are preserved, so this is handy for power users who built a search in Google's UI. Maximum 100 queries and URLs combined per run.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Maximum Results per Query", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of images to return per query or URL. Set to 0 for all available results. Google Images caps each query at roughly 260 unique images — values above that return whatever Google has available, never more.", "default": 100 }, "imageSize": { "title": "Image Size", "enum": [ "any", "large", "medium", "icon" ], "type": "string", "description": "Filter by full-resolution size.", "default": "any" }, "imageColor": { "title": "Image Color", "enum": [ "any", "color", "blackAndWhite", "transparent", "red", "orange", "yellow", "green", "teal", "blue", "purple", "pink", "white", "gray", "black", "brown" ], "type": "string", "description": "Filter by dominant color. 'Transparent' returns images with alpha channels (usually PNG).", "default": "any" }, "imageType": { "title": "Image Type", "enum": [ "any", "photo", "clipart", "lineDrawing", "gif", "animated" ], "type": "string", "description": "Filter by image type.", "default": "any" }, "aspectRatio": { "title": "Aspect Ratio", "enum": [ "any", "tall", "square", "wide", "panoramic" ], "type": "string", "description": "Filter by image orientation / aspect ratio.", "default": "any" }, "timePeriod": { "title": "Time Period", "enum": [ "anytime", "pastHour", "pastDay", "pastWeek", "pastMonth", "pastYear" ], "type": "string", "description": "Only include images indexed within this time window.", "default": "anytime" }, "usageRights": { "title": "Usage Rights", "enum": [ "any", "creativeCommons", "commercialAndOtherLicenses" ], "type": "string", "description": "Filter by license. 'Creative Commons' includes all CC-licensed images; 'Commercial & other licenses' surfaces images marked for commercial use. Always verify the license directly at the source page before using any image commercially.", "default": "any" }, "safeSearch": { "title": "SafeSearch", "enum": [ "off", "moderate", "strict" ], "type": "string", "description": "Google's SafeSearch filter. 'Off' disables filtering entirely; 'Moderate' and 'Strict' both enable SafeSearch (Google itself no longer distinguishes the two in image search — both hide explicit results).", "default": "off" }, "language": { "title": "Language", "enum": [ "ab", "aa", "af", "ak", "sq", "am", "ar", "an", "hy", "as", "av", "ae", "ay", "az", "bm", "ba", "eu", "be", "bn", "bi", "bs", "br", "bg", "my", "ca", "ch", "ce", "ny", "zh", "zh-hk", "zh-cn", "zh-tw", "cv", "kw", "co", "cr", "hr", "cs", "da", "dv", "nl", "nl-be", "nl-nl", "dz", "en", "en-gb", "en-us", "eo", "et", "ee", "fo", "fj", "fi", "fr", "fr-ca", "fr-fr", "ff", "gl", "lg", "ka", "de", "de-at", "de-de", "de-ch", "el", "gn", "gu", "ht", "ha", "he", "hz", "hi", "ho", "hu", "is", "io", "ig", "id", "ia", "ie", "iu", "ik", "ga", "it", "it-it", "ja", "jv", "kl", "kn", "kr", "ks", "kk", "km", "ki", "rw", "kv", "kg", "ko", "kj", "ku", "ky", "lo", "la", "lv", "li", "ln", "lt", "lu", "lb", "mk", "mg", "ms", "ml", "mt", "gv", "mi", "mr", "mh", "mn", "na", "nv", "ng", "ne", "nd", "se", "no", "nb", "nn", "oc", "or", "oj", "cu", "om", "os", "pi", "ps", "fa", "pl", "pt", "pt-br", "pt-pt", "pa", "qu", "ro", "rm", "rn", "ru", "sm", "sg", "sa", "sc", "gd", "sr", "sr-cyrl", "sr-latn", "sh", "sn", "ii", "sd", "si", "sk", "sl", "so", "nr", "st", "es", "es-ar", "es-cl", "es-co", "es-mx", "es-pe", "es-es", "es-ve", "su", "sw", "ss", "sv", "tl", "ty", "tg", "ta", "tt", "te", "th", "bo", "ti", "to", "ts", "tn", "tr", "tk", "tw", "uk", "ur", "ug", "uz", "ve", "vi", "vo", "wa", "cy", "fy", "wo", "xh", "yi", "yo", "za", "zu" ], "type": "string", "description": "Language of the Google Images interface (hl parameter). Affects result titles and the interface locale.", "default": "en" }, "country": { "title": "Country", "enum": [ "af", "al", "dz", "as", "ad", "ao", "ai", "aq", "ag", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "by", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "bv", "br", "io", "bn", "bg", "bf", "bi", "cv", "kh", "cm", "ca", "bq", "ky", "cf", "td", "cl", "cn", "cx", "cc", "co", "km", "ck", "cr", "hr", "cu", "cw", "cy", "cz", "ci", "cd", "dk", "dj", "dm", "do", "ec", "eg", "sv", "gq", "er", "ee", "sz", "et", "fk", "fo", "fj", "fi", "fr", "gf", "pf", "tf", "ga", "gm", "ge", "de", "gh", "gi", "gr", "gl", "gd", "gp", "gu", "gt", "gg", "gn", "gw", "gy", "ht", "hm", "hn", "hk", "hu", "is", "in", "id", "ir", "iq", "ie", "im", "il", "it", "jm", "jp", "je", "jo", "kz", "ke", "ki", "kw", "kg", "la", "lv", "lb", "ls", "lr", "ly", "li", "lt", "lu", "mo", "mg", "mw", "my", "mv", "ml", "mt", "mh", "mq", "mr", "mu", "yt", "mx", "fm", "md", "mc", "mn", "me", "ms", "ma", "mz", "mm", "na", "nr", "np", "nl", "nc", "nz", "ni", "ne", "ng", "nu", "nf", "kp", "mk", "mp", "no", "om", "pk", "pw", "ps", "pa", "pg", "py", "pe", "ph", "pn", "pl", "pt", "pr", "qa", "cg", "ro", "ru", "rw", "re", "bl", "sh", "kn", "lc", "mf", "pm", "vc", "ws", "sm", "st", "sa", "sn", "rs", "sc", "sl", "sg", "sx", "sk", "si", "sb", "so", "za", "gs", "kr", "ss", "es", "lk", "sd", "sr", "sj", "se", "ch", "sy", "tw", "tj", "tz", "th", "tl", "tg", "tk", "to", "tt", "tn", "tm", "tc", "tv", "tr", "ug", "ua", "ae", "gb", "uk", "us", "um", "uy", "uz", "vu", "va", "ve", "vn", "vg", "vi", "wf", "eh", "ye", "zm", "zw", "ax" ], "type": "string", "description": "Country code (gl) for localized results. Affects which regional Google frontend is used.", "default": "us" }, "includeRelatedQueries": { "title": "Include Related Queries", "type": "boolean", "description": "Also emit a row per query containing Google's 'Related searches' suggestions. Useful for keyword expansion and trend research.", "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 } } }, "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 } } } } } } } } } }