# šŸ“©šŸ“ Google Maps Email Extractor (`lukaskrivka/google-maps-with-contact-details`) Actor Extract Google Maps contact details. Scrape websites of Google Maps places for contact details and get email addresses, website, location, address, zipcode, phone number, social media links. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools. - **URL**: https://apify.com/lukaskrivka/google-maps-with-contact-details.md - **Developed by:** [LukĆ”Å” Křivka](https://apify.com/lukaskrivka) (Apify) - **Categories:** Lead generation - **Stats:** 88,648 total users, 3,354 monthly users, 95.9% runs succeeded, 1,469 bookmarks - **User rating**: 4.63 out of 5 stars ## Pricing from $2.10 / 1,000 scraped 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? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** ā€” the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** ā€” [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** ā€” the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** ā€” the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** ā€” 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 ### What is Google Maps Email Extractor? **Google Maps Email Extractor**Ā is a web scraping tool that enables you to quicklyĀ **extract emails, social media, and other contact details from places on Google Maps**. - Find contact details by **URL, placeID, category, keyword, location, or coordinates** - Get information like emails, but also **social media accounts, phone numbers, website, and physical address** - Social media includes **LinkedIn, Twitter, YouTube, TikTok, Facebook, Instagram, Pinterest, and Discord** - Show results in **tables or in map view** - Get over theĀ [limitation of Google Maps](https://blog.apify.com/google-places-api-limits/#%E2%9B%94-what-are-google-maps-limitations-for-scraping)Ā of displaying (and scraping) no more than 120 places per area - Pre-filter Google Maps placesĀ **by rating**, for example scrape only places that areĀ **3 stars and higher** - Choose to **skip places** that are temporarily or permanentlyĀ **closed** - Get aĀ **visualized map**Ā of scraped places - Set up theĀ **language**Ā of Google Maps scraping, so you can get Spanish-language Google Maps results, for example - UseĀ **API in Python and Node.js**, API Endpoints, integrations with other apps, and webhooks - Export Google Maps dataĀ in **Excel, CSV, JSON, and HTML** We recommend trying out [Google Maps Scraper](https://apify.com/compass/crawler-google-places), as well, since it extracts even more than Google Maps Email Extractor can. Itā€™s also faster, while costing less. ### **What data can this Google Maps Email Extractor extract?**
šŸ“Œ Place name šŸ”— Place URL šŸŒ Website
šŸ“± Social media šŸ“§ Email addresses šŸ“ž Phone numbers
šŸ“ Full address šŸŒ Geolocation (coordinates) šŸ–¼ļø Featured image URL
šŸ“ Reservation URL šŸ’¬ Number of reviews šŸ“ø Number of images
šŸ’° Price and price category ā­ Rating (total score) ā° Opening hours
šŸ½ļø Service options šŸ» Place categories šŸŽ· Highlights
ā™æ Accessibility šŸ’³ Payment types āœļø Place description
With optional add-ons, you can also extract: - **Business leads** - employee names, job titles, work emails, LinkedIn profiles - **Enriched social media profiles** - follower counts, verification status, profile details - **Additional place details** - opening hours, popular times, Q\&A, and more To scrape all data from Google Places, including reviews and images, try the original [Google Maps Scraper](https://apify.com/compass/crawler-google-places). ### How much does Google Places email scraping cost? This scraper uses a **Pay-Per-Event (PPE)** pricing model. You are charged based on the specific data you extract: - **Base cost per place scraped** - each place found on Google Maps incurs a small fee. - **Add-on: Company contacts enrichment** is enabled by default - emails, phone numbers, and social media links are automatically extracted from business websites with no additional configuration required. - **Optional add-ons** (charged only when enabled): - **Additional place details** - opening hours, popular times, Q\&A, and more - **Social media profile enrichment** - follower counts, verification status, and profile details for Facebook, Instagram, YouTube, TikTok, and X (Twitter) - **Business leads enrichment** - employee names, job titles, work emails, LinkedIn profiles, and company data - **Email verification** - verify the deliverability of business lead emails; charged only for decisive results (valid, invalid, or disposable) - **Search filters** - filter by rating, website presence, name matching, or closed status Significant discounts are available on higher-tier plans. Please see the [Pricing tab](https://apify.com/lukaskrivka/google-maps-with-contact-details/pricing) for your exact rate based on your subscription. [Google Maps Scraper](https://apify.com/compass/crawler-google-places) offers the same add-ons plus reviews and images scraping. ### How do I use Google Maps Email Extractor? This Google Maps Email Extractor was designed for an easy start, even if you've never extracted contact detail data from the web before. If you want more guidance on how to use Google Maps Email Extractor, thisĀ video tutorialĀ shows you how to do it in just a few minutes. https://www.youtube.com/watch?v=69v8PtWilpI ### ā¬‡ļø Input The input for Google Maps Email Extractor should beĀ **either a Google Maps URL or a location in combination with a search term.**Ā You can provide keywords, URLs, and categories either one by one or in bulk. You can provide the location as a simple city name, a full postal address, or as a polygon consisting of multiple coordinates. You can just set the whole country as the location: Google Maps Email Extractor intelligently splits it into subregions internally, so there's no need to search city by city or neighborhood by neighborhood yourself. Here's a simple input example of scraping email addresses from 50 bars in Boston: ```json { "language": "en", "locationQuery": "Boston, USA", "maxCrawledPlacesPerSearch": 50, "searchStringsArray": ["bar"], "skipClosedPlaces": false } ``` Click on theĀ [input tab](https://apify.com/lukaskrivka/google-maps-with-contact-details/input-schema)Ā for a full explanation of input in JSON. #### Search terms Using multiple similar search terms can increase the number of scraped places, but it also increases the time a run takes. We recommend using a combination of search terms that are distinct or overlap only slightly in meaning. Using a long list of duplicate search terms will just increase the time of a run without providing more results. Example of a good list of search terms: \[`restaurant`,Ā `bar`,Ā `pub`,Ā `cafe`,Ā `buffet`,Ā `ice cream`,Ā `tea house`] Example of a bad list of search terms: \[`restaurant`,Ā `restaurants`,Ā `chinese restaurant`,Ā `cafe`,Ā `coffee`,Ā `coffee shop`,Ā `takeout`] Google search results often include categories adjacent to your search, e.g.Ā `restaurant`Ā might also capture someĀ `cafe`Ā orĀ `bar`Ā places, but you will get better results if you use them as separate search terms, as well. #### Categories **Using categories can be dangerous!** Search terms can introduce false positives, extracting some irrelevant places. Categories can be used to narrow down the results to just the ones you select. Categories can also be dangerous because they can cause false negatives, excluding places you might want in the results. Google has thousands of categories, and many are synonymous. You must list all the categories you want to match, including all synonyms; for example, `Divorce lawyer`, `Divorce service`, and `Divorce attorney` are three distinct categories. Some places might be classified as only one of them, meaning you should input all of them. For this reason, we recommend going through the categories list carefully. For some use cases, you might want to select as many as 100 categories to ensure you don't miss any relevant places. To help with this, Google Maps Email Extractor tries to increase the chance of a match by doing the following: - If any category of a place (each can have several categories) matches any category from your input, it will be included. - If all words from your input are contained in a category name, it will be included. E.g.Ā `restaurant`Ā will matchĀ `Chinese restaurant`Ā andĀ `Pan Asian restaurant`. > āš ļø If categories are usedĀ without search terms, they will be used both as search terms and as category filters. However, for the above reasons, using categories without search terms isĀ not recommended. We generally recommend using fewer search terms and more categories. #### Search without geolocation Rather than using the standard search term and location inputs, you may also opt to use only the search term (e.g. "restaurants in Berlin") or a direct Google Maps search URL (e.g.Ā ) without the location input field. However,Ā **this approach will limit the number of results to a maximum of 120**Ā because it only opens a single map screen on Google with a finite scroll. We only recommend skipping location input if you don't need more than 120 results, you need the lowest possible latency, or you want to get the results in the same order as Google would provide. ### ā¬†ļø Output example The results will be wrapped into a dataset found in theĀ **Output**Ā orĀ **Storage**Ā tab. Note that the output is organized in tables and tabs for your convenience. You can view results as a table, JSON, or as a map. Once the run is finished, you can also download the dataset in various data formats (JSON, CSV, Excel, XML, HTML). Before exporting, you can pick or omit specific output fields; alternatively, you can also choose to download the whole view, which includes thematically connected data. #### Table view The table view can be manipulated in different ways. There is a general overview, but you can also sort the table by contact info, location rating, reviews, or other fields. Here's what it looks like to scrape over 1,000 bars in Boston: Google Maps Extractor output #### JSON file Here's the amount of data you'd get for a single scraped place: **Contact details** ```json [ { "emails": ["development_sites@dunkinbrands.com"], "phones": ["+18138841600"], "phonesUncertain": [ "(813) 884-1600", "800-777-9983", "800-447-0013", "(800) 447-0013", "800-859-5339", "781-737-3000", "678-514-4100", "4941715" ], "linkedIns": ["https://www.linkedin.com/company/dunkin"], "twitters": ["https://twitter.com/dunkindonuts"], "instagrams": ["https://www.instagram.com/dunkin/"], "facebooks": ["https://www.facebook.com/DunkinUS/"], "youtubes": ["https://www.youtube.com/user/dunkindonuts"], "tiktoks": [], "pinterests": ["https://www.pinterest.com/DunkinDonuts/"], "discords": [] } ] ``` **Place details** ```json "rank": 7, "title": "Dunkin'", "description": "Long-running chain serving signature breakfast items & a variety of coffee drinks.", "price": "$1\u201310", "categoryName": "Coffee shop", "address": "4325 W Hillsborough Ave, Tampa, FL 33614", "neighborhood": "Pinecrest West Park", "street": "4325 W Hillsborough Ave", "city": "Tampa", "postalCode": "33614", "state": "Florida", "countryCode": "US", "website": "https://locations.dunkindonuts.com/en/fl/tampa/4325-hillsborough-plz/337999?utm_source=google&utm_medium=local&utm_campaign=localmaps&utm_content=337999&y_source=1_MTIxMDcxODQtNzE1LWxvY2F0aW9uLndlYnNpdGU%3D", "phone": "(813) 884-1600", "phoneUnformatted": "+18138841600", "claimThisBusiness": false, "location": { "lat": 27.9966569, "lng": -82.5165572 }, "totalScore": 3.3, "permanentlyClosed": false, "temporarilyClosed": false, "placeId": "ChIJj0uggtTDwogRV0Q_FH8LfxQ", "categories": [ "Coffee shop", "Bagel shop", "Bakery", "Breakfast restaurant", "Donut shop", "Fast food restaurant", "Takeout Restaurant" ``` **Opening hours** ```json "openingHours": [ { "day": "Monday", "hours": "4\u202fAM to 7\u202fPM" }, { "day": "Tuesday", "hours": "4\u202fAM to 7\u202fPM" }, { "day": "Wednesday", "hours": "4\u202fAM to 7\u202fPM" }, { "day": "Thursday", "hours": "4\u202fAM to 7\u202fPM" }, { "day": "Friday", "hours": "4\u202fAM to 7\u202fPM" }, { "day": "Saturday", "hours": "4\u202fAM to 7\u202fPM" }, { "day": "Sunday", "hours": "4\u202fAM to 7\u202fPM" } ], "additionalOpeningHours": { "Delivery": [ { "day": "Monday", "hours": "4\u202fAM\u20137\u202fPM" }, { "day": "Tuesday", "hours": "4\u202fAM\u20137\u202fPM" }, { "day": "Wednesday", "hours": "4\u202fAM\u20137\u202fPM" }, { "day": "Thursday", "hours": "4\u202fAM\u20137\u202fPM" }, { "day": "Friday", "hours": "4\u202fAM\u20137\u202fPM" }, { "day": "Saturday", "hours": "4\u202fAM\u20137\u202fPM" }, { "day": "Sunday", "hours": "4\u202fAM\u20137\u202fPM" } ] }, "wasOpenAtScrapeTime": true, ``` **Additional place details** ```json { "Quick bite": true } ], "Dining options": [ { "Breakfast": true }, { "Brunch": true }, { "Lunch": true }, { "Dinner": true }, { "Dessert": true }, { "Seating": true } ], "Amenities": [ { "Restroom": true }, { "Wi-Fi": true }, { "Free Wi-Fi": true } ], "Atmosphere": [ { "Casual": true }, { "Trendy": true } ], "Crowd": [ { "College students": true }, { "Family-friendly": true }, { "Groups": true }, { "Tourists": true } ], "Planning": [ { "Accepts reservations": false } ], "Payments": [ { "Credit cards": true }, { "Debit cards": true }, { "NFC mobile payments": true }, { "Credit cards": true } ], "Children": [ { "Good for kids": true }, { "High chairs": true } ] ``` **āœ… Add-on: Email verification** When `verifyLeadsEnrichmentEmails` is enabled, each lead's email address is verified and an `emailVerification` object is added to the lead output. Requires Business leads enrichment to be active. **Charged (decisive results):** - `ok` - Valid, deliverable email address - `invalid` - Invalid or non-existent email address - `disposable` - Disposable or temporary email address **Not charged:** - `catch_all` - The domain accepts all addresses; individual deliverability cannot be confirmed - `unknown` - Verification result could not be determined - `error` - Verification encountered a technical error ```json { "email": "james.hill@apify.com", "quality": "good", "result": "ok", "subResult": "accepted_email", "free": false, "role": false, "error": "" } ``` #### Map view Google Maps Email Extractor provides a zoomable map that shows all the places scraped. The map is shown in theĀ `Live View`Ā tab on the Actor run page and also stored in the Key-Value Store asĀ `results-map.html`Ā record. Google Maps Extractor map ### Want to scrape Google Maps reviews or images? For more comprehensive Google Maps data, we recommend using [Google Maps Scraper](https://apify.com/compass/crawler-google-places). It uses the same input options, but has a lot more options and is able to extract many more different types of data. For more specific use cases, we recommend the following: - [Google Maps Reviews Scraper](https://apify.com/compass/google-maps-reviews-scraper), which focuses on Google Maps reviews - [AI Text Analyzer for Google Reviews](https://apify.com/geneea-analytics/reviews-text-nlp-analyzer), which can help you figure out keywords from review batches - [Google Maps Scraper Orchestrator](https://apify.com/lukaskrivka/google-maps-scraper-orchestrator), which lets you run multiple Google Maps Scraper instances concurrently - [Competitive Intelligence AI Agent](https://apify.com/apify/competitive-intelligence-agent), which can figure out competitorsā€™ strengths and weaknesses - [Market Expansion AI Agent](https://apify.com/apify/market-expansion-agent), which can help you determine where best to expand to ### Frequently asked questions #### How can I extract Google Maps email addresses by coordinates? If you want to customize your location for a specific area, you can use this tool's **Custom search area**Ā option. Youā€™ll have to provide coordinate pairs for an area and the scraper will create start URLs out of them. There are several types of search area geometry that you can use in Google Maps Email Extractor:Ā [Polygon, MultiPolygon, and Point (Circle)](https://blog.apify.com/google-maps-how-to-overcome-google-api-limit-120-places/#%F0%9F%93%A1-level-4-custom-geolocation-in-google-maps-boss-level). Weā€™ve found the polygons and circle to be the most useful ones when it comes to extracting data from Google Maps. #### Can I integrate Google Maps Email Extractor with other apps? Yes. The Google Maps Email Extractor can be connected with almost any cloud service or web app thanks toĀ [**integrations**](https://apify.com/integrations)Ā on the Apify platform. You canĀ **integrate your Google Maps data with Zapier, Slack, Make, Airbyte, GitHub, Google Sheets, Asana, LangChain,**Ā and more. You can also useĀ [**webhooks**](https://docs.apify.com/integrations/webhooks)Ā to carry out an action whenever an event occurs, for example, get a notification whenever Google Maps Email Extractor successfully finishes a run. #### Can I use Google Maps Email Extractor as its own API? Yes, you can use the Apify API to access Google Maps Email Extractor programmatically. The API allows you to manage, schedule, and run Apify Actors, access datasets, monitor performance, get results, create and update Actor versions, and more. To access the API using Node.js, you can use theĀ `apify-client`Ā [NPM package](https://apify.com/lukaskrivka/google-maps-with-contact-details/api/javascript). To access the API using Python, you can use theĀ `apify-client`Ā [PyPI package](https://apify.com/lukaskrivka/google-maps-with-contact-details/api/python). For detailed information and code examples, see theĀ [**API tab**](https://apify.com/lukaskrivka/google-maps-with-contact-details/api/python)Ā or refer to theĀ [**Apify API documentation**](https://docs.apify.com/api/v2). #### Is it legal to scrape Google Maps data? Web scraping is legal if you are extracting publicly available data, which is most data on Google Maps. However, you shouldĀ **respect boundaries such as personal data**Ā and intellectual property regulations. You should only scrape personal data if you have a legitimate reason to do so, and you should also factor in Google'sĀ [Terms of Use](https://policies.google.com/terms?hl=en). #### Your feedback Weā€™re always working on improving the performance of Apifyā€™s Actors. So if youā€™ve got any technical feedback for Google Maps Email Extractor or simply found a bug, please create an issue on the Actorā€™sĀ [Issues tab](https://apify.com/lukaskrivka/google-maps-with-contact-details/issues/open). # Actor input Schema ## `searchStringsArray` (type: `array`): Type what you'd normally search for in the Google Maps search bar, like English breakfast or pet shelter. Aim for unique terms for faster processing. Using similar terms (e.g., bar vs. restaurant vs. cafe) may slightly increase your capture rate but is less efficient.

āš ļø Searching for a specific place? If you're looking for a particular business or location (e.g., M\&M Indian Thai Halal Restaurant), make sure to also specify the city or country in the šŸ“ Location field below to get more accurate and reliable results. Without location context, Google Maps may return results from unexpected areas.

āš ļø Heads up: Adding a location directly to the search, e.g., restaurant Pittsburgh, can limit you to a maximum of 120 results per search term due to Google Maps' scrolling limit.

You can also use direct place IDs here in the format place\_id:ChIJ8\_JBApXMDUcRDzXcYUPTGUY. See the [detailed description](https://apify.com/compass/crawler-google-places#search-terms). ## `locationQuery` (type: `string`): Define location using free text. Simpler formats work best; e.g., use City + Country rather than City + Country + State.

šŸŒ You can just set the whole country or state as the location: Google Maps Email Extractor intelligently splits it into subregions internally, so there's no need to search city by city or neighborhood by neighborhood yourself.

Verify with the OpenStreetMap webapp for visual validation of the exact area you want to cover.

šŸ’” Pro tip: Always specify a location when searching for specific place names in the šŸ” Search terms field above. This helps narrow down results to the geographic area you're interested in and prevents getting results from unrelated locations.

āš ļø Automatically defined City polygons may be smaller than expected (e.g., they don't include agglomeration areas). If you need to define the whole city area, head over to the šŸ“” Geolocation parameters\* section instead to select Country, State, County, City, or Postal code.
For an even more precise location definition (especially when using City name as a starting point), head over to šŸ›° Custom search area section to create polygon shapes of the areas you want to scrape. Note that šŸ“ Location settings always take priority over šŸ“” Geolocation\* (so use either section but not both at the same time).

For guidance and tricks on location definition, check the Apify tutorial. ## `maxCrawledPlacesPerSearch` (type: `integer`): Number of results you expect to get per each Search term, Category or URL. The higher the number, the longer it will take.

If you want to scrape all the places available, leave this field empty. ## `language` (type: `string`): Results will be scraped in this language. ## `categoryFilterWords` (type: `array`): You can limit the places that are scraped based on the Category filter; you can choose as many categories for one flat fee for the whole field. āš ļø Using categories can sometimes lead to false negatives, as many places do not properly categorize themselves, and there are over 4,000 available categories which Google Maps has. Using categories might filter out places that youā€™d like to scrape. To avoid this problem, you must list all categories that you want to scrape, including synonyms, e.g., divorce lawyer, divorce attorney, divorce service, etc. See the [detailed description](https://apify.com/compass/crawler-google-places#categories). ## `searchMatching` (type: `string`): Restrict what places are scraped based on matching their name with provided šŸ” Search term. E.g., all places that have chicken in their name vs. places called Kentucky Fried Chicken. ## `placeMinimumStars` (type: `string`): Scrape only places with a rating equal to or above the selected stars. Places without reviews will also be skipped. Keep in mind, filtering by reviews reduces the number of places found per credit spent, as many will be excluded. ## `website` (type: `string`): Use this to exclude places without a website, or vice versa. This option is turned off by default. ## `skipClosedPlaces` (type: `boolean`): Skip places that are marked as temporary or permanently closed. Ideal for focusing on currently open places. ## `scrapePlaceDetailPage` (type: `boolean`): Scrape detail pages of each place the Actor finds. This will slow down the Actor since it needs to open another page for each place individually.

The fields available only when scrapePlaceDetailPage is enabled include: `reviewsDistribution`, `reviewsRemovedNotice`, `imageCategories`, popularTimes fields, `openingHours`, `BusinessConfirmationText`, `peopleAlsoSearch`, `reviewsTags`, `updatesFromCustomers`, `questionsAndAnswers`, `tableReservationLinks`, `ownerUpdates` and hotel fields.

Enabling this also ensures that `reviewsCount` will be scraped.

This option needs to be enabled if you wish to use any of the options below. ## `scrapeTableReservationProvider` (type: `boolean`): Scrape table reservation provider data like name, address, email or phone. This data is present only in restaurants that have a blue "RESERVE A TABLE" button. ## `scrapeOrderOnline` (type: `boolean`): Scrape the 'Order online' section of restaurants to get pickup and delivery providers (Uber Eats, DoorDash, etc.), along with fees and estimated times. ## `includeWebResults` (type: `boolean`): Extract the "Web results" section located at the bottom of every place listing. ## `scrapeDirectories` (type: `boolean`): Some places (e.g. malls) can have multiple businesses located inside them. This option will scrape inside the "Directory" or "At this place" as per different categories (example here). Turn this toggle on to include those places in your results.

āš ļø Note that full place details need to be scraped in order to scrape directories. ## `maxQuestions` (type: `integer`): Set the number of questions per place you expect to scrape. If you fill in 0 or leave the field empty, only the first question and answer will be scraped. To extract all questions, type 999 into the field.

āš ļø Note that some of the fields contain personal data. ## `scrapeSocialMediaProfiles` (type: `object`): Enable enrichment for any social media profiles found. This add-on retrieves detailed public data for each profile, including profile names, follower/following counts, descriptions, post/video counts, and verification status.

You are charged a flat rate for the total number of profiles enriched, regardless of how many platforms (Facebook, YouTube, etc.) you select.
Feature dependency:
To use this feature, the Company contacts enrichment (from website) add-on is enabled automatically. This ensures the enriched social media data is combined with the main contact record for each domain.

Output: Enriched profiles are available in the Social profiles output view tab. ## `maximumLeadsEnrichmentRecords` (type: `integer`): Enrich your results with detailed contact and company information, including employee names, job titles, emails, phone numbers, LinkedIn profiles, and key company data like industry and number of employees.

This setting allows you to set the maximum number of leads records you want to scrape per each place found on the map (that has a website). By default, it's set to 0 which means that no leads information will be scraped.

āš ļø Note that some of the fields contain personal data. GDPR protects personal data in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your use case is legitimate, please consult an attorney.

We exclude leads of big chains as these are not related to the local places: mcdonalds, starbucks, dominos, pizzahut, burgerking, kfc, subway, wendys, dunkindonuts, tacobell. ## `leadsEnrichmentDepartments` (type: `array`): You can use this filter to include only specific departments (like Sales, Marketing, or C-Suite). Note: This will only work if the ā© Add-on: Extract business leads information - Maximum leads per place (maximumLeadsEnrichmentRecords) option is enabled. Please note that some job titles are sometimes miscategorized in the wrong departments. ## `verifyLeadsEnrichmentEmails` (type: `boolean`): When enabled, verifies the email address of each lead extracted during business leads enrichment. Each lead receives an emailVerification object with the verification result and quality assessment.

Charged (decisive results): valid (ok), invalid, and disposable email addresses.
Not charged: catch-all, unknown, and error results.

āš ļø This add-on requires business leads enrichment to be enabled. ## `countryCode` (type: `string`): Set the country, e.g., United States. ## `city` (type: `string`): Enter the city, e.g., Pittsburgh.

āš ļø Do not include State or Country names here.

āš ļø Automatic City polygons may be smaller than expected (e.g., they don't include agglomeration areas). ## `state` (type: `string`): Set a state, e.g., Massachusetts (mainly for the US addresses). ## `county` (type: `string`): Set the county, e.g., New York County.

āš ļø Note that county may represent different administrative areas in different countries: a county (e.g., US), regional district (e.g., Canada) or dĆ©partement (e.g., France). ## `postalCode` (type: `string`): Set the postal code, e.g., 10001.

āš ļø Combine Postal code only with šŸ—ŗ Country, never with šŸŒ‡ City. You can only input one postal code at a time. ## `customGeolocation` (type: `object`): Use this field to define the exact search area if other search area parameters don't work for you. See readme or the Apify guide for details. ## `startUrls` (type: `array`): Max 300 results per search URL. Valid format for URLs contains https://google.com/maps/. This feature also supports uncommon URL formats such as: https://google.com/maps?cid=***, https://goo.gl/maps/***, and custom place list URL. ## Actor input object example ```json { "searchStringsArray": [ "restaurant" ], "locationQuery": "New York, USA", "maxCrawledPlacesPerSearch": 50, "language": "en", "categoryFilterWords": [ "pizza", "italian" ], "searchMatching": "all", "placeMinimumStars": "", "website": "allPlaces", "skipClosedPlaces": false, "scrapePlaceDetailPage": false, "scrapeTableReservationProvider": false, "scrapeOrderOnline": false, "includeWebResults": false, "scrapeDirectories": false, "maxQuestions": 0, "scrapeSocialMediaProfiles": { "facebooks": false, "instagrams": false, "youtubes": false, "tiktoks": false, "twitters": false }, "maximumLeadsEnrichmentRecords": 0, "leadsEnrichmentDepartments": [ "sales", "marketing" ], "verifyLeadsEnrichmentEmails": false, "countryCode": "US", "city": "New York", "state": "New York", "county": "New York County", "postalCode": "10001", "customGeolocation": { "type": "Point", "coordinates": [ -73.9857, 40.7484 ] }, "startUrls": [ { "url": "https://www.google.com/maps/place/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB" } ] } ``` # Actor output Schema ## `dataset` (type: `string`): Dataset containing all scraped places with contact details ## `resultsMap` (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 = { "searchStringsArray": [ "restaurant" ], "locationQuery": "New York, USA", "maxCrawledPlacesPerSearch": 50, "language": "en", "scrapeSocialMediaProfiles": { "facebooks": false, "instagrams": false, "youtubes": false, "tiktoks": false, "twitters": false }, "maximumLeadsEnrichmentRecords": 0 }; // Run the Actor and wait for it to finish const run = await client.actor("lukaskrivka/google-maps-with-contact-details").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 = { "searchStringsArray": ["restaurant"], "locationQuery": "New York, USA", "maxCrawledPlacesPerSearch": 50, "language": "en", "scrapeSocialMediaProfiles": { "facebooks": False, "instagrams": False, "youtubes": False, "tiktoks": False, "twitters": False, }, "maximumLeadsEnrichmentRecords": 0, } # Run the Actor and wait for it to finish run = client.actor("lukaskrivka/google-maps-with-contact-details").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 '{ "searchStringsArray": [ "restaurant" ], "locationQuery": "New York, USA", "maxCrawledPlacesPerSearch": 50, "language": "en", "scrapeSocialMediaProfiles": { "facebooks": false, "instagrams": false, "youtubes": false, "tiktoks": false, "twitters": false }, "maximumLeadsEnrichmentRecords": 0 }' | apify call lukaskrivka/google-maps-with-contact-details --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,lukaskrivka/google-maps-with-contact-details" } } } ``` 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/WnMxbsRLNbPeYL6ge/builds/v6MO4RSbKg0wMu3Dx/openapi.json