# Google Maps Scraper & API: Business Leads, Emails & Phones (`plainrows/google-maps-businesses`) Actor Google Maps scraper and MCP tool, Google Maps API and Outscraper alternative, no subscription: B2B leads from Google Places with name, address, phone, website, rating, reviews, hours, coordinates, plus optional e-mails and socials of each website. Pay per place, plus per website with contacts. - **URL**: https://apify.com/plainrows/google-maps-businesses.md - **Developed by:** [PlainRows](https://apify.com/plainrows) (community) - **Categories:** Lead generation, SEO tools, Automation - **Features:** Limited permissions - **Stats:** 1 total users, 0 monthly users, 97.1% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 places This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Google Maps Scraper & API: Business Leads, Emails & Phones Turn any Google Maps search into a clean list of businesses: **name, category, full address, phone, website, rating, number of reviews, opening hours, GPS coordinates and Place ID**, and optionally the **e-mails and social profiles published on each business's website**. Type what you would type in Google Maps (`plumber in Austin`, `dentist 75011 Paris`) and get up to 700 places per search. It calls a commercial search data API instead of driving a browser: **results in seconds, no proxies, no blocked runs, no Google account.** **You pay for places returned** (see the Pricing tab for any other fee): searches with no result and places removed by your filters are free. ### Typical uses - **Lead generation**: local businesses by trade and city, with phone, website and (option `contactDetails`) e-mails and social profiles, ready for your CRM or outreach list. - **Web design and marketing agencies**: find businesses **without a website** (`website: "without"`) or with a low rating. - **Local SEO**: see who ranks in the Google Maps pack for a query, with rating, review count and claimed status. - **Market research**: count and map competitors, franchises or points of sale in an area. - **Automations and AI agents**: feed n8n, Make, Zapier, Google Sheets or an MCP client with structured JSON. ### What you get for each place | Field | Description | |---|---| | `name`, `category`, `additionalCategories`, `categoryIds` | Business name and Google categories (`categoryIds` are language-independent, e.g. `pizza_restaurant`) | | `address`, `street`, `city`, `postalCode`, `region`, `countryCode` | Address, also split into parts | | `latitude`, `longitude` | GPS coordinates | | `phone` | Business phone, international format | | `website`, `domain`, `bookingUrl` | Website listed on Google Maps, its domain, Google booking link | | `websiteType` | `NONE` (no link on Google Maps), `PLATFORM_PAGE` (only a Facebook, Instagram, Yelp or delivery page) or `OWN_SITE` | | `rating`, `reviewsCount`, `ratingDistribution` | Average rating, number of ratings, count of 1 to 5 star ratings | | `priceLevel`, `isClaimed`, `photosCount`, `imageUrl` | Price level, whether the owner claimed the listing, photos | | `openingHours` | Hours per weekday, e.g. `{"monday": ["09:00-17:30"]}`; an empty list means closed | | `placeId`, `cid`, `googleMapsUrl` | Google identifiers and a direct Google Maps link | | `rank` | Position in the Google Maps results for your query (sponsored pins excluded) | | `searchQuery`, `observedAt` | The query that found it and when (UTC) | **With `contactDetails: true`**, each place also gets what its own website publishes: | Field | Description | |---|---| | `email`, `emails` | First e-mail and all e-mails found (max 10), addresses on the business's own domain first | | `websitePhones` | Phone numbers linked on the website | | `facebookUrl`, `instagramUrl`, `linkedinUrl`, `xUrl`, `youtubeUrl`, `tiktokUrl` | Social profiles the website links to (share buttons, posts and personal Facebook / LinkedIn profile links ignored) | | `contactStatus` | `FOUND`, `NONE_FOUND`, `OPTED_OUT` (the site objects to solicitation: nothing returned, not billed), `LEGAL_NOTICE_UNREADABLE` (its legal notice could not be read now: nothing returned, not billed), `NO_WEBSITE`, `PLATFORM_PAGE` (the website is a social page), or why the site could not be read (`TIMEOUT`, `BLOCKED_BY_BOT_PROTECTION`, `ROBOTS_TXT_DISALLOWED`...) | | `contactPagesChecked` | Pages read: the homepage, plus up to 2 contact or legal pages when the homepage shows no e-mail (team and about pages are never read) | | `contactOptOut` | `true` when a page read objects to solicitation: e-mails, phones and social profiles are then empty (see [Personal data and GDPR](#personal-data-and-gdpr)) | The website is read like a normal visit (no browser, robots.txt respected): addresses shown only after JavaScript runs or hidden behind a contact form are not found. In our tests of 08.10.2026, an e-mail was found for 45 of 79 Chicago plumbers' websites, 86 of 95 Munich dentists' websites (German sites publish one in their Impressum) and 11 of 19 Austin coffee shops; about 5 websites read per second for each search (79 in 16 s in Chicago). These figures predate the exclusion of sites that object to solicitation, which is common in German Impressum pages: expect fewer e-mails there. `categoryIds` and `priceLevel` are empty since October 13, 2026: the data source stopped returning them (checked on real runs on October 13 and 14); `category` and `additionalCategories` are unaffected. Missing values are always `null` (lists are empty), never guessed. Each place appears once per run: a place found by several of your searches is returned, and charged, only for the first one (`placesInEarlierQueries` in `OUTPUT` counts the others). ### Input ```json { "searchQueries": ["plumber in Austin, TX", "electrician in Austin, TX"], "country": "US", "maxPlacesPerQuery": 100, "website": "any", "minRating": 0, "requirePhone": false, "contactDetails": false } ``` - **searchQueries**: up to 1,000 per run. Put the city or area in the query, or set **coordinates**. - **country**: US, GB, CA, AU, IE, IN, DE, AT, CH, FR, BE, ES, MX, IT, NL, PT, BR, PL, SE, JP. **languageCode** (optional) sets the language of categories and labels. - **maxPlacesPerQuery**: 1 to 700 (default 100). - **coordinates** + **zoom** (optional): search around `"latitude,longitude"`, zoom 11 (city) to 15 (a few streets). - **Free filters**: `minRating`, `website` (`any`, `with`, `without`), `requirePhone`. Places removed by a filter are never billed. - **contactDetails** (optional, paid per place with results): visit each website for e-mails, phone links and social profiles. Adds a few seconds per place; websites are read 10 at a time. ### Output example Real row from a run on 2026-10-07 (query `coffee shop in Austin, TX`, US): ```json { "searchQuery": "coffee shop in Austin, TX", "found": true, "rank": 1, "name": "Terrible Love", "category": "Coffee shop", "additionalCategories": [ "Coffee stand" ], "categoryIds": [], "address": "3908 Avenue B, Austin, TX 78751", "street": "3908 Avenue B", "city": "Austin", "postalCode": "78751", "region": "Texas", "borough": "Hyde Park", "countryCode": "US", "latitude": 30.3045132, "longitude": -97.735632, "phone": null, "website": "http://terriblelovecoffee.com/", "domain": "terriblelovecoffee.com", "bookingUrl": null, "rating": 4.9, "reviewsCount": 432, "ratingDistribution": { "1": 4, "2": 2, "3": 7, "4": 20, "5": 399 }, "priceLevel": null, "isClaimed": true, "photosCount": 336, "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9S6SEwIENo3cfT2-9zzX1KN2Fzpkczg3uVQbrrmnUFU0oc6yh2caJFICid_4t5hGFdO7T7_aDEDhe8ohrWv926q5QmQ3DTepiLfU9A4SIVzkBqI4LMaYIyA7XdFamAEAFeq4sJNng=w408-h544-k-no", "openingHours": { "monday": [ "07:30-14:00" ], "tuesday": [ "07:30-14:00" ], "wednesday": [ "07:30-14:00" ], "thursday": [ "07:30-14:00" ], "friday": [ "07:30-14:00" ], "saturday": [ "08:30-15:00" ], "sunday": [ "08:30-15:00" ] }, "placeId": "ChIJP8p2kJC1RIYR2qrGoXZtZCk", "cid": "2982629209513831130", "googleMapsUrl": "https://maps.google.com/?cid=2982629209513831130", "searchCountry": "US", "languageCode": "en", "observedAt": "2026-10-07T13:00:33.260Z", "schemaVersion": "1.0" } ``` ### Pricing Pay per place returned, no subscription, no proxy costs. See the **Pricing** tab for current prices: one event per **place found**, cheaper on higher Apify plans. Hours, phone, website and coordinates are included in that price (no "details" add-on). **Contact details** (option `contactDetails`) are a second event, **contact details found**, charged only for websites that show at least one e-mail, phone link or social profile, once per website per run: the other places of a chain get the same details for free. Places without a website, sites that cannot be loaded, sites with nothing found and sites that object to solicitation are free. Price change on November 6, 2026: a small **Actor start** fee of $0.003 per run (one event per GB of memory; the Actor uses at most 1 GB), as on our Google Maps Email Extractor. Place and contact prices do not change. Until then there is no fee per run. Searches with no result, duplicates, places removed by your filters and input mistakes cost nothing. The run never spends more than the maximum cost you set. **Free Apify plan:** each run returns up to 20 places for up to 2 queries, so you can check the output. A paid Apify plan removes these limits. ### Use it from code, automations or AI agents **API (one call, results returned directly):** ```bash curl -X POST "https://api.apify.com/v2/acts/plainrows~google-maps-businesses/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchQueries": ["coffee shop in Austin, TX"], "maxPlacesPerQuery": 50}' ``` **n8n, Make, Zapier:** use the Apify integration, pick `plainrows/google-maps-businesses`, and map the dataset items to Google Sheets, HubSpot, Airtable or your database. **AI agents (MCP):** add `https://mcp.apify.com?tools=plainrows/google-maps-businesses` to Claude, Cursor or any MCP client. The agent gets a typed tool and pays per result. ### What this is not - **No reviews text, no reviewer names.** E-mails come only from the business's own website, with the `contactDetails` option: no guessed addresses, no personal profiles looked up elsewhere. - Not a full Google Maps clone: popular times, menus and Q\&A are not included. - Not affiliated with Google. ### Personal data and GDPR With `contactDetails`, contact fields contain only what each business publishes on its own website: no guessed addresses, nothing bought or looked up elsewhere. Personal profile links (LinkedIn `/in/` pages, Facebook `profile.php` and `/people/` links) are dropped, e-mails hidden in the page code and people's details in structured data are ignored, and team or staff pages are never read. When a page read explicitly objects to solicitation (for example "Widerspruch gegen Werbe-E-Mails", "no unsolicited sales calls", "pas de démarchage"), no e-mail, phone or social profile is returned for that site, `contactOptOut` is `true` and nothing is billed. A published business e-mail can still name a person: you are responsible for using the data lawfully (GDPR, ePrivacy and anti-spam rules, for example a documented legitimate interest for B2B outreach and an easy way to object). To have a website excluded, open an issue in the **Issues** tab of this Actor on Apify Store. ### Run summary Each run stores a summary in the key-value store (`OUTPUT`): queries run, queries with no result, places billed, places removed by filters, duplicates and invalid queries, and anything skipped because of the free-plan or budget limit. ### FAQ **How do I export businesses from Google Maps to Excel or Google Sheets?** Enter searches such as `plumber in Austin, TX`, run, then download the results as CSV or Excel from the run page, or send them to Google Sheets with n8n, Make or Zapier. **Can I find businesses without a website?** Yes: set **website** to `without`, and **requirePhone** to keep only places with a phone number. Places removed by these filters are not billed. **How many places can I get per search?** 1 to 700 per search (**maxPlacesPerQuery**). To cover a large city, run several searches by neighbourhood, or search around **coordinates** with a closer **zoom**. **Do I need proxies, a browser or a Google account?** No. The data comes from a commercial search data API, so runs are fast and you pay per place returned (see the Pricing tab). **Does it return e-mails?** Yes, with `contactDetails: true`: the e-mails, phone links and business social profiles that each business publishes on its own website, billed only when something is found. Addresses are never guessed or bought from a database, and sites that object to solicitation are skipped. You are responsible for using them lawfully (see Personal data and GDPR). **Does it return reviews?** No review texts and no reviewer names: only the rating, the number of reviews and the count per star. ### More PlainRows tools Same pay-per-result pricing, same clean JSON, built to chain together in n8n, Make, Zapier or AI agents. - **SEO and keywords:** [Keyword Search Volume, CPC & Difficulty](https://apify.com/plainrows/keyword-search-volume) · [Keyword Planner Alternative (Bulk Search Volume & CPC)](https://apify.com/plainrows/keyword-planner-alternative) · [Google Keyword Planner API (Google Ads Search Volume & CPC)](https://apify.com/plainrows/google-keyword-planner-api) · [Google Autocomplete & People Also Ask](https://apify.com/plainrows/google-autocomplete-questions) · [Google Trends Explorer](https://apify.com/plainrows/google-trends-explorer) · [Google Trends Keyword Discovery (Rising & Related)](https://apify.com/plainrows/google-trends-keyword-discovery) · [Website Organic Traffic & Top Keywords](https://apify.com/plainrows/domain-seo-overview) · [Competitor Keywords API (Ranked Keywords)](https://apify.com/plainrows/competitor-keywords-api) · [Bulk Website Traffic Checker](https://apify.com/plainrows/website-traffic-checker) · [PPC Competitor Keywords (SpyFu Alternative)](https://apify.com/plainrows/ppc-competitor-keywords) · [Bulk Domain Authority Checker](https://apify.com/plainrows/domain-authority-checker) · [Backlink Checker](https://apify.com/plainrows/backlink-checker) · [Backlink API (Referring Domains & Backlinks Data)](https://apify.com/plainrows/backlink-api) · [Broken Link Checker](https://apify.com/plainrows/broken-link-checker) · [SEO Audit API (On-Page SEO Checker)](https://apify.com/plainrows/seo-audit-api) · [AI Search Visibility Tracker (ChatGPT, Gemini, AI Mode)](https://apify.com/plainrows/ai-search-brand-visibility) · [AI Overview Tracker (Google AI Overview Citations)](https://apify.com/plainrows/ai-overview-tracker) · [Perplexity Search API (Answers & Citations)](https://apify.com/plainrows/perplexity-search-api) · [ChatGPT Search Scraper (Answers & Citations)](https://apify.com/plainrows/chatgpt-search-scraper) · [Google AI Mode API (Answers & Citations)](https://apify.com/plainrows/google-ai-mode-api) · [Gemini Search Scraper (Answers & Citations)](https://apify.com/plainrows/gemini-search-scraper) · [AI Citations Finder (LLM Mentions in ChatGPT & AI Overviews)](https://apify.com/plainrows/ai-citations-finder) · [Keyword Rank Checker (Google SERP Position)](https://apify.com/plainrows/keyword-rank-checker) · [Google Search API (SERP Scraper & Web Results)](https://apify.com/plainrows/google-search-api) · [Bing Search API (Bing SERP & Web Results)](https://apify.com/plainrows/bing-search-api) - **Leads and companies:** [Google Maps Email Extractor](https://apify.com/plainrows/google-maps-email-extractor) · [Google Maps Businesses Without Website](https://apify.com/plainrows/google-maps-no-website-leads) · [Yellow Pages Australia Scraper](https://apify.com/plainrows/yellowpages-au-scraper) · [Website Technology Checker](https://apify.com/plainrows/website-tech-stack) · [Website Email Extractor](https://apify.com/plainrows/website-email-extractor) · [Contact Details Scraper (Emails, Phones, Socials)](https://apify.com/plainrows/contact-details-scraper) · [ATS Jobs Scraper (Workday, Greenhouse, Lever, Ashby)](https://apify.com/plainrows/ats-job-postings) · [Workday Jobs Scraper](https://apify.com/plainrows/workday-jobs-scraper) · [Greenhouse Jobs Scraper](https://apify.com/plainrows/greenhouse-jobs-scraper) · [Lever Jobs Scraper](https://apify.com/plainrows/lever-jobs-scraper) · [Ashby Jobs Scraper](https://apify.com/plainrows/ashby-jobs-scraper) · [Google Jobs Scraper](https://apify.com/plainrows/google-jobs-scraper) · [Reed.co.uk Jobs Scraper (UK)](https://apify.com/plainrows/reed-jobs-scraper) · [jobs.ch & jobup.ch Jobs Scraper (Switzerland)](https://apify.com/plainrows/jobs-ch-scraper) · [Arbeitsagentur Jobs Scraper (Germany)](https://apify.com/plainrows/arbeitsagentur-jobs-scraper) · [Gupy Jobs Scraper (Brazil)](https://apify.com/plainrows/gupy-jobs-scraper) · [Catho Jobs Scraper (Brazil)](https://apify.com/plainrows/catho-jobs-scraper) · [Vagas.com.br Jobs Scraper (Brazil)](https://apify.com/plainrows/vagas-jobs-scraper) · [Jobs.cz Scraper (Czech Republic)](https://apify.com/plainrows/jobs-cz-scraper) · [Remote Jobs Scraper (Himalayas, RemoteOK, Jobicy)](https://apify.com/plainrows/remote-jobs-aggregator) · [Google Ads Scraper (Transparency Center)](https://apify.com/plainrows/google-ads-transparency) · [Company Registry Lookup (SIRENE, LEI, Brreg)](https://apify.com/plainrows/company-registry-lookup) · [Public Tenders Search (EU TED & UK)](https://apify.com/plainrows/public-tenders-search) - **E-commerce and travel:** [Amazon Product Search Scraper](https://apify.com/plainrows/amazon-product-search) · [Amazon Keyword Research (Search Volume & Reverse ASIN)](https://apify.com/plainrows/amazon-keyword-research) · [Google Shopping Prices Scraper](https://apify.com/plainrows/google-shopping-prices) · [Google Hotels Prices Scraper](https://apify.com/plainrows/google-hotels-prices) · [Google Hotels Scraper](https://apify.com/plainrows/google-hotels-scraper) · [Tripadvisor Reviews Scraper](https://apify.com/plainrows/tripadvisor-reviews) · [Trustpilot Reviews Scraper](https://apify.com/plainrows/trustpilot-reviews) - **Marketplaces and classifieds:** [Property Finder Scraper (UAE)](https://apify.com/plainrows/propertyfinder-scraper) · [Redfin Scraper (US Homes for Sale)](https://apify.com/plainrows/redfin-scraper) · [Otomoto Scraper (Polish Car Listings)](https://apify.com/plainrows/otomoto-scraper) · [Otodom Scraper (Poland Property)](https://apify.com/plainrows/otodom-scraper) · [Imovirtual Scraper (Portugal Property)](https://apify.com/plainrows/imovirtual-scraper) · [Standvirtual Scraper (Portugal Cars)](https://apify.com/plainrows/standvirtual-scraper) · [Immoweb Scraper (Belgium Property)](https://apify.com/plainrows/immoweb-scraper) · [Blocket Scraper (Sweden)](https://apify.com/plainrows/blocket-scraper) · [FINN.no Scraper (Norway)](https://apify.com/plainrows/finn-scraper) · [coches.net Scraper (Spain Cars)](https://apify.com/plainrows/coches-net-scraper) · [2dehands Scraper (Belgium)](https://apify.com/plainrows/2dehands-scraper) · [Storia Scraper (Romania Property)](https://apify.com/plainrows/storia-scraper) · [Autovit Scraper (Romania Cars)](https://apify.com/plainrows/autovit-scraper) · [FINN.no Car Scraper (Norway Cars)](https://apify.com/plainrows/finn-cars-scraper) · [DBA Scraper (Denmark)](https://apify.com/plainrows/dba-scraper) · [Tori.fi Scraper (Finland)](https://apify.com/plainrows/tori-scraper) - **Content and media:** [Google News Scraper](https://apify.com/plainrows/google-news-scraper) · [YouTube Search Scraper](https://apify.com/plainrows/youtube-search-scraper) · [YouTube Search API (JSON)](https://apify.com/plainrows/youtube-search-api) · [YouTube Comments Scraper](https://apify.com/plainrows/youtube-comments-scraper) · [Google Images Scraper](https://apify.com/plainrows/google-images-scraper) · [Website Screenshot API](https://apify.com/plainrows/website-screenshot) · [PDF to Markdown Converter (PDF to Text for AI & RAG)](https://apify.com/plainrows/pdf-to-markdown) · [Google Maps Reviews Scraper](https://apify.com/plainrows/google-maps-reviews) · [Google Reviews Scraper](https://apify.com/plainrows/google-reviews-scraper) · [App Store & Google Play Reviews Scraper](https://apify.com/plainrows/app-reviews-scraper) · [App Store & Google Play App Details Scraper](https://apify.com/plainrows/app-details-scraper) · [Google Play Reviews Scraper](https://apify.com/plainrows/google-play-reviews-scraper) · [App Store Reviews Scraper](https://apify.com/plainrows/app-store-reviews-scraper) **Compared with other APIs:** [Find businesses without a website](https://nadaho.github.io/plainrows/businesses-without-website-leads/) · [Read your competitors' 1-star Google reviews in bulk](https://nadaho.github.io/plainrows/competitor-negative-google-reviews/) · [Google Maps reviews API](https://nadaho.github.io/plainrows/google-maps-reviews-api/) · [Google Places API alternative](https://nadaho.github.io/plainrows/google-places-api-alternative/) ### Support Missing a field or found a bug? Open an issue on this page. Issues are read and answered. # Actor input Schema ## `searchQueries` (type: `array`): What you would type in Google Maps, one per line: "plumber in Austin", "coffee shop Berlin Mitte", "dentist 75011 Paris". Put the city or area in the query, or use Coordinates below. Up to 1,000 queries per run. ## `country` (type: `string`): Country used for the Google Maps search (ignored when Coordinates are set, except for the default language). ## `languageCode` (type: `string`): Two-letter language code, e.g. "en" or "fr". Leave empty to use the country's main language (for example German for Switzerland, French for Belgium). ## `maxPlacesPerQuery` (type: `integer`): Google Maps returns up to about 700 places per search. Each place returned is billed; see Pricing. ## `coordinates` (type: `string`): Center the search on "latitude,longitude", e.g. "40.7128,-74.0060". Useful to search a neighbourhood or a place without a city name in the query. ## `zoom` (type: `integer`): Map zoom level around the coordinates: 11 = whole city, 13 = district, 15 = a few streets. ## `minRating` (type: `number`): Keep only places rated at least this (0 = no filter). Filtered places are not billed. ## `website` (type: `string`): Filter on whether the business lists a website. Filtered places are not billed. ## `requirePhone` (type: `boolean`): Skip places that list no phone number. Filtered places are not billed. ## `contactDetails` (type: `boolean`): Also visit each place's website (homepage, and its contact or legal page when the homepage shows no e-mail) and return the e-mails, phone links and social profiles (Facebook, Instagram, LinkedIn, X, YouTube, TikTok) published there. Billed per website where something was found (once per run, even for a chain), as a separate 'Contact details found' event; places without a website and sites with nothing found are free. Adds a few seconds per place. ## Actor input object example ```json { "searchQueries": [ "coffee shop in Austin, TX" ], "country": "US", "maxPlacesPerQuery": 100, "zoom": 13, "minRating": 0, "website": "any", "requirePhone": false, "contactDetails": false } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (type: `string`): No description # 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 = { "searchQueries": [ "coffee shop in Austin, TX" ], "country": "US" }; // Run the Actor and wait for it to finish const run = await client.actor("plainrows/google-maps-businesses").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 = { "searchQueries": ["coffee shop in Austin, TX"], "country": "US", } # Run the Actor and wait for it to finish run = client.actor("plainrows/google-maps-businesses").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "coffee shop in Austin, TX" ], "country": "US" }' | apify call plainrows/google-maps-businesses --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,plainrows/google-maps-businesses" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/JbTcGVhCiwhphGoc9/builds/BzrDMYBAOcc8xja6U/openapi.json