What plan do I need to access the API?

API access requires the Pro plan. Once you upgrade, you can create API keys in your dashboard under Settings → API Keys. Your first key is available in minutes.

How do I authenticate API requests?

All requests require a Bearer token in the Authorization header: `Authorization: Bearer sk_live_...`. Keys are hashed and stored securely — only approved testimonials are ever returned.

What can I filter by?

You can filter testimonials by tag (with any/all/exclude modes), rating, source (e.g. google, trustpilot), and media type. Combine any filters freely. Results are paginated with total count metadata.

What does the response look like?

The API returns a JSON object with a `data` array of testimonials and a `pagination` object containing `page`, `total`, and `has_next`. Each testimonial includes id, content, author name/role/avatar, rating, tags, source, and timestamps.

Is there a rate limit?

Yes. Rate limit headers are included on every response so you can track your usage. Limits are generous for typical use cases. Contact us if you need higher throughput.

Can I use this with any language or framework?

Yes — the API returns standard JSON, so it works with any language or framework: JavaScript, Python, Ruby, Go, PHP, and more. It also works at build time in static site generators like Astro, Gatsby, Hugo, and Eleventy.

Are testimonials filtered before the API returns them?

Yes. The API only returns testimonials you have approved. Pending or rejected testimonials are never exposed, regardless of the filters you apply.

REST API

Your testimonials, your way

Fetch your approved testimonials via a clean REST API. Filter by tag, rating, source — render them however you want.

✓Filter by tag, rating, source, and media type
✓Paginated JSON — works in any language or framework
✓Secure API keys — hashed, scoped to your project, instantly revocable

Get Started Free Read the Docs

API access requires Pro plan · Get your key in minutes

const res = await fetch(
  "https://saywall.io/api/v1/testimonials",
  { headers: { "Authorization": "Bearer sk_live_..." } }
);

const { data, pagination } = await res.json();

// { 
//   data: [ { id, content, author, rating, tags ... },],
//   pagination: { page: 1, total: 42, has_next: true }
// }

const res = await fetch(
  "https://saywall.io/api/v1/testimonials",
  { headers: { "Authorization": "Bearer sk_live_..." } }
);

const { data, pagination } = await res.json();

// { 
//   data: [ { id, content, author, rating, tags ... },],
//   pagination: { page: 1, total: 42, has_next: true }
// }

Fetched live via the API

See it in action

This is a real testimonial pulled from our API right now.

“Optimized, Clean, Dynamic, Extremely fast without a headache.”

Pristine

Cuocsongque CEO

Features

Built for developers

Everything you need to integrate testimonials into any application.

Rich filtering

Filter by tag, rating, source, media type. Combine filters freely. Tag modes: any, all, exclude.

Fast responses

Indexed database queries. Paginated JSON with total counts. Rate limit headers on every response.

Secure by default

API key authentication. Only approved testimonials are returned. Keys are hashed and revocable.

Filter any way you want

Combine query parameters to get exactly the testimonials you need.

By rating

GET /api/v1/testimonials?rating_min=4&sort=rating

Get your best testimonials first

By tag

GET /api/v1/testimonials?tag=enterprise,saas&tag_mode=any

Filter by your custom tags

By source

GET /api/v1/testimonials?source=google,trustpilot

Show reviews from specific platforms

Combined

GET /api/v1/testimonials?rating=5&tag=featured&source=google&limit=5

Mix and match any filters

Use Cases

Use it anywhere

Fetch testimonials once, display them everywhere.

Custom websites

Build testimonial sections that match your exact design

Mobile apps

Show social proof in your iOS or Android app

Static sites

Fetch at build time for Astro, Hugo, Gatsby, or Eleventy

Dashboards

Pull testimonial data into internal tools

Developer FAQ

Common questions about the SayWall API

Ready to build?

Create your free account and upgrade to Pro to get API access. Your first API key is minutes away.

Get Started Free Read the Docs