Skip to main content
This feature is available only for businesses subscribed to Review Management.
Partoo centralizes all business reviews from Google, Facebook, and TripAdvisor platforms, providing a unified API to retrieve and manage them efficiently.

​
Prerequisites

Before retrieving reviews, ensure you have:
  • Active subscription to the Review Management
  • API key with Business Manager role or higher
  • Platform Integrations: Ensure your platforms are integrated properly
    • Google My Business
    • Facebook
    • TripAdvisor
    • Valid Google My Business location ID (google_location_id)
    • Active OAuth account with proper scopes
    • GMB location must be linked to the business
If you need help with any of these prerequisites, please contact your Account Manager who can guide you through the process.

​
How the Reviews Mechanism Works

Partoo automatically collects reviews from Google, Facebook, and TripAdvisor platforms and makes them available through a unified API.

​
Review Collection

  • Scheduled fetching: Reviews are collected daily at different times for each platform:
    • Google My Business: 8:15 PM UTC
    • Facebook: 7:00 PM UTC
    • TripAdvisor: 8:00 PM UTC
  • 24-hour delay: New reviews may take up to 24 hours to appear in the API
  • Live fetch: Google My Business reviews are fetched when Google sends webhook notifications
  • Platform integration: Only reviews from connected platforms are available

​
Review States

Each review has one of these states:
  • treated: Has a reply or was marked as treated
  • not_treated: No reply yet and not marked as treated
  • deleted: Was removed by the user on the original platform
  • pending_auto_reply: Queued for automatic response
  • treated_auto_reply: Has a reply via automatic response
Important: You can only reply to reviews via the API, not modify or delete the original review content.

​
Reply Templates

Reply templates help you respond quickly to reviews with predefined messages. They’re designed for use within the Partoo application. You cannot access a formatted template with prefilled placeholders from the API. However, you can manage these templates through the API:
  • Browse through existing reply templates
  • Create new reply templates
  • Delete reply templates

​
Tips to Retrieve Reviews Effectively

1

Use the Search Endpoint

Start with the main search endpoint to retrieve reviews:
GET /reviews
You can find the complete endpoint documentation in the API Reference.
2

Apply Smart Filtering

Use the available filters to narrow down your results:
  • Business Filtering
  • Status Filtering
  • Platform Filtering
  • Date Range Filtering
# Get reviews for specific businesses
GET /reviews?business__in=5409c35a97bbc544d8e26737,60b2645fb12ff60643ef8344
3

Implement Pagination

Handle large datasets efficiently with cursor-based pagination:
# Enables cursor-based pagination mode
GET /reviews?cursor=1

# Subsequent pages using cursor
GET /reviews?next_cursor=eyJ1cGRhdGVfZGF0ZSI6IjIwMjQtMDEtMDEiLCJpZCI6MTIzfQ==
The default page size is 30 reviews per page, with a maximum of 100 reviews per page. Use cursor-based pagination for better performance with large datasets.
4

Use Keywords Search

Search for specific content within reviews:
# Search for reviews containing specific keywords
GET /reviews?keywords=excellent,amazing,great
Keywords are searched across review content, author names, and platform-specific fields. Maximum 12 keywords allowed.
5

Sort Results Effectively

Order your results for better management:
# Sort by creation date (newest first)
GET /reviews?ordering=-date

# Sort by rating (highest first)
GET /reviews?ordering=-rating

# Sort by status
GET /reviews?ordering=state
Available ordering fields: id, author_name, date, update_date, rating, state, title, partner. Prefix with - for descending order.