Google Places API Python Client
Extract Google Places data with our Google Places API Python client. Get programmatic access to phone numbers, opening hours, business names, websites, review counts, addresses, ratings, and more using simple Python code. Start free, no credit card required.
Trusted by industry leaders all over the world
Integrate our Google Places API
The Apify API client for Python is the official library that allows you to use Google Places API in Python, providing convenience functions and automatic retries on errors. Get started with simple pip installation and robust error handling built-in.
Python
JavaScript
HTTP
MCP
1from apify_client import ApifyClient2
3# Initialize the ApifyClient with your Apify API token4# Replace '<YOUR_API_TOKEN>' with your token.5client = ApifyClient("<YOUR_API_TOKEN>")6
7# Prepare the Actor input8run_input = {9 "searchStringsArray": ["restaurant"],10 "locationQuery": "New York, USA",11 "maxCrawledPlacesPerSearch": 50,12 "language": "en",13 "maximumLeadsEnrichmentRecords": 0,14 "maxImages": 0,15}16
17# Run the Actor and wait for it to finish18run = client.actor("compass/crawler-google-places").call(run_input=run_input)19
20# Fetch and print Actor results from the run's dataset (if there are any)21print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])22for item in client.dataset(run["defaultDatasetId"]).iterate_items():23 print(item)24
25# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-startGet data with Google Places API Python client
Use our Python API client to extract Google Maps business data by providing search terms, locations, or direct URLs. The API returns structured data, including contact details, ratings, reviews, coordinates, categories, opening hours, and 50+ other data points per business in JSON format.
Input
{ "website": "allPlaces", "language": "en", "maxReviews": 0, "reviewsSort": "newest", "maxQuestions": 0, "locationQuery": "New York, USA", "reviewsOrigin": "all", "scrapeContacts": false, "searchMatching": "all", "skipClosedPlaces": false, "includeWebResults": false, "placeMinimumStars": "", "scrapeDirectories": false, "scrapeImageAuthors": false, "searchStringsArray": [ "restaurant" ], "reviewsFilterString": "", "scrapePlaceDetailPage": false, "allPlacesNoSearchAction": "", "maxCrawledPlacesPerSearch": 50, "scrapeReviewsPersonalData": true, "maximumLeadsEnrichmentRecords": 0, "scrapeTableReservationProvider": false}Output
{ "cid": "7838756667406262025", "fid": "0x89c3ca9c11f90c25:0x6cc8dba851799f09", "url": "<https://www.google.com/maps/search/?api=1&query=Kim's%20Island&query_place_id=ChIJJQz5EZzKw4kRCZ95UajbyGw>", "city": "Staten Island", "menu": "<http://kimsislandsi.com/>", "rank": null, "kgmid": "/g/1tmgdcj8", "phone": "(718) 356-5168", "price": "$10–20", "state": "New York", "title": "Kim's Island", "images": [ { "imageUrl": "<https://lh5.googleusercontent.com/p/AF1QipMyThXuZMjeiMZfTM42rbJJGm-q54JNzL3xsCn_=w1920-h1080-k-no>", "authorUrl": "<https://maps.google.com/maps/contrib/103237729589375373179>", "authorName": "Sebastian Sinisterra (CitySeby)", "uploadedAt": "2017-05-30T00:00:00.000Z" } ], "street": "175 Main St", "address": "175 Main St, Staten Island, NY 10307", "orderBy": [ { "name": "kimsislandsi.com", "orderUrl": "<http://kimsislandsi.com/>" } ], "placeId": "ChIJJQz5EZzKw4kRCZ95UajbyGw", "reviews": [ { "name": "Rocco Castellano", "text": "Excellent food great service n always on time", "stars": 5, "rating": null, "reviewId": "ChdDSUhNMG9nS0VJQ0FnSURuNV9DVnFRRRAB", "publishAt": "a month ago", "reviewUrl": "<https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSURuNV9DVnFRRRAB!2m1!1s0x0:0x6cc8dba851799f09!3m1!1s2@1:CIHM0ogKEICAgIDn5_CVqQE%7CCgwInvyhuAYQyOjhgwI%7C?hl=en>", "likesCount": 0, "reviewerId": "108813127648936384314", "reviewerUrl": "<https://www.google.com/maps/contrib/108813127648936384314?hl=en>", "isLocalGuide": true, "reviewOrigin": "Google", "reviewContext": {}, "textTranslated": null, "publishedAtDate": "2024-10-11T01:23:42.544Z", "reviewImageUrls": [], "reviewerPhotoUrl": "<https://lh3.googleusercontent.com/a-/ALV-UjXRb3lzFb-4SdRMWMlaaECCmdFwULv7bvKKVOK-3mmDcBWyJnY3XQ=s120-c-rp-mo-ba4-br100>", "reviewDetailedRating": { "Food": 5, "Service": 5, "Atmosphere": 5 }, "responseFromOwnerDate": null, "responseFromOwnerText": null, "reviewerNumberOfReviews": 74 } ], "website": "<http://kimsislandsi.com/>", "hotelAds": [], "imageUrl": "<https://lh5.googleusercontent.com/p/AF1QipMyThXuZMjeiMZfTM42rbJJGm-q54JNzL3xsCn_=w408-h306-k-no>", "location": { "lat": 40.5107736, "lng": -74.2482624 }, "plusCode": "GQ62+8M Staten Island, New York", "subTitle": null, "gasPrices": [], "imageUrls": [ "<https://lh5.googleusercontent.com/p/AF1QipMyThXuZMjeiMZfTM42rbJJGm-q54JNzL3xsCn_=w1920-h1080-k-no>" ], "locatedIn": null, "scrapedAt": "2024-11-28T12:28:50.519Z", "categories": [ "Chinese restaurant", "Delivery Restaurant" ], "hotelStars": null, "placesTags": [], "postalCode": "10307", "totalScore": 4.5, "webResults": [], "checkInDate": null, "countryCode": "US", "description": null, "imagesCount": 28, "reviewsTags": [ { "count": 6, "title": "prices" }, { "count": 4, "title": "delivery" }, { "count": 3, "title": "spareribs" }, { "count": 2, "title": "dumpling" }, { "count": 2, "title": "lo mein" } ], "bookingLinks": [], "categoryName": "Chinese restaurant", "checkOutDate": null, "neighborhood": "Tottenville", "openingHours": [ { "day": "Monday", "hours": "Closed" }, { "day": "Tuesday", "hours": "11 AM to 9:30 PM" }, { "day": "Wednesday", "hours": "11 AM to 9:30 PM" }, { "day": "Thursday", "hours": "11 AM to 12 AM" }, { "day": "Friday", "hours": "12 to 9:30 AM, 11 AM to 10:30 PM" }, { "day": "Saturday", "hours": "11 AM to 10:30 PM" }, { "day": "Sunday", "hours": "12 to 9:30 PM" } ], "ownerUpdates": [], "reviewsCount": 91, "searchString": "Direct Detail URL: <https://www.google.com/maps/place/Kim's+Island/@40.5107736,-74.2482624,17z/data=!4m6!3m5!1s0x89c3ca9c11f90c25:0x6cc8dba851799f09!8m2!3d40.5107736!4d-74.2482624!16s%2Fg%2F1tmgdcj8?hl=en&entry=ttu>", "googleFoodUrl": null, "searchPageUrl": null, "userPlaceNote": null, "additionalInfo": { "Children": [ { "Good for kids": true } ], "Payments": [ { "Credit cards": true }, { "Debit cards": true }, { "NFC mobile payments": true }, { "Credit cards": true } ], "Planning": [ { "Accepts reservations": false } ], "Amenities": [ { "Restroom": false } ], "Offerings": [ { "Comfort food": true }, { "Healthy options": true }, { "Quick bite": true }, { "Small plates": true } ], "Atmosphere": [ { "Casual": true } ], "Popular for": [ { "Lunch": true }, { "Dinner": true }, { "Solo dining": true } ], "Accessibility": [ { "Wheelchair accessible entrance": true }, { "Wheelchair accessible seating": true }, { "Assistive hearing loop": false }, { "Wheelchair accessible parking lot": false }, { "Wheelchair accessible restroom": false } ], "Dining options": [ { "Lunch": true }, { "Dinner": true } ], "Service options": [ { "Takeout": true }, { "Dine-in": true } ] }, "parentPlaceUrl": null, "restaurantData": {}, "imageCategories": [ "All", "Menu", "Food & drink", "Vibe", "By owner", "Street View & 360°" ], "isAdvertisement": false, "reserveTableUrl": null, "hotelDescription": null, "peopleAlsoSearch": [ { "title": "Island Kitchen Chinese", "category": "People also search for", "totalScore": 3.4, "reviewsCount": 70 }, { "title": "New Island", "category": "People also search for", "totalScore": 3.9, "reviewsCount": 116 }, { "title": "Islander Taste Chinese Restaurant", "category": "People also search for", "totalScore": 4.2, "reviewsCount": 119 }, { "title": "Kum Fung", "category": "People also search for", "totalScore": 3.8, "reviewsCount": 168 } ], "phoneUnformatted": "+17183565168", "claimThisBusiness": false, "permanentlyClosed": false, "temporarilyClosed": false, "hotelReviewSummary": null, "questionsAndAnswers": [], "reviewsDistribution": { "oneStar": 4, "twoStar": 3, "fiveStar": 71, "fourStar": 10, "threeStar": 3 }, "searchPageLoadedUrl": null, "similarHotelsNearby": null, "updatesFromCustomers": null, "tableReservationLinks": []}Sign up for Apify account01
Creating an account is quick and free — no credit card required. Your account gives you access to more than 5,000 scrapers and APIs.
Install Apify Python client02
Install the Apify Python client using pip: pip install apify-client. This package provides a simple interface to interact with Google Places API from your Python applications.
Get your Apify API token03
Go to settings in the Apify console and navigate to the “API & Integrations” tab. There, create a new token and save it for later.
Integrate Google Places API04
Navigate to the Google Places API page and click on the API dropdown menu in the top right corner. In the dropdown menu, you can see API clients, API endpoints, and more. Use the provided Python code examples to integrate Google Places API into your Python application.
Get your Google Places data via API05
The Google Places API returns structured JSON data that works perfectly with pandas, NumPy, and other Python data analysis libraries.
Why use Apify?
Never get blocked
Every plan (free included) comes with Apify Proxy, which is great for avoiding blocking and giving you access to geo-specific content.
Customers love us
We truly care about the satisfaction of our users and thanks to that we're one of the best-rated data extraction platforms on both G2 and Capterra.
Monitor your runs
With our latest monitoring features, you always have immediate access to valuable insights on the status of your web scraping tasks.
Export to various formats
Your datasets can be exported to any format that suits your data workflow, including Excel, CSV, JSON, XML, HTML table, JSONL, and RSS.
Integrate Apify to your workflow
You can integrate your Apify runs with platforms such as Zapier, Make, Keboola, Google Drive, or GitHub. Connect with practically any cloud service or web app.
Large developer community
Apify is built by developers, so you'll be in good hands if you have any technical questions. Our Discord server is always here to help!
Python-ready Google Places data extraction
Connect to hundreds of apps right away using ready-made integrations, or set up your own with webhooks and our API.
No, there is no official Google Places Python API client that provides the comprehensive data extraction capabilities of this scraper. While Google offers a limited Places Python API client with a cap of 60 results and $200 monthly credit, this Python scraper bypasses Google's 120 places per area limitation and extracts unlimited business data including popular times histograms, detailed reviews, and enriched contact information that aren't available through the official Python API client.
Yes, you can try the Google Places Python API client for free. Apify provides free account credits to test the Python API client, and you can start extracting Google Maps data immediately without any upfront costs. The platform offers $5 worth of free credits monthly for new users to explore the Python API client's capabilities.
You can extract 50+ data points using a Python API client including business names, addresses, phone numbers, websites, ratings, review counts, opening hours, coordinates, categories, price brackets, popular times, detailed reviews, images, company contact details, business leads enrichment, social media profiles, menu links, reservation providers, and amenities. The Python client also captures review distributions, questions and answers, updates from customers, and geographic data like plus codes and exact coordinates.
Yes, it is legal to access Google Places data through Python API clients as long as you're extracting publicly available information, which covers most Google Maps data. You should respect personal data boundaries and intellectual property regulations, only access personal data with legitimate reasons, and consider Google's Terms of Use. Using Python API clients to retrieve public business information like addresses, phone numbers, and ratings is generally permissible.
Getting started with our Google Places Python API is easy — simply create a free Apify account, get your API token, and start using the Google Places API in Python, JavaScript, CLI, cURL, OpenAPI, or MCP.