Google Place Reviews
Get user reviews for a place by place_id. Each review includes the rating, full review text, author info (with photo URL, total review count, and Local Guide level), timestamps, attached photos, and any owner response (owner_response is null when the owner has not replied, otherwise an object with text, datetime_utc, timestamp, time and language). Sort by most relevant, newest, highest ranking, or lowest ranking. Set translate_reviews=true to translate all returned reviews into the requested language, and get_sentiment=true to add AI emotion analysis to each review. Each page returns up to 10 reviews and is billed as one request, up to 10 pages per call.
Price: $0.01 per page. Free tier: 20 requests/month.
Request
- Base URL: https://apidirect.io
- URL: https://apidirect.io/v1/places/reviews
- Auth: API key in header X-API-Key
Query parameters
Google place_id, as returned by the Places Search endpoint
Number of pages to fetch and merge. Each page returns up to 10 reviews and is billed as one request
Alternative to pages: maximum number of reviews, rounded up to whole pages of 10 (e.g. limit=15 fetches 2 pages, so up to 20 reviews). Ignored when pages is also sent. Maximum 100
Sort order for reviews
2-letter ISO 639-1 language code for the returned reviews. Set translate_reviews=true to translate the returned reviews into this language
Set to true to translate the returned reviews into the requested language
2-letter ISO 3166-1 alpha-2 region code
Set to true to add AI emotion analysis to each review. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any review that cannot be scored returns sentiment: null.
Response
Successful response
Changes
No recorded changes to this operation across all 1 revision of this API.