Data catalog / maps
Maps data
Search Google Maps by keyword and area, or by a Maps search URL, and get each place's name, category, address, phone, rating and review count. Pull the reviews for any place. Every Maps endpoint bills 0.1 credits per result.
In short: RichAPI has three Google Maps endpoints, each billed at 0.1 credits per result. POST /google_maps_places_scraper_keyword takes search_query, location_query and limit (default 25). POST /google_maps_places_scraper_sync_using_url takes a google_map_search_url and a limit (max 300). Places come back with title, category, street, city, state, country code, phone, review count, rating (totalScore) and a Maps URL. POST /google_maps_reviews_scraper_sync takes a place URL, a limit (max 300) and review_sort (newest, mostRelevant, highestRanking, lowestRanking).
Last updated October 6, 2026
Places and reviews from Google Maps
Three endpoints cover Maps:
POST /google_maps_places_scraper_keywordsearches bysearch_query("cafe", "dentist") andlocation_query("Pune", "Austin, TX"), up tolimitplaces. The default limit is 25.POST /google_maps_places_scraper_sync_using_urltakes a search you already ran on Google Maps. Copy the URL from the browser and pass it asgoogle_map_search_url. It returns up to 300 places.POST /google_maps_reviews_scraper_synctakes one place's Maps URL and returns its reviews, up to 300, sorted bynewest(the default),mostRelevant,highestRankingorlowestRanking.
A place comes back with title, categoryName and categories, street, city, state, countryCode, phone, reviewsCount, totalScore (the star rating) and its Maps url.
Endpoints and rates
| Endpoint | What it does | Credits | Billed |
|---|---|---|---|
/google_maps_places_scraper_keyword |
Search for business places on Google Maps by keyword and location (e.g., 'cafe' in 'Pune'). | 0.1 | per result |
/google_maps_places_scraper_sync_using_url |
Scrape Google Maps places directly from a search results URL. | 0.1 | per result |
/google_maps_reviews_scraper_sync |
Scrape reviews for a specific Google Maps place synchronously. | 0.1 | per result |
Rates are read from the live OpenAPI spec. Credits are prepaid and never expire, and the price of a credit depends on your package: see pricing.
What Maps data costs
0.1 credits per place or review returned. 300 places cost 30 credits. Reading 50 reviews each for the 20 places you shortlisted costs 100 credits.
The limit sets the bill, so pull places first, cut the list on totalScore, reviewsCount or category, and pull reviews only for the places you kept.
Where it fits
- Rank local businesses by their reviews pulls places, reads reviews with
lowestRankingfirst, and writes to the businesses with a problem you can solve. - Local businesses from Google Maps into your CRM cleans the website field into a domain, enriches what it can, and pushes rows to a CRM.
- For cheaper, wider coverage without ratings, Yellow Pages costs 0.01 credits per listing.
Maps quirks
- The keyword endpoint matches the way Maps search does, so "cafe" in "Pune" returns what Maps shows for that search, not every cafe in the city. Split a big area into neighbourhoods and run each one.
- Maps results do not carry an email address. Use the website with the website email extractor.
limitis required on all three endpoints. On the reviews endpoint its default is 5, so raise it when you need more.
Reference
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | Yes | Maximum number of places to return (default is 25). |
search_query | string | Yes | Fuzzy keyword search. |
location_query | string | No | Fuzzy location search. |
limitinteger · Required- Maximum number of places to return (default is 25).
search_querystring · Required- Fuzzy keyword search.
location_querystring · Optional- Fuzzy location search.
Request
Minimum required parameters for a maps data call.
{
"search_query": "cafe",
"location_query": "Pune",
"limit": 25
}See it in a workflow
Playbooks
Real patterns, recipes, and prompts other builders run on RichAPI
Developer Docs
Auth, request shape, and error handling
FAQ
