1. Reviews
  • Getting Started
  • Locations
    • Location Attributes
      MARKDOWN
    • Photo specifications for your business location
      MARKDOWN
    • Star and Unstar Photos
      MARKDOWN
    • Create a new business location
      POST
    • Update business location
      POST
    • List all locations
      GET
    • List particular locations
      GET
    • Search locations
      GET
    • Get locations by store codes
      GET
    • Upload Photos to a Location
      POST
    • Check Bulk Photo Upload Status
      GET
    • Star/Unstar Location Photos
      POST
    • Delete Location Photos
      POST
    • Archive multiple locations
      POST
    • Cancel scheduled location archival
      POST
    • Activate archived locations
      POST
    • List Active Subscriptions
      GET
    • Get a list of supported countries and their states
      GET
    • Get SubCategories and AdditionalCategories
      GET
    • Get Site Details for Your Plan
      GET
  • Organizing locations
    • Organizing locations
    • Create a new folder
    • List all folders
    • List all folders under an account in hierarchical structure
    • Get details of a folder
    • Rename a folder
    • Add locations to a folder
    • Remove locations from a folder
    • Delete a folder
    • List locations under a folder
    • List all tags
    • List locations by tags
    • Add location to a tag
    • Remove location from a tag
  • User Management
    • User Attributes
    • Create User with Role
    • List Users
    • List Users by ID
    • Add Locations to User
    • Add User and folder
    • List User Roles
    • Add folders to user
    • List User Resources
    • Update a User
    • Remove Folders for User
    • Remove Locations for User
  • Grid Rank
    • Local Rank Grid
    • Create Rank Grid Report
    • Fetch All Grid Reports for Location
    • Fetch Rank Grid Report By ID
  • Review Campaigns
    • Review Campaign Info Attributes
    • Create a review campaign
    • Add customers to a review campaign
    • List review campaigns
    • List review campaign customers
  • Listings
    • Listings
    • Listing Status Webhooks
    • Get premium listings
    • Get voice listings for a location
    • Get duplicate listings for a location
    • Get all duplicate listings for an account
    • Mark listings as duplicates
    • Mark listings as not duplicates
    • Get AI listings
  • Connected Accounts
    • Connected Accounts
    • Connect Google Profile to Account
    • Connect Facebook Page to Account
    • List all connected accounts
    • List folders under a Google account
    • Create GMB Listing
    • Disconnect GMB Profile
    • Disconnect Facebook Account
    • Fetch Connected Account Details
    • Trigger New Matches
    • List Connection Suggestions
    • Fetch Connected Account Listings
    • Confirm Connected Account Matches
    • Connect a location with a listing of a connected account
    • Disconnect Location from Listing
  • Rankings
    • Rankings Analytics Attributes
    • Add keywords
    • List Keywords
    • Get keywords performance
    • Archive a keyword
    • Get Rollup Keyword Performance
    • Get Rankings Distribution By Time
  • Profile Analytics
    • Profile Analytics
    • Get Bing Analytics
    • Get Facebook Page Analytics
    • Get Google My Business Analytics
  • Reviews
    • Reviews
      MARKDOWN
    • Review Sources
      • Get a list of interaction sources for location
      • Get a list of interaction sources for account
      • Add / Edit interaction source
    • Fetch all interactions
      GET
    • List Interactions by IDs
      GET
    • Respond to an Interaction
      POST
    • Edit Response for Interaction
      POST
    • Archive Response for Interaction
      POST
    • Get Interaction Analytics
      GET
    • Add Review Widget
      POST
    • Edit Review Widget
      POST
  • Automations
    • Temporary Close Location with a reopening date
  • Error Codes
    • ERROR CODES
  1. Reviews

Reviews

MARKDOWN
https://api.synup.com/api/v4

Overview#

Reviews represent user engagement with a business location across various directories and platforms.
This documentation provides details on supported platforms, data structure, best practices, and technical considerations for integrating and managing customer feedback effectively.

Supported Platforms#

Business Directories
Google Maps
Yelp
YellowPages
BBB (Better Business Bureau)
Judysbook
Social Media Platforms
Facebook
Foursquare
Industry-Specific Platforms
Automotive
DealerRater
Cars.com
Edmunds
CarGurus
Real Estate
Zillow
Hospitality & Tourism
TripAdvisor
TripAdvisor Attractions
OpenTable
Zomato
Employment & Business
Indeed
Glassdoor
TrustPilot

Interaction Data Structure#

Each interaction typically includes:
Source Platform – Where the interaction originated.
Interaction Type – Reviews
Content – Text of the review
Author Information – Name or anonymous ID.
Timestamp – Date and time of the interaction.
Rating (if applicable) – Star rating (e.g., 1-5 stars).
Response Status – Whether the business has responded.
Moderation Status – Indicates if the interaction is flagged or hidden.

Platform Requirements#

To fetch interactions from a platform:
The business must have an active profile/page on the platform.
Proper authentication and access permissions must be configured.
Platform API access must be enabled (where applicable).

Best Practices#

1. Monitoring
Regularly check for new interactions across platforms.
Monitor response times to customer feedback.
Track interaction trends over time.
2. Response Management
Maintain a consistent response tone across platforms.
Address negative feedback promptly and professionally.
Follow platform-specific guidelines for responses.
3. Data Analysis
Track interaction volumes by platform to identify engagement trends.
Monitor sentiment trends for insights into customer perception.
Identify recurring themes in feedback for business improvements.

Common Use Cases#

1. Review Monitoring
Track new reviews across platforms.
Monitor rating trends over time.
Identify customer satisfaction patterns.
2. Response Management
Coordinate responses to reviews efficiently.
Maintain response templates for consistency.
Track response times to improve customer engagement.
3. Reporting & Analytics
Generate interaction summaries for insights.
Track platform-specific metrics on engagement.
Monitor overall online presence across directories and social platforms.

Limitations#

Platform availability may vary by region.
Some platforms enforce API rate limits on requests.
Historical data availability depends on the platform's retention policies.
Some platforms have limited response capabilities, restricting direct replies.
Modified at 2025-02-24 10:16:54
Previous
Get Google My Business Analytics
Next
Get a list of interaction sources for location
Built with