{
"openapi": "3.0.1",
"info": {
"title": "Google Images Scraper + Reverse Image Search",
"description": "Scrape Google Images by keyword (image URL, page, title, source site, thumbnail) with size, type, color, transparent and license filters, or reverse-search your images to find where they appear online: Etsy, Amazon, Redbubble and more. Only-new alerts. Pay per result.",
"version": "1.0",
"x-build-id": "r9eD0GPc17mP4AP8E"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vncntlabs~google-images-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vncntlabs-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/vncntlabs~google-images-scraper/runs": {
"post": {
"operationId": "runs-sync-vncntlabs-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/vncntlabs~google-images-scraper/run-sync": {
"post": {
"operationId": "run-sync-vncntlabs-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": {
"keywords": {
"title": "Keywords (image search)",
"type": "array",
"description": "One Google Images search per line (up to 100). Leave empty if you only want reverse image search.",
"items": {
"type": "string"
}
},
"imageUrls": {
"title": "Image URLs (reverse image search)",
"type": "array",
"description": "Public image links (jpg, png, webp...), up to 100. For each image you get the pages where Google finds it or visually similar images, with marketplaces flagged. Use it to find copies of your designs, photos or products.",
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"enum": [
"Argentina",
"Australia",
"Austria",
"Bangladesh",
"Belgium",
"Brazil",
"Bulgaria",
"Canada",
"Chile",
"Colombia",
"Costa Rica",
"Croatia",
"Cyprus",
"Czechia",
"Denmark",
"Dominican Republic",
"Ecuador",
"Egypt",
"Estonia",
"Finland",
"France",
"Germany",
"Greece",
"Hong Kong",
"Hungary",
"Iceland",
"India",
"Indonesia",
"Ireland",
"Israel",
"Italy",
"Japan",
"Kenya",
"Kuwait",
"Latvia",
"Lithuania",
"Luxembourg",
"Malaysia",
"Malta",
"Mexico",
"Morocco",
"Netherlands",
"New Zealand",
"Nigeria",
"Norway",
"Pakistan",
"Peru",
"Philippines",
"Poland",
"Portugal",
"Puerto Rico",
"Qatar",
"Romania",
"Saudi Arabia",
"Serbia",
"Singapore",
"Slovakia",
"Slovenia",
"South Africa",
"South Korea",
"Spain",
"Sweden",
"Switzerland",
"Taiwan",
"Thailand",
"Turkiye",
"Ukraine",
"United Arab Emirates",
"United Kingdom",
"United States",
"Uruguay",
"Vietnam"
],
"type": "string",
"description": "Google country edition.",
"default": "United States"
},
"language": {
"title": "Language",
"type": "string",
"description": "Optional language code (en, de, fr, es, pt-BR...). Defaults to the country's main language."
},
"maxImagesPerKeyword": {
"title": "Max images per keyword",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Up to 200 per keyword (Google's first 200 image results). Add keyword variations for more.",
"default": 100
},
"imageSize": {
"title": "Size",
"enum": [
"any",
"large",
"medium",
"icon"
],
"type": "string",
"description": "Google Images size filter.",
"default": "any"
},
"imageType": {
"title": "Type",
"enum": [
"any",
"photo",
"clipart",
"lineart",
"animated",
"face"
],
"type": "string",
"description": "Google Images type filter.",
"default": "any"
},
"imageColor": {
"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 (PNG cut-outs) or a main color.",
"default": "any"
},
"timeRange": {
"title": "Time",
"enum": [
"any",
"past_24_hours",
"past_week",
"past_month",
"past_year"
],
"type": "string",
"description": "Only images Google found in this period.",
"default": "any"
},
"usageRights": {
"title": "Usage rights",
"enum": [
"any",
"creative_commons",
"commercial"
],
"type": "string",
"description": "Google's license filter. Always check the license on the source page before reusing an image.",
"default": "any"
},
"includeDomains": {
"title": "Only these sites",
"type": "array",
"description": "Optional, e.g. etsy.com. Keeps only images from these sites (other images are not charged).",
"items": {
"type": "string"
}
},
"excludeDomains": {
"title": "Exclude sites",
"type": "array",
"description": "Optional. Drops images from these sites (not charged).",
"items": {
"type": "string"
}
},
"ignoreDomains": {
"title": "Your own sites (ignored)",
"type": "array",
"description": "Matches on these domains are skipped, e.g. your shop, yourbrand.com or your Etsy shop's domain. Use it so only other people's copies show up.",
"items": {
"type": "string"
}
},
"marketplacesOnly": {
"title": "Only marketplace matches",
"type": "boolean",
"description": "Keep only matches on marketplaces and print-on-demand sites (Amazon, Etsy, eBay, Redbubble, TeePublic, Temu, Shein, AliExpress, Walmart, Zazzle, Spreadshirt, Society6...).",
"default": false
},
"maxMatchesPerImage": {
"title": "Max matches per image",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Google usually returns about 60 visual matches plus matching pages.",
"default": 100
},
"onlyNewMatches": {
"title": "Only new matches (monitoring)",
"type": "boolean",
"description": "For scheduled runs: remembers the matches from previous runs and returns only new pages. An image with no new matches is not charged. History is kept in your Apify account (key-value store 'google-images-monitor').",
"default": false
},
"monitorId": {
"title": "Monitor name",
"type": "string",
"description": "Optional. Keeps this monitor's history separate, e.g. my-shop-designs."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}