POST /google_maps_places_scraper_keyword • Credits: 0.1 credits per place returned

Google Maps Places (Keyword) searches Google Maps for a business keyword in a location. It returns a JSON array of places. Each place holds the business name, the street address, the phone number, the website, the category, the star rating and the review count. Each POST call costs 0.1 credits per place returned, which is $0.002 per place on the 1,000 and 5,000 credit packs.

Local sales teams need a list of every business of one type in one city. Google Maps Places (Keyword) builds that list from Google Maps. Send a business keyword such as "coffee shop" and a location such as "New York, NY". RichAPI runs the Google Maps search and returns each matching place as one object in a JSON array. The data source is the Google Maps place listing, so the phone number, the website and the rating come from the business profile. The limit parameter caps the number of places, and it therefore caps the cost of the call.

Google Maps Places (Keyword) accepts the POST method only. If you send GET, the API returns 405.

CAUTION: Set limit on every Google Maps Places (Keyword) request. A dense city returns thousands of places for one keyword, and each place costs 0.1 credits.

The schema marks limit as required and gives it the default value 25. If you omit limit, RichAPI applies 25. If limit falls outside the range 1 to 1000, the API returns 400 with the message limit must be between 1 and 1000.

Google Maps Places (Keyword) rejects any parameter name that is not in the table above. An unknown name returns 400 with the message Unknown input field(s).

search_query is one plain string. It holds the words that you type into the Google Maps search box, for example "coffee shop", "dentist" or "plumber". One call searches one keyword. To cover several business types, send one call per keyword.

location_query is one plain string. It holds a fuzzy location name, for example "Pune", "New York, NY" or "Brooklyn". location_query is optional. If you omit location_query, Google Maps resolves the location from the keyword alone, and the results spread across regions. Send location_query on every local search.

limit is the cost control for Google Maps Places (Keyword). 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 search a dense city. An uncapped run over a large metropolitan area returns thousands of places, and 1000 places cost 100 credits.

Google Maps Places (Keyword) returns a JSON array. Each entry is one Google Maps place. This example shows a real response for the keyword "coffee shop" in New York.

The fourth place in the example holds no website key. When the Google Maps listing carries no value for a field, Google Maps Places (Keyword) omits that key.

The verified Google Maps Places (Keyword) response holds the twelve fields in the table above. It holds no geographic coordinates, no opening hours, no postal code and no separate place ID field. To read the Google place ID, take the query_place_id query parameter from the url value.

Local lead generation is the core use case. One call returns every business of one type in one city, with the phone number and the website for each.

To cover a large metropolitan area, send one call per district instead of one call for the whole city. Google Maps returns a limited result set per search, and district calls return more distinct businesses. To enrich each website with company data, pass the website value to the RichAPI Website Intelligence endpoint.

Google Maps Places (Keyword) 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 25 places costs 25 x 0.1 = 2.5 credits. That is $0.05.

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

Cost of a lead list, 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 (Keyword) charges no base credit per call, so a call that returns zero places costs zero credits.

Google Maps Places (Keyword) returns up to 1000 places in one call. The limit parameter sets the cap, and the default value is 25.

No. search_query holds one keyword string. To search several business types, send one call per business type.

No. location_query is optional. If you omit location_query, Google Maps resolves the location from the keyword alone, and the results spread across regions.

No. The Google Maps place listing holds a phone number and a website, and not an email address. To find email addresses, pass each website value to the RichAPI Website Email Extractor endpoint.

When the Google Maps listing carries no value for a field, Google Maps Places (Keyword) omits that key. A business without a website in its listing returns a place object with no website key.

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.