{ "openapi": "3.0.1", "info": { "title": "Google Images Scraper - Usage Rights, Creative Commons Filter", "description": "Google Images scraper for keyword lists. Get original full-size image URLs with width, height, file size, source page, site name and thumbnail. Filter by usage rights (Creative Commons or commercial), size, color, type and time. Pay only per image.", "version": "1.0", "x-build-id": "yzLBcnftJ4inswq7t" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-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/kamerozkan~google-images-scraper/runs": { "post": { "operationId": "runs-sync-kamerozkan-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/kamerozkan~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-kamerozkan-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 queries", "type": "array", "description": "Keywords to search in Google Images, one per line. Google search operators work, for example site:unsplash.com mountain lake.", "default": [ "mountain lake" ], "items": { "type": "string" } }, "usageRights": { "title": "Usage rights", "enum": [ "any", "creative_commons", "commercial" ], "type": "string", "description": "Google's usage rights filter. 'Creative Commons licenses' returns images Google marks as CC licensed; 'Commercial and other licenses' returns images with licensing info such as stock photos. Always check the license on the source page before you reuse an image.", "default": "any" }, "size": { "title": "Size", "enum": [ "any", "large", "medium", "icon" ], "type": "string", "description": "Google's size filter. 'Large' usually means 1000 px or more on the long side.", "default": "any" }, "color": { "title": "Color", "enum": [ "any", "color", "black_and_white", "transparent", "red", "orange", "yellow", "green", "teal", "blue", "purple", "pink", "white", "gray", "black", "brown" ], "type": "string", "description": "Google's color filter: full color, black and white, transparent background or one main color.", "default": "any" }, "imageType": { "title": "Type", "enum": [ "any", "photo", "clipart", "line_drawing", "gif", "face" ], "type": "string", "description": "Google's type filter.", "default": "any" }, "timeRange": { "title": "Time", "enum": [ "any", "day", "week", "month", "year" ], "type": "string", "description": "Only images Google found in this time window.", "default": "any" }, "minWidth": { "title": "Minimum width (px)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Drop images narrower than this. Dropped images are not charged. 0 keeps all.", "default": 0 }, "minHeight": { "title": "Minimum height (px)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Drop images lower than this. Dropped images are not charged. 0 keeps all.", "default": 0 }, "countryCode": { "title": "Country", "enum": [ "us", "gb", "ca", "au", "in", "de", "at", "ch", "fr", "be", "nl", "it", "es", "pl", "se", "br", "mx", "jp" ], "type": "string", "description": "Google country edition. Ranking and sources follow this country.", "default": "us" }, "languageCode": { "title": "Language (optional)", "type": "string", "description": "Interface language code such as en, de or fr. Leave empty to use the country's main language." }, "safeSearch": { "title": "SafeSearch", "type": "boolean", "description": "Filter explicit results (Google SafeSearch).", "default": true }, "maxResultsPerQuery": { "title": "Max images per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop each query after this many images. One results page holds about 100 images; the actor pages further when you ask for more. Google usually returns 300 to 400 images per query and filter combination.", "default": 100 }, "maxItems": { "title": "Max images in total", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop the whole run after this many images. You are charged per image, so this also caps the cost of the run.", "default": 1000 } } }, "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 } } } } } } } } } }