EveryData platform API
Google Maps Reviews API
Google Maps Reviews offers the 3 declared views used here for Google Maps place discovery, place details, customer reviews, and owner responses, and `search`, `profile`, `reviews` must each be read according to its own contract.
Google Maps Reviews keeps `search` (matching public results) apart from `profile` (the selected public record); `keyword`, and `url` apply only inside those contracts.
- Endpoint
- POST /api/v1/social
- Capabilities
- 3
- Per 1,000
- $1.389
Available capabilities
Compare the Google Maps Reviews actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch The | keyword | country, language, location | Sync delivery | Catalog values: defaultLimit=15, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
profilePlace details Select | url | city, language, since, sort | Sync delivery | — | $1.39 per 1,000 requests | place_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform · day · hours |
reviewsReviews To retrieve Google Maps review records, select the | url | lang, language, since, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · text · rating · rating_scale · reviewer_name · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform |
What does each Google Maps Reviews action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Google Maps Reviews search parameters mean?
The search action queries matching public places on Google Maps using the query string in keyword. Omission from search results does not confirm a place does not exist on Google Maps. Pass country, location, language, and keyword to Google Maps Reviews search; returned objects expose rating_scale, lat, categories, url, state, platform, category, image_url, description, rating, city, country_code, postal_code, review_count, name, address, permanently_closed, lng, phone, website, price, and place_id.
keywordRequired- A Google Maps place name, business type, or place query, such as
dentistordentist in Chicago.searchfinds places; it does not search the text of reviews for an existing business. countryOptional- The country or region code used to establish search context, such as
us; the default isus. It is not a guarantee that every returned business is located in that country. languageOptional- The language used for the query or page content; the default is
en. For reviews,langoverrides this value when both are supplied. This setting does not guarantee that every review was written in that language. locationOptional- The place text combined with
keywordforsearch, such asChicago. Avoid supplying a location that conflicts with a location already embedded in the keyword.
What do the Google Maps Reviews profile parameters mean?
Select profile to retrieve details for a specific Google Maps record, using url to identify the target. Use the record identifiers to distinguish places without inferring legal entity identity. Google Maps Reviews profile takes sort, since, url, language, and city and yields name, state, permanently_closed, description, platform, phone, postal_code, rating, plus_code, image_url, lat, address, neighborhood, opening_hours, city, review_count, country_code, website, url, price, place_id, temporarily_closed, category, day, hours, categories, image_count, lng, and rating_scale.
urlRequired- A full Google Maps place URL, preferably the URL returned by search with
query_place_idpreserved. A/place/URL containing only a name and coordinates may not identify the same business reliably. Use profile for place details and reviews for that place's reviews.Google Maps: Place Links and Place IDsGoogle Maps links use `query_place_id` to identify a specific location directly rather than relying only on location names or coordinates.Checked cityOptional- A city constraint for place discovery. Although the profile contract also exposes this parameter, it cannot move a known business to another city or reliably replace the place URL.
languageOptional- The language used for the query or page content; the default is
en. For reviews,langoverrides this value when both are supplied. This setting does not guarantee that every review was written in that language. sinceOptional- The lower publication-date boundary for reviews, preferably in
YYYY-MM-DDformat. It is not the business opening date. Its presence on the profile contract does not mean place details are filtered by opening date. sortOptional- The review order:
newestfor recent reviews orrelevancefor the platform's relevance order. Reviews default tonewest. On profile, the same name can affect attached review data but does not sort the single place object.Allowed values:newestrelevance
What do the Google Maps Reviews reviews parameters mean?
To retrieve Google Maps review records, select the reviews action. Use Google Maps Reviews reviews with url; Google Maps Reviews then selects place for this action only. Google Maps Reviews reviews takes lang, since, language, url, and sort and yields text, rating_scale, detailed_rating, reviewer_review_count, owner_response, platform, like_count, place_id, place_name, owner_response_at, rating, posted_at, is_local_guide, id, url, reviewer_name, and image_urls.
urlRequired- A full Google Maps place URL, preferably the URL returned by search with
query_place_idpreserved. A/place/URL containing only a name and coordinates may not identify the same business reliably. Use profile for place details and reviews for that place's reviews.Google Maps: Place Links and Place IDsGoogle Maps links use `query_place_id` to identify a specific location directly rather than relying only on location names or coordinates.Checked langOptional- The reviews language option, such as
en,zhcn, orzhtw; use the action's complete allowed-value list. After mapping, it takes precedence overlanguage. It does not filter by a review author's nationality.Allowed values:afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu languageOptional- The language used for the query or page content; the default is
en. For reviews,langoverrides this value when both are supplied. This setting does not guarantee that every review was written in that language. sinceOptional- The lower publication-date boundary for reviews, preferably in
YYYY-MM-DDformat. It is not the business opening date. Its presence on the profile contract does not mean place details are filtered by opening date. sortOptional- The review order:
newestfor recent reviews orrelevancefor the platform's relevance order. Reviews default tonewest. On profile, the same name can affect attached review data but does not sort the single place object.Allowed values:newestrelevance
How to use the Google Maps Reviews API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_maps_reviews","action":"search","params":{"keyword":"<keyword>"}}'
Google Maps Reviews API questions
What can I retrieve with the Google Maps Reviews API?
Set platform to google_maps_reviews. The current catalog lists search, place details, and reviews. These action names identify different Google Maps Reviews objects or views; they are not interchangeable search modes.
Which input starts a Google Maps Reviews `search` request?
A Google Maps place name, business type, or place query, such as dentist or dentist in Chicago. search finds places; it does not search the text of reviews for an existing business. Send it as keyword inside params.
Which fields can Google Maps Reviews `search` return?
Its declared schema includes place_id, name, category, and categories. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Google Maps Reviews action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.