POST /google_maps_places_scraper_sync_using_url • Credits: 0.1 credits per place returned

Google Maps Places (URL) scrapes the places from a Google Maps search results URL. It returns a JSON array. Each place holds the business name, the address, the Google Maps category, the star rating, the review count and the place URL. Each place costs 0.1 credits, which is $0.002 on the 1,000 and 5,000 credit packs.

Google Maps Places (URL) reads a Google Maps search results URL and returns the places on that map view. The URL is the input, so you control the exact search. Open Google Maps in a browser, run the search, then copy the URL from the address bar. Send that URL as google_map_search_url. RichAPI runs the Google Maps crawler over the URL and returns each place as one object in a JSON array. The limit parameter caps the number of places, and it therefore caps the cost of the call.

RichAPI has two Google Maps place endpoints. They return the same kind of data and cost the same. The difference is the input.

When a person already found the right map view by hand, use Google Maps Places (URL). When a program builds the search from a keyword list and a city list, use Google Maps Places (Keyword) API.

Google Maps Places (URL) accepts the POST method only. If you send GET, the API returns 405 with the message google_maps_places_scraper_sync_using_url only supports POST.

CAUTION: Set limit on every Google Maps Places (URL) request. RichAPI charges 0.1 credits for each place in the response.

google_map_search_url takes a Google Maps search results URL. The example URL is https://www.google.com/maps/search/coffee+shop/@40.7128,-74.0060,14z. That URL holds three parts. coffee+shop is the search text. @40.7128,-74.0060 is the center of the map. 14z is the zoom level.

The zoom level sets the area of the search. A high zoom number covers a small area and returns fewer places. A low zoom number covers a wide area and returns more places. To split a large city into districts, copy one URL per district at a high zoom level.

limit is the cost control for Google Maps Places (URL). RichAPI charges 0.1 credits for each place in the response, so the maximum cost of one call is limit x 0.1 credits. RichAPI reserves that maximum before the call. RichAPI then charges for the number of places that the response holds, and it refunds the rest of the reservation.

CAUTION: Cap limit before you scrape a URL that covers a dense area. A low zoom level over a large metropolitan area returns thousands of places, and 1,000 places cost 100 credits.

Google Maps Places (URL) returns a JSON array. Each entry is one Google Maps place. This example shows the response shape for a coffee shop search in New York.

The values above are illustrative. When the Google Maps listing carries no value for a field, Google Maps Places (URL) omits that key.

The documented response holds the six fields in the table above. It records no phone number, no website, no coordinates and no opening hours. To read the Google place ID, take the query_place_id query parameter from the url value.

Google Maps Places (URL) costs 0.1 credits per place returned. There is no base charge per call. At $0.02 a credit, the rate on the 1,000 and 5,000 credit packs, one place costs $0.002. Larger packs cost less per credit. A default call that returns 5 places costs 5 x 0.1 = 0.5 credits. That is $0.01.

Cost of one call, by the number of places returned:

Cost of a district sweep, across many calls:

RichAPI reserves limit x 0.1 credits before the call. RichAPI then charges for the places in the response and refunds the rest. A call that returns zero places costs zero credits.

RichAPI refunds the credit reservation for every response outside the 200 range. A 400, 429 or 500 response costs no credits.

One Google Maps place costs 0.1 credits, which is $0.002 on the 1,000 and 5,000 credit packs. Google Maps Places (URL) charges no base credit per call, so a call that returns zero places costs zero credits.

Send a URL. Google Maps Places (URL) takes a Google Maps search results URL in google_map_search_url. To search by a keyword and a city instead, use the Google Maps Places (Keyword) endpoint.

Open Google Maps in a browser and run the search. The browser address bar then holds the search results URL. Copy that URL and send it as google_map_search_url.

The default value of limit is 5 places. If you omit limit, RichAPI applies 5, and the call costs 0.5 credits at most.

The documented response holds six fields: title, categoryName, address, totalScore, reviewsCount and url. The Google Maps Places (Keyword) endpoint documents a phone field and a website field.

Take the url value of the place. Send it as google_map_review_url to the RichAPI Google Maps Reviews endpoint, which costs 0.1 credits per review returned.

One URL is one map view, and Google Maps returns a limited result set per view. Copy one URL per district at a high zoom level, then send one call per URL.