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

Fetch all interactions

GET
https://api.synup.com/api/v4/locations/{locationId}/reviews
This API retrieves interactions for a specific location, supporting multiple filters to refine results.
Filtering Options:
Date Range – Fetch interactions within a specified time frame.
Interaction Type – Filter by reviews, social engagements, or directory interactions.
Platform – Retrieve interactions from specific sources (e.g., Google, Facebook, Yelp).
Response Status – Show only responded or unresponded interactions.
Rating – Filter reviews by star ratings (if applicable).

Request

Path Params

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.synup.com/api/v4/locations//reviews?siteUrls&category&startDate&endDate&ratingFilters&before&after&first&last' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx'

Responses

🟢200OK
application/json
Interactions retrieved successfully
Body

Example
{
    "data": {
        "interactions": {
            "pageInfo": {
                "hasNextPage": false,
                "hasPreviousPage": false,
                "endCursor": null,
                "total": null
            },
            "edges": [
                {
                    "node": {
                        "id": "9990178a-f119-43da-adbe-e2facad5a870",
                        "source": "maps.google.com",
                        "authorName": "Dale Rohwedder",
                        "authorAvatar": "https://lh6.googleusercontent.com/-rwVBMk41wg0/AAAAAAAAAAI/AAAAAAAAADc/NamFETXVIRw/w36-h36-p-mo/photo.jpg",
                        "rating": 4,
                        "date": "2019-01-24T06:13:15.332985+00:00",
                        "category": "Review"
                    },
                    "cursor": "SW50ZXJhY3Rpb246OTk5MDE3OGEtZjExOS00M2RhLWFkYmUtZTJmYWNhZDVhODcw"
                }
            ],
            "totalCount": 1
        }
    }
}
🟠400Bad Request
🟠404Record Not Found
Modified at 2025-07-21 09:13:25
Previous
Add / Edit interaction source
Next
List Interactions by IDs
Built with