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 Search public results on Google Maps Reviews. Accepts these parameters: | 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 Retrieve place details from Google Maps Reviews. Accepts these parameters: | 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 Retrieve public reviews from Google Maps Reviews. Accepts these parameters: | 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?
Search public results on Google Maps Reviews. Accepts these parameters: country, location, language, and keyword. Returns these fields: rating_scale, lat, categories, and state.
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?
Retrieve place details from Google Maps Reviews. Accepts these parameters: sort, since, url, language, and city. Returns these fields: name, state, permanently_closed, and description.
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?
Retrieve public reviews from Google Maps Reviews. Accepts these parameters: lang, since, language, url, and sort. Returns these fields: text, rating_scale, detailed_rating, and reviewer_review_count.
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.