# Google Search Business Scraper (`scrapyspider/google-search-business-scraper`) Actor Extract verified business contact details, addresses, and social media profiles from Google Search results. Supports multi-location detection, 8 social platforms, confidence scoring, and deep website extraction. No accounts or cookies required - **URL**: https://apify.com/scrapyspider/google-search-business-scraper.md - **Developed by:** [ScrapySpider](https://apify.com/scrapyspider) (community) - **Categories:** Lead generation, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Google Search Business Scraper Extract verified business contact details, addresses, and social media profiles from Google Search results — no accounts or cookies required. ### Key Highlights - **8 social media platforms** extracted per business — Facebook, Instagram, Twitter, LinkedIn, YouTube, TikTok, Pinterest, and Discord - **Deep website extraction** — visits official business websites to find contact details and social links not shown in search results - **Multi-location detection** — identifies chain businesses with multiple locations and returns each as a separate result - **Confidence scoring** — each result includes a confidence score so you can filter by data quality - **No login or cookies needed** — runs entirely through Google Search with proxy rotation - **Business status tracking** — reports whether a business is open, closed, or has an unknown status - **Bulk processing** — accepts arrays of businesses and processes them concurrently with configurable rate limits ### What Data You Get Each result includes the following fields: **Identification** - `CandidateID` — unique numeric ID for the result - `PrimaryCandidate` — whether this is the top match for the search query - `Establishment` — business name as found in search results - `Type` — business category (e.g., Coffee shop, Restaurant, Law firm) - `Business Status` — open, closed, or empty if unknown **Location** - `Street Address` — full street address - `City` — city name - `State` — state abbreviation - `Zip Code` — ZIP or postal code **Contact** - `PhoneNumber` — primary phone number - `Email` — email address (extracted from official website when available) - `Web` — official website URL **Social Media** - `Facebook` — Facebook page URL - `Instagram` — Instagram profile URL - `Twitter` — Twitter/X profile URL - `LinkedIn` — LinkedIn company page URL - `YouTube` — YouTube channel URL - `TikTok` — TikTok profile URL - `Pinterest` — Pinterest profile URL - `Discord` — Discord server invite URL **Metadata** - `Confidence` — data quality score (0–100) - `Scraped_At` — ISO 8601 timestamp of when the data was collected - `Notes` — details about which social profiles were verified from the official website - `Search Query` — the original search query used - `Search URL` — the Google Search URL used ### Use Cases - **Lead generation:** Build targeted prospect lists with verified phone numbers, emails, and social media profiles for outreach campaigns. - **Local SEO audits:** Verify business NAP (name, address, phone) data across Google Search results for local SEO consistency checks. - **Competitive analysis:** Collect competitor contact details, social media presence, and business status across multiple markets. - **CRM enrichment:** Enrich existing CRM records with missing addresses, phone numbers, websites, and social media links. - **Market research:** Map business locations, categories, and digital presence across cities and states for market entry planning. - **Data verification:** Cross-check business directories and databases against live Google Search results with confidence scoring. ### How to Use 1. Open the **Google Search Business Scraper** Actor page on Apify Console. 2. Click **Start** to open the input editor. 3. Add your businesses to the **businesses** array — each entry needs a `name`, `city`, and `state`. 4. Adjust **Max Concurrency** and **Max Requests Per Minute** if you need to control speed and proxy usage. 5. Click **Start** and wait for the run to complete. A typical batch of 50 businesses takes 5–15 minutes depending on concurrency settings. 6. Download results from the **Dataset** tab in JSON, CSV, or Excel format. ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `businesses` | Array | Yes | Array of objects, each with `name` (string), `city` (string), and `state` (string). Example: `[{"name": "Starbucks", "city": "Phoenix", "state": "AZ"}]` | | `maxConcurrency` | Integer | No | Maximum number of concurrent browser pages. Higher values run faster but use more memory and proxy requests. Default depends on plan. | | `maxRequestsPerMinute` | Integer | No | Rate limit for Google Search requests per minute. Lower values reduce the chance of temporary blocks. | | `proxyConfiguration` | Object | No | Apify proxy settings. Residential proxies recommended for best results. Default: `{"useApifyProxy": true}` | ### Output Sample ```json { "CandidateID": 1, "PrimaryCandidate": true, "Business Status": "", "Establishment": "Starbucks", "Street Address": "3038 E Camelback Rd", "City": "Phoenix", "State": "AZ", "Zip Code": "85016", "PhoneNumber": "(602) 954-8787", "Email": "", "Type": "Coffee shop", "Web": "https://www.starbucks.com/store-locator/store/15157/", "Facebook": "https://www.facebook.com/Starbucks", "Instagram": "https://www.instagram.com/starbucks", "Twitter": "https://twitter.com/Starbucks", "LinkedIn": "https://www.linkedin.com/company/starbucks", "YouTube": "https://www.youtube.com/starbucks", "TikTok": "", "Pinterest": "", "Discord": "", "Confidence": "100", "Scraped_At": "2025-01-15T14:30:00.000Z", "Notes": "Facebook, Instagram, Twitter, LinkedIn, and YouTube verified from the official website.", "Search Query": "Starbucks Phoenix AZ", "Search URL": "http://www.google.com/search?q=Starbucks%20Phoenix%20AZ&gl=us&hl=en" } ```` ### Pricing Google Search Business Scraper is a **free Actor**. You only pay for Apify platform usage (compute and proxy). **Estimated cost:** Scraping 100 businesses typically costs around $0.50–$2.00 in Apify credits, depending on proxy type (datacenter vs. residential) and concurrency settings. Residential proxies cost more but produce higher success rates. The [Apify Free plan](https://apify.com/pricing) includes $5 of monthly credits, enough for several hundred business lookups. ### Technical Notes - **Proxy usage:** The Actor uses Apify Proxy by default. Residential proxies are recommended for consistent results. Datacenter proxies work but may see lower success rates on Google Search. - **Rate limits:** Google may temporarily block requests if too many are sent in a short period. Use the `maxRequestsPerMinute` parameter to stay within safe limits. The Actor includes automatic retry logic for failed requests. - **Multi-location businesses:** When a search returns multiple locations (e.g., chain restaurants), the Actor creates a separate result for each location. The `PrimaryCandidate` field marks the top result. - **Social media extraction:** Social links are first collected from Google Search results, then the Actor visits the official business website to find additional social profiles. The `Notes` field indicates which profiles were verified from the website. - **Data completeness:** Not every field is populated for every business. Fields like `Email`, `TikTok`, `Pinterest`, and `Discord` are often empty because businesses do not always publish this information publicly. - **US-focused:** Search queries are sent with `gl=us` and `hl=en` parameters. The Actor is optimized for US-based business lookups. ### Integrations Connect Google Search Business Scraper with other tools and services through the Apify platform: - **Webhooks** — trigger HTTP requests when a run finishes to notify your backend or start downstream workflows. - **API** — start runs, retrieve datasets, and manage the Actor programmatically via the [Apify API](https://docs.apify.com/api/v2). - **Integrations** — connect directly to Google Sheets, Slack, Zapier, Make (Integromat), GitHub, and other services through [Apify Integrations](https://apify.com/integrations). - **Apify SDK** — call this Actor from other Actors or scripts using the [Apify JavaScript SDK](https://docs.apify.com/sdk/js) or [Python SDK](https://docs.apify.com/sdk/python). - **Scheduled runs** — set up recurring runs on a daily, weekly, or custom schedule directly from the Apify Console. ### Support For questions, bug reports, or feature requests: - 📧 Email: - 🌐 Website: [ScrapySpider.com](https://scrapyspider.com) - ⏱️ Response time: 24–48 hours # Actor input Schema ## `businesses` (type: `array`): List of businesses to search for on Google. Each item should have a business name, city, and state. ## `maxConcurrency` (type: `integer`): Maximum number of concurrent requests. Lower values use less memory but take longer. ## `maxRequestsPerMinute` (type: `integer`): Maximum number of requests per minute. Helps avoid rate limiting. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Recommended: use GOOGLE\_SERP proxy group for best results. ## Actor input object example ```json { "businesses": [ { "name": "Starbucks", "city": "Phoenix", "state": "AZ" }, { "name": "McDonald's", "city": "New York", "state": "NY" }, { "name": "The Cheesecake Factory", "city": "Los Angeles", "state": "CA" } ], "maxConcurrency": 2, "maxRequestsPerMinute": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "businesses": [ { "name": "Starbucks", "city": "Phoenix", "state": "AZ" }, { "name": "McDonald's", "city": "New York", "state": "NY" }, { "name": "The Cheesecake Factory", "city": "Los Angeles", "state": "CA" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapyspider/google-search-business-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "businesses": [ { "name": "Starbucks", "city": "Phoenix", "state": "AZ", }, { "name": "McDonald's", "city": "New York", "state": "NY", }, { "name": "The Cheesecake Factory", "city": "Los Angeles", "state": "CA", }, ], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["GOOGLE_SERP"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapyspider/google-search-business-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "businesses": [ { "name": "Starbucks", "city": "Phoenix", "state": "AZ" }, { "name": "McDonald'\''s", "city": "New York", "state": "NY" }, { "name": "The Cheesecake Factory", "city": "Los Angeles", "state": "CA" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } }' | apify call scrapyspider/google-search-business-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapyspider/google-search-business-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Search Business Scraper", "description": "Extract verified business contact details, addresses, and social media profiles from Google Search results. Supports multi-location detection, 8 social platforms, confidence scoring, and deep website extraction. No accounts or cookies required", "version": "1.0", "x-build-id": "727A3s7GRdmSJHKkM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyspider~google-search-business-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyspider-google-search-business-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/scrapyspider~google-search-business-scraper/runs": { "post": { "operationId": "runs-sync-scrapyspider-google-search-business-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/scrapyspider~google-search-business-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyspider-google-search-business-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": [ "businesses" ], "properties": { "businesses": { "title": "Businesses to Search", "type": "array", "description": "List of businesses to search for on Google. Each item should have a business name, city, and state.", "items": { "type": "object", "required": [ "name", "city", "state" ], "properties": { "name": { "type": "string", "title": "Business Name", "description": "Name of the business to search for" }, "city": { "type": "string", "title": "City", "description": "City where the business is located" }, "state": { "type": "string", "title": "State", "description": "US state abbreviation (e.g., AZ, CA, NY)" } } }, "default": [ { "name": "Starbucks", "city": "Phoenix", "state": "AZ" }, { "name": "McDonald's", "city": "New York", "state": "NY" }, { "name": "The Cheesecake Factory", "city": "Los Angeles", "state": "CA" } ] }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of concurrent requests. Lower values use less memory but take longer.", "default": 2 }, "maxRequestsPerMinute": { "title": "Max Requests Per Minute", "minimum": 1, "maximum": 60, "type": "integer", "description": "Maximum number of requests per minute. Helps avoid rate limiting.", "default": 20 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. Recommended: use GOOGLE_SERP proxy group for best results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } } ```