{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper - Image URLs, Sizes & Sources", "description": "Scrape Google Images by keyword or URL: original image URL, width and height, source page, page title, domain, file type and thumbnail. All Google filters (size, color, type, file type, shape, usage rights, date), any country. No login or browser. From $0.70 per 1,000 images.", "version": "0.1", "x-build-id": "87c2eLERXzN1ocENV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eiv~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eiv-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/eiv~google-images-scraper/runs": { "post": { "operationId": "runs-sync-eiv-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/eiv~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-eiv-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": "One search per line, as you would type it into Google Images. Operators work: site:example.com, -word, \"exact phrase\". A Google Images URL works too and keeps its own filters, country and language. Example: golden retriever puppy", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max images per query", "minimum": 1, "maximum": 600, "type": "integer", "description": "Stop each search after this many images. Google shows at most about 400-600 images for one search, 20 per page. You pay per image, so this is also your cost cap per search.", "default": 100 }, "maxItems": { "title": "Max images in total", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop the whole run after this many images, across all searches.", "default": 10000 }, "imageSize": { "title": "Size", "enum": [ "any", "large", "medium", "icon", "400x300", "640x480", "800x600", "1024x768", "2mp", "4mp", "6mp", "8mp", "10mp", "12mp", "15mp", "20mp", "40mp", "70mp" ], "type": "string", "description": "Google's size filter: Large, Medium, Icon, or larger than a minimum size (e.g. 4 MP = at least 2272 x 1704).", "default": "any" }, "color": { "title": "Color", "enum": [ "any", "color", "grayscale", "transparent", "red", "orange", "yellow", "green", "teal", "blue", "purple", "pink", "white", "gray", "black", "brown" ], "type": "string", "description": "Full color, black and white, transparent background, or images dominated by one color.", "default": "any" }, "imageType": { "title": "Type", "enum": [ "any", "photo", "face", "clipart", "lineart", "animated" ], "type": "string", "description": "Photos, faces, clip art, line drawings or animated GIFs.", "default": "any" }, "fileType": { "title": "File type", "enum": [ "any", "jpg", "png", "gif", "webp", "svg", "bmp", "ico" ], "type": "string", "description": "Only images in this format.", "default": "any" }, "aspectRatio": { "title": "Shape", "enum": [ "any", "tall", "square", "wide", "panoramic" ], "type": "string", "description": "Tall (portrait), square, wide (landscape) or panoramic images.", "default": "any" }, "usageRights": { "title": "Usage rights", "enum": [ "any", "creativeCommons", "commercial" ], "type": "string", "description": "Google's licence filter: images marked with a Creative Commons licence, or with commercial and other licences. Always check the licence on the source page before reusing an image.", "default": "any" }, "timePeriod": { "title": "Time", "enum": [ "any", "day", "week", "month", "year" ], "type": "string", "description": "Only images Google first found in this period. Use From date / To date for a custom range.", "default": "any" }, "dateFrom": { "title": "From date", "type": "string", "description": "Custom range start (YYYY-MM-DD): only images Google dates on or after this day. Replaces \"Time\" when set." }, "dateTo": { "title": "To date", "type": "string", "description": "Custom range end (YYYY-MM-DD): only images Google dates on or before this day." }, "safeSearch": { "title": "SafeSearch", "type": "boolean", "description": "On: Google filters out explicit images. Off: no filtering.", "default": true }, "countryCode": { "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", "kh", "cm", "ca", "cv", "ky", "cf", "td", "cl", "cn", "cx", "cc", "co", "km", "cd", "cg", "ck", "cr", "ci", "hr", "cu", "cy", "cz", "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", "gn", "gw", "gy", "ht", "hm", "hn", "hk", "hu", "is", "in", "id", "ir", "iq", "ie", "il", "it", "jm", "jp", "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", "an", "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", "re", "ro", "ru", "rw", "sh", "kn", "lc", "pm", "vc", "ws", "sm", "st", "sa", "sn", "rs", "sc", "sl", "sg", "sk", "si", "sb", "so", "za", "gs", "kr", "es", "lk", "sd", "sr", "sj", "se", "ch", "sy", "tw", "tj", "tz", "th", "tl", "tg", "tk", "to", "tt", "tn", "tr", "tm", "tc", "tv", "ug", "ua", "ae", "gb", "us", "um", "uy", "uz", "vu", "va", "ve", "vn", "vg", "vi", "wf", "eh", "ye", "zm", "zw" ], "type": "string", "description": "Country whose Google Images results you want (Google's gl parameter). Default: United States." }, "languageCode": { "title": "Interface language", "enum": [ "", "af", "sq", "am", "ar", "hy", "az", "eu", "be", "bn", "bh", "bs", "bg", "my", "ca", "zh-CN", "zh-TW", "hr", "cs", "da", "nl", "en", "eo", "et", "fo", "fi", "fr", "fy", "gl", "ka", "de", "el", "gu", "iw", "hi", "hu", "is", "id", "ia", "ga", "it", "ja", "jw", "kn", "km", "ko", "lo", "la", "lv", "lt", "mk", "ms", "ml", "mt", "mr", "mn", "ne", "no", "nn", "oc", "fa", "pl", "pt-BR", "pt-PT", "pa", "ro", "ru", "sm", "gd", "sr", "si", "sk", "sl", "so", "es", "su", "sw", "sv", "tl", "ta", "te", "th", "ti", "tr", "uk", "ur", "uz", "vi", "cy", "xh", "zu" ], "type": "string", "description": "Language of Google's interface (hl), which also shapes which images rank. Default: the country's main language." }, "exactQuery": { "title": "Search exactly as typed", "type": "boolean", "description": "Turn off Google's autocorrect, so a misspelled or rare word is searched as written. When it is off and Google corrects a search, each image says so in correctedQuery.", "default": false }, "includePageDetails": { "title": "Page titles and file types", "type": "boolean", "description": "Adds the title of the page each image is on and Google's file type. One small extra request per image, included in the price; turn off for the fastest runs (the file type then comes from the image URL).", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: when Google rate-limits, the run switches between its own address and Apify's datacenter proxy, both free. Pick Residential only if runs keep getting refused; results pages then use it after the free addresses (page titles always use the free ones). Your own proxy URLs replace the datacenter step.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Searches at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at the same time. Google requests are capped at 8 in flight whatever this says.", "default": 3 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for one response before trying another address.", "default": 30 } } }, "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 } } } } } } } } } }