Using the API
The Vorbra API lets you access your approved testimonials programmatically. This is useful for custom integrations, building your own display, or syncing testimonials to other platforms.
Important: API access requires the Business plan ($29/month or $22/month billed annually).
API endpoint
GET https://www.vorbra.com/api/testimonials/[your-space-id]
Replace [your-space-id] with the UUID of your space. You can find this in your dashboard URL when viewing a space.
Response format
The API returns a JSON array of approved testimonials. Each testimonial includes:
- •id — Unique identifier
- •author_name — Reviewer's name
- •author_title — Reviewer's title/role (if provided)
- •rating — Star rating (1-5)
- •content — Review text
- •type — "text" or "video" (audio)
- •video_url — URL to audio file (for audio reviews)
- •created_at — Submission timestamp
Example response:
[
{
"id": "abc-123",
"author_name": "Jane Smith",
"author_title": "CEO",
"rating": 5,
"content": "Great product!",
"type": "text",
"created_at": "2026-08-01T12:00:00Z"
}
]CORS
CORS is enabled on the API, so you can call it from any domain using JavaScript in the browser. No API key is required — only approved (public) testimonials are returned.
Rate limits
The API is rate-limited to prevent abuse. If you exceed the limit, you'll receive a 429 status code. For most use cases, caching responses on your end for 5-10 minutes is recommended.
Tip: If you just need to display testimonials on a website, the embed widget is easier — no coding required. The API is for advanced use cases like custom displays or data integrations.