Overview

The Basic API will allow you to query for review data for every business associated with your account(s). By using this API, you will be able to:

  • Update businesses about new reviews
  • Display aggregated review content
  • Display analytics on a dashboard
  • Report account level, group level, or individual business data
1631

An example of high-level data that can be displayed with Reply Pro's API

Reply Pro API Resources

The Reply Pro API has 6 endpoints.

End PointDescription
Accounts An account is the highest-level container for your companies.
Businesses A business is a single location that is associated to it's own unique social profiles.
CompanyA company is a container for multiple businesses.
GroupsGroups are a smaller container for businesses within a single company.
ReviewsReview data associated to a specific business.
Suggested ActionsHandles retrieving and updating Suggested Actions, e.g suggested responses, flags, or shares.

Return Keys

When making requests to our api, the response object will contain basic keys to access the data returned:

KeysDescription
resultsA list of objects returned by the endpoint
nextIf pagination is needed due to a large list this will contain the pagination link for the set of data following the current set in the list.

If the list is not large enough to need pagination this value will be null.
previousIf pagination is used this will be a pagination link for the set of data before the current page.

If the current page is the first page in the list this value will be null.

Filters

All of our endpoints support filtering. The table below provides detail on what filter parameters are supported by each endpoint.

End PointOptional Filters
Accountsname, start_id, end_id
Businessesname, locality, address, start_id, end_id, remote_id
Groupsname, start_id, end_id, remote_id
Profilesaddress, address_exact, claimed, data_source, end_id, name, name_exact, phone, start_id
Reviewsdata_source, rating, start_rating, end_rating, start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), exact_date(YYYY-MM-DD), start_id, end_id
Suggested Actionsoriginal_content, data_source, review, end_id, start_id

Each filter operates as a contains query with case insensitivity. Providing multiple queries together will act as a logic AND, returning only entries that match both query parameters.

Example request to the review endpoint:

https://ad1.replypro.io/api/public/account/<id>/companies/<id>/businesses/<id>/reviews?data_source=Google&rating=4&start_date=2017-11-01&end_date=2017-11-08

What’s Next

Requesting Accounts