Google Maps Business Social Links Scraper
Pricing
from $3.99 / 1,000 results
Source-backed public Google Maps business records with optional social-profile discovery from linked business websites.
You can access the Google Maps Business Social Links Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.2", "x-build-id": "a8AFd5ZMSUpLd4N8j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/googleapi~google-maps-business-social-links-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-googleapi-google-maps-business-social-links-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/googleapi~google-maps-business-social-links-scraper/runs": { "post": { "operationId": "runs-sync-googleapi-google-maps-business-social-links-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/googleapi~google-maps-business-social-links-scraper/run-sync": { "post": { "operationId": "run-sync-googleapi-google-maps-business-social-links-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": { "query": { "title": "Search query", "minLength": 3, "maxLength": 200, "type": "string", "description": "One public business search, for example coffee shops in Austin." }, "searchQuery": { "title": "Search query (legacy alias)", "minLength": 3, "maxLength": 200, "type": "string", "description": "Compatibility alias for query." }, "queries": { "title": "Search queries", "maxItems": 50, "type": "array", "description": "One or more public business searches. maxItems is global across these searches.", "items": { "type": "string", "minLength": 3, "maxLength": 200 } }, "searchStringsArray": { "title": "Search queries (legacy alias)", "maxItems": 50, "type": "array", "description": "Compatibility alias for queries.", "items": { "type": "string", "minLength": 3, "maxLength": 200 } }, "searchKeywords": { "title": "Search keywords (legacy alias)", "maxItems": 50, "type": "array", "description": "Compatibility alias for queries.", "items": { "type": "string", "minLength": 3, "maxLength": 200 } }, "startUrls": { "title": "Google Maps URLs", "maxItems": 25, "type": "array", "description": "Public HTTPS Google Maps search or place URLs. When supplied, these URLs take precedence over generated queries.", "items": { "type": "object", "properties": { "url": { "title": "Google Maps URL", "type": "string", "minLength": 1, "maxLength": 2048, "description": "Public HTTPS Google Maps search or place URL." } }, "required": [ "url" ], "additionalProperties": false } }, "urls": { "title": "Google Maps URLs (legacy alias)", "maxItems": 25, "type": "array", "description": "Compatibility alias for startUrls. Values must be public HTTPS Google Maps search or place URLs.", "items": { "type": "string", "minLength": 1, "maxLength": 2048 } }, "locationQuery": { "title": "Location suffix", "maxLength": 200, "type": "string", "description": "Text appended to each generated query. Ignored when startUrls or urls are supplied." }, "maxItems": { "title": "Maximum businesses", "minimum": 1, "maximum": 100, "type": "integer", "description": "Global maximum of business records across all sources.", "default": 25 }, "maxCrawledPlacesPerSearch": { "title": "Maximum businesses (legacy alias)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Compatibility alias for maxItems." }, "page": { "title": "Starting scroll batch", "minimum": 1, "maximum": 50, "type": "integer", "description": "One-based starting batch for rendered Google Maps result feeds.", "default": 1 }, "maxPages": { "title": "Maximum scroll batches per source", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum rendered result batches per source. Static HTML mode reads one response per source.", "default": 3 }, "deduplicate": { "title": "Deduplicate businesses", "type": "boolean", "description": "Deduplicate using the public place ID, CID, Knowledge Graph ID, or canonical Maps URL.", "default": true }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Keep businesses with a visible rating at or above this value. Businesses without a visible rating do not match." }, "minReviews": { "title": "Minimum review count", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Keep businesses with a visible review count at or above this value. Businesses without a visible count do not match." }, "categoryFilter": { "title": "Category contains", "maxLength": 200, "type": "string", "description": "Case-insensitive substring filter over the visible primary category." }, "sortBy": { "title": "Sort results", "enum": [ "recommended", "rating_desc", "reviews_desc", "name_asc" ], "type": "string", "description": "Non-default sorts are applied across the collected result set.", "default": "recommended" }, "includeDetails": { "title": "Open Maps business profiles", "type": "boolean", "description": "Open a bounded number of public Google Maps profiles for additional business fields. A profile URL used as a start URL is already a detail page.", "default": false }, "maxDetailItems": { "title": "Maximum Maps profiles to open", "minimum": 0, "maximum": 25, "type": "integer", "description": "Maximum number of selected businesses whose public Maps profile is opened.", "default": 5 }, "includeWebsiteEnrichment": { "title": "Find social links on business websites", "type": "boolean", "description": "Fetch one public page from the website linked by Maps to find business social links and mail links. DNS checks pin the request to a validated public address; redirects are revalidated. An 8-second timeout, size limit, and business-name match are applied.", "default": false }, "maxWebsiteEnrichmentItems": { "title": "Maximum business websites to read", "minimum": 0, "maximum": 25, "type": "integer", "description": "Maximum number of linked public business websites to read when website enrichment is enabled. At most one page is fetched per business.", "default": 5 }, "includeMedia": { "title": "Include public business photos", "type": "boolean", "description": "Include photo URLs visible on result cards.", "default": true }, "maxImages": { "title": "Maximum photo URLs per business", "minimum": 0, "maximum": 20, "type": "integer", "description": "Upper bound for public business photo URLs in one record.", "default": 12 }, "renderJavaScript": { "title": "Render Google Maps", "type": "boolean", "description": "Use ordinary headless Chromium for the JavaScript-rendered result feed. No stealth or access-control bypass is used.", "default": true }, "useBrowser": { "title": "Use browser (legacy alias)", "type": "boolean", "description": "Compatibility alias for renderJavaScript." }, "requestDelayMs": { "title": "Delay between requests and scrolls (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Bounded pacing between public pages and result-feed scrolls.", "default": 750 }, "maxRequestRetries": { "title": "Retries for failed HTTP requests", "minimum": 0, "maximum": 3, "type": "integer", "description": "Finite retries for network errors in static HTTP mode. Access challenges and HTTP blocks are not retried.", "default": 1 }, "requestTimeoutSecs": { "title": "Request and navigation timeout (seconds)", "minimum": 10, "maximum": 120, "type": "integer", "description": "Maximum time for one Google Maps HTTP request or browser navigation.", "default": 45 }, "browserWaitMs": { "title": "Browser settle wait (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Bounded wait after a public Google Maps page navigation.", "default": 1500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings are ignored for Apify input compatibility; this Actor uses direct connections and logs a warning when a non-empty configuration is supplied." }, "locale": { "title": "Locale", "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$", "type": "string", "description": "Short locale used for generated search pages, such as en or en-US.", "default": "en" }, "language": { "title": "Language (legacy alias)", "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$", "type": "string", "description": "Compatibility alias for locale." } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Google Maps Business Social Links Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: