{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper: Image Search API with New-Image Monitor", "description": "Use this Actor when you need Google Images results for keywords: full-size image URL, width, height, file size, color, source page, title and domain. Monitor mode returns only images new since the last run. Site filters. No per-search fee; failed searches are free.", "version": "0.1", "x-build-id": "HbccKi8A2FxXhNAa0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/integrative_cafe_8pc~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-integrative_cafe_8pc-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/integrative_cafe_8pc~google-images-scraper/runs": { "post": { "operationId": "runs-sync-integrative_cafe_8pc-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/integrative_cafe_8pc~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-integrative_cafe_8pc-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 per line, as you would type it into Google Images (\"golden retriever\", \"nike air max 90\", \"minimalist logo design\").", "default": [ "golden retriever" ], "items": { "type": "string" } }, "maxImagesPerQuery": { "title": "Max images per search term", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many images to return for each search term, up to 100 (one Google Images results page). For more images on a subject, add variations of the term or run it with different filters.", "default": 50 }, "onlyNewImages": { "title": "Monitor mode: only images not delivered before", "type": "boolean", "description": "Remembers the images already delivered for each search (same term, country, language and filters) and returns only new ones. The first run returns the current results and saves them as the baseline. Combine with 'Published within' = past day and a daily schedule to get a feed of fresh images for a brand, product or topic.", "default": false }, "timeRange": { "title": "Published within", "enum": [ "any", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Google's time filter. With a time filter, almost every image carries Google's 'publishedAgo' label (\"4 hours ago\").", "default": "any" }, "onlyFromSites": { "title": "Only images from these sites", "type": "array", "description": "Website domains, one per line (etsy.com, pinterest.com). Only images on pages of these sites (and their subdomains) are returned. Useful to see how your product or brand shows up on a marketplace.", "items": { "type": "string" } }, "excludeSites": { "title": "Skip images from these sites", "type": "array", "description": "Website domains, one per line. Images on pages of these sites are left out (and not charged). Example: your own domain, to find where your images appear elsewhere.", "items": { "type": "string" } }, "size": { "title": "Image size", "enum": [ "any", "large", "medium", "icon" ], "type": "string", "description": "Google's size filter.", "default": "any" }, "imageType": { "title": "Image type", "enum": [ "any", "photo", "clipart", "lineart", "animated" ], "type": "string", "description": "Google's type filter.", "default": "any" }, "usageRights": { "title": "Usage rights", "enum": [ "any", "creativeCommons", "commercial" ], "type": "string", "description": "Google's usage rights filter. Check the license on the source page before reusing an image.", "default": "any" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code of the Google market to search (us, gb, ca, au, de, fr, br, in...). Results differ by country.", "default": "us" }, "language": { "title": "Interface language", "type": "string", "description": "Two-letter language code for Google's interface and labels (en, de, fr, es, pt...).", "default": "en" }, "maxConcurrency": { "title": "Searches in parallel", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many searches run at the same time (1 to 5).", "default": 3 }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify's Google SERP proxy is the one that works reliably with Google. Leave as is.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } }