Before you start using the API, we recommend you review these guidelines.
The Yotpo API supports both HTTP and HTTPS requests.
Data must be in JSON format. As such, the HTTP header content-type must be set to: application/json
Use the following parameters to paginate results in API requests which support pagination:
page - Number of pages to return
count - Number of results to return per page
To improve the experience for all our users, we impose limits on some API requests. You’ll receive a
429 Too Many Requests error message if you reach this limit. Where a rate limit applies, this will be indicated under the specific endpoint or group of endpoints.
For some endpoints, we impose a Service Level Agreement (SLA) to ensure the endpoint returns fresh data. Where the SLA applies, this will be indicated under the specific endpoint or group of endpoints.
Yotpo API uses standard HTTP response codes to indicate the success of failure status of an API endpoint.
Internal Server Error e.g. Timeout
Certain API calls return special responses to indicate specific errors.
Special responses are noted for relevant API endpoints within the documentation.
Email and URL parameters you send in the calls must be in the correct format, otherwise the call will not be processed.
The Yotpo API calls support special characters according to the UTF-8 coding.
The API key and API secret are unique codes for your account. You need the API key to perform most API calls and the API secret to generate the utoken.
If you need help finding your API key and API secret, see this article.
The API secret is only visible to Yotpo account administrators. Users with
staffpermissions cannot view the API secret.