{ "openapi": "3.0.1", "info": { "title": "Google Maps Posts Scraper: Track Posts & Rank Local Competitors", "description": "Search Google Maps by keyword and location, or a direct place URL, to export every business post with text, dates, images, and CTAs, then rank businesses by posting recency and frequency. HTTP-only, no browser, datacenter proxy. Skip re-running competitor scrapers by hand. $0.00025 per post.", "version": "0.1", "x-build-id": "jkSr9VcEfXkt2xIJl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~google-maps-business-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-google-maps-business-posts-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/getascraper~google-maps-business-posts-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-google-maps-business-posts-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/getascraper~google-maps-business-posts-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-google-maps-business-posts-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": { "searchTerms": { "title": "Search terms", "type": "string", "description": "A business type or keyword, e.g. \"nail salon\" or \"brewery\". Combined with Location below to search Google Maps for every matching business in that market. This is the mode that produces the Posting Activity Leaderboard (who's posting most, and most recently) - neither of the two competitor tools computes this ranking, they only export one business's posts at a time. Leave blank if you're using Place URLs below instead.", "default": "nail salon" }, "location": { "title": "Location", "type": "string", "description": "A city, region, or address, e.g. \"Austin, TX\" or \"Manchester, UK\". Used together with Search Terms; Google resolves the market area from this text directly, no separate geocoding step.", "default": "Austin, TX" }, "placeUrls": { "title": "Place URLs", "type": "array", "description": "One or more direct Google Maps business URLs to export posts from, instead of a search. Use this for a single-business export. The other competitor tool with search support still can't do this AND rank against competitors in one run, this actor does both.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "language": { "title": "Language", "type": "string", "description": "Language code for post text and dates, e.g. \"en\", \"es\", \"fr\", \"de\". One of the two named competitors is USA/English-only; this field is what unlocks other markets.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code Google should treat the request as coming from, e.g. \"us\", \"gb\", \"de\", \"jp\". Affects local business ranking and available results.", "default": "us" }, "maxPlacesPerSearch": { "title": "Max places per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many businesses to pull from a single search and rank on the leaderboard. Google's own search response returns at most 20 real results in one page, so this is capped at 20, not a soft suggestion.", "default": 20 }, "maxPostsPerPlace": { "title": "Max posts per place", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many of a business's most recent owner posts to export. Also the number of posts the leaderboard's activity metrics (postsLast30Days, postsLast90Days) are computed from, so a low value can understate an active poster.", "default": 10 }, "monitorMode": { "title": "Monitor mode (only new posts)", "type": "boolean", "description": "When on, this run only outputs posts it hasn't seen before for the state name below, so a scheduled run reports fresh activity instead of the same posts every time. The leaderboard is still built from every post seen this run, not just the new ones.", "default": false }, "stateName": { "title": "Monitor state name", "type": "string", "description": "A short label for this monitor's saved checkpoint, e.g. \"austin-nail-salons\". Use a different name per market you track so their checkpoints don't overwrite each other.", "default": "default" }, "resetState": { "title": "Reset monitor state", "type": "boolean", "description": "Clears the saved checkpoint for the state name above before this run, so every post is reported as new again. Useful the first time you set up monitoring for a market, or after changing your search terms.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Datacenter (the default) is confirmed sufficient for Google Maps' internal search and place APIs used here, no browser or residential IPs required.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }