Place Reviews

Get user reviews for a place by place_id. Each review includes the rating, full review text, author info (with photo URL and total review count), timestamps, attached photos, and any owner response.

Endpoint

GET /v1/places/reviews

Price: $0.003 per request Free tier: 50 requests/month

Parameters

Response Fields

Example Request

cURL

curl "https://apidirect.io/v1/places/reviews?place_id=ChIJifIePKtZwokRVZ-UdRGkZzs&limit=20&sort_by=newest" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://apidirect.io/v1/places/reviews",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "place_id": "ChIJifIePKtZwokRVZ-UdRGkZzs",
        "limit": 20,
        "sort_by": "newest"
    }
)
print(response.json())

Example Response

{
  "reviews": [
    {
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pWeU1rdFZhREZPY214dmRVSlplRzQ0ZURWVk9XYxAB",
      "rating": 5,
      "review_text": "Amazing pizza, fast service. Highly recommend.",
      "review_datetime_utc": "2026-02-15T12:05:54.947Z",
      "review_timestamp": 1771157154,
      "review_time": "3 months ago",
      "review_link": "https://www.google.com/maps/reviews/...",
      "review_photos": ["https://lh3.googleusercontent.com/grass-cs/..."],
      "review_language": "en",
      "review_text_translated_language": "en",
      "like_count": 0,
      "review_source": "Google",
      "review_source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
      "author_id": "103696814314978516852",
      "author_name": "Salman Idrees",
      "author_link": "https://www.google.com/maps/contrib/103696814314978516852",
      "author_photo_url": "https://lh3.googleusercontent.com/a-/ALV-...",
      "author_review_count": 392,
      "author_photo_count": 356,
      "author_reviews_link": "https://www.google.com/maps/contrib/103696814314978516852/reviews",
      "author_is_local_guide": true,
      "author_local_guide_level": 7,
      "owner_response": null
    }
  ],
  "count": 1,
  "limit": 20,
  "sort_by": "newest"
}

Getting more reviews

Each request returns up to 20 reviews, scoped to a single (language, sort_by) combination. Two knobs surface different reviews:

1. sort_by — four options, each returns a different top-20:

• most_relevant (default) — Google’s relevance ranking
• newest — reverse chronological order
• highest_ranking — 5-star and 4-star reviews first
• lowest_ranking — 1-star and 2-star reviews first

2. language — filters reviews to those originally written in that language. The same place_id returns a different set of ~20 reviews for each language.

Combining all four sort orders with a handful of languages can surface several hundred reviews per place. Each call is billed at $0.003.

To consolidate the multilingual set in one language, add translate_reviews=true and the returned reviews will be translated into your chosen language.

Notes

• If a place has no reviews in the requested language, the response is empty (still billed as one request).
• translate_reviews=true replaces each review’s text with the translation. The review_language field shows the original language; review_text_translated_language matches your target.
• The owner_response field is null when the business owner has not replied to the review.
• Set get_sentiment=true to add per-review emotion analysis to the response.