Skip to main content
All CollectionsAPI
GET testimonials using the API
GET testimonials using the API

Learn how to retrieve testimonials from Shapo using the API.

Inbal Eting avatar
Written by Inbal Eting
Updated over a week ago

You can fetch/GET testimonials from your Shapo workspace using our API.

First, grab your API key from the Workspace settings page:

Please note: This API is rate limited to 60 calls per hour, reach out to us if you need more than that.

Here's how you would structure a request:

GET https://api.shapo.io/testimonials
Authorization: Bearer <YOUR API KEY>

Query parameters (all parameters are **optional**):

size - number of testimonials to return per call (min: 1, max: 50)
page - combined with the size param, you can paginate (min: 1)
rating - minimum rating of testimonials to retrieve (min: 1, max: 5)
sources - array of testimonial sources, e.g. sources[]=judgeme&sources[]=google
tags - array of tag names associated with testimonials, e.g. tags[]=tag name1&tags[]=tag2

The response is an array of testimonials:

[
{
"_id": "12345",
"date": "2024-03-18T11:53:01.000Z",
"rating": 5,
"source": "google",
"name": "John Wayne",
"title": "Co-founder",
"company": "ACME",
"link": "https://www.acme.com",
"profileImage": "https://imgur.com/johns-profile-picture",
"message": "probably the best product in the world",
},
...
]

Did this answer your question?