{ "openapi": "3.0.1", "info": { "title": "Google Maps Business Photo Annotator — AI Vision", "description": "Fetch Google Maps business photos and annotate each image with AI vision — scene type, caption, tags, OCR text, dishes, amenities, ambiance, colors, and quality scores. Paste a place ID, search query, or Maps URL; export structured JSON for listings, hospitality research, and local SEO workflows.", "version": "1.0", "x-build-id": "iiHlPeCK55HVqIsFC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rainminer~google-maps-images-annotator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rainminer-google-maps-images-annotator", "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/rainminer~google-maps-images-annotator/runs": { "post": { "operationId": "runs-sync-rainminer-google-maps-images-annotator", "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/rainminer~google-maps-images-annotator/run-sync": { "post": { "operationId": "run-sync-rainminer-google-maps-images-annotator", "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": "Queries", "type": "array", "description": "Google Maps search text, place_id, google_id, CID, or Maps URL. Up to 1000 per run.", "items": { "type": "string" } }, "photosLimit": { "title": "Photos per place", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of photos to fetch and annotate per place.", "default": 10 }, "placesPerQuery": { "title": "Places per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of places returned per query.", "default": 1 }, "tag": { "title": "Photo tag filter", "enum": [ "all", "latest", "menu", "by_owner" ], "type": "string", "description": "Which Google Maps photo tag to fetch.", "default": "all" }, "prompt": { "title": "AI vision prompt", "type": "string", "description": "System prompt for Gemini vision annotation. Annotate only what is visible; use null for uncertain fields.", "default": "You are an expert visual analyst of Google Maps business photos. Annotate only what is clearly visible in the image. Use null for fields when information is not visible or uncertain. Do not infer cuisine, brand names, or text that is not readable. For OCR (detectedText), transcribe only text you can actually read. For dishes, list only food items clearly shown. Rate qualityScore from 0 to 1 based on sharpness, lighting, and usefulness for a business listing. Set hasPeople true only when people are clearly visible (faces may be blurred). Set safetyFlag to sensitive only for clearly inappropriate content; otherwise none. Analyze this Google Maps business photo and return structured annotations for everything clearly visible." }, "annotationSchema": { "title": "Custom annotation schema", "type": "object", "description": "Optional JSON Schema for custom per-image AI output. When omitted, a fixed annotation schema is used." } } }, "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 } } } } } } } } } }