Testimoney API
The Credibility Marketplace. Purchase testimonials from executives who'll say whatever you need. Embed paid endorsements with full payment transparency. Why earn trust when you can buy it?
What you can build
- Social proof widgets - Embed professional testimonials on your site with a single script
- Executive marketplaces - Browse and hire from our pool of 200+ verified executives
- Testimonial generators - Use our AI to craft the perfect endorsement (+$50)
- Review aggregators - Collect all your purchased testimonials in one dashboard
- Credibility analytics - Track which executives drive the most conversions
- Insurance platforms - Protect against endorser cancellation with Testimonial Insurance
Live Demo
See what you can build with the Testimoney API. Below is a real testimonial from our marketplace.
Quickstart
Start buying credibility in under 5 minutes. Your competitors already are.
1. Add the widget
Drop in the Testimoney widget with a single script. No API key required for public testimonials.
<!-- Add the widget container --> <div id="testimoney-widget" data-company="your-company-slug" data-limit="3" data-show-payment="true" data-show-rating="true"> </div> <!-- Include the Testimoney SDK --> <script src="https://testi.vagibond.com/testimoney-core.js" async></script>
2. Browse executives
Visit the Executive Directory to find the perfect voice for your brand. Filter by industry, price tier, and availability.
3. Purchase and embed
Select an executive, customize your testimonial message (or let our AI write it for +$50), and checkout via ShopLift. Your new testimonial will appear in your widget within 48 hours.
Authentication
The widget SDK works without authentication for displaying testimonials. For purchasing:
| Prefix | Type | Permissions |
|---|---|---|
testi_live_ |
Production | Full access: purchase, generate, manage testimonials |
testi_test_ |
Sandbox | Test purchases with fake executives (somehow more authentic) |
Rate Limits
We limit how fast you can buy credibility. Building trust takes time (about 48 hours, usually).
| Plan | Widget Loads/day | Purchases/month | AI Generations |
|---|---|---|---|
| Starter | 1,000 | 5 | 10 |
| Growth | 10,000 | 25 | 50 |
| Enterprise | Unlimited | Unlimited | Unlimited |
| Desperate | Unlimited | Unlimited | Unlimited + Priority |
Widget SDK
The Testimoney Widget SDK provides a drop-in component that displays testimonials with payment transparency, star ratings, and optional Gruntslate integration.
Basic Embed
<!-- Minimal setup --> <div id="testimoney-widget" data-company="cheatgpt"></div> <script src="https://testi.vagibond.com/testimoney-core.js"></script> <!-- Or use the data attribute selector --> <div data-testimoney-widget data-company="cheatgpt"></div>
Widget Configuration
Configure the widget using data attributes:
| Attribute | Type | Default | Description |
|---|---|---|---|
data-company |
string | null | Company slug to filter testimonials (optional) |
data-testimonials |
string | null | Comma-separated testimonial IDs to display |
data-limit |
number | 3 | Maximum testimonials to display |
data-show-payment |
boolean | true | Show payment amount badge on each testimonial |
data-show-rating |
boolean | true | Show star rating (1-5) |
data-show-header |
boolean | true | Show widget header |
data-show-footer |
boolean | true | Show "Powered by Testimoney" footer |
data-show-grunt |
boolean | true | Show "Hear in Grunt" speaker button |
data-source |
string | executives | Data source: executives, convicts, students, hotties |
data-layout |
string | grid | Layout style: grid, list, carousel |
Theming
Customize colors to match your brand:
<div id="testimoney-widget"
data-company="your-company"
data-bg-color="#ffffff"
data-text-color="#2c3e50"
data-accent-color="#27ae60"
data-payment-color="#27ae60"
data-gold-color="#f39c12"
data-border-color="#e1e8ed">
</div>
Data Sources
Pull testimonial authors from different pools:
| Source | Description | Best For |
|---|---|---|
executives |
200+ business professionals (default) | B2B, enterprise, fintech |
convicts |
Formerly incarcerated endorsers | Second chances brands, legal services |
students |
Budget-friendly Gen Z voices | Consumer apps, social platforms |
hotties |
Attractive lifestyle endorsers | Fashion, fitness, dating apps |
REST API: Executives
Browse available executives for hire. Filter by industry, price tier, and availability.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
tier |
string | Price tier: intern, manager, director, csuite, celebrity |
industry |
string | Filter by specialty: tech, finance, healthcare, etc. |
available |
boolean | Only show currently available executives |
limit |
number | Max results (default: 20, max: 100) |
Response
{
"executives": [
{
"id": "exec_913e7a635a110ced",
"name": "Kevin Smith",
"title": "CEO",
"tier": "csuite",
"base_rate": 1499,
"specialties": ["tech", "saas"],
"available": true,
"photo": "https://cdn.vagibond.com/main/assets/executives/face/913e7a635a110ced_thumb.jpg",
"rating": 4.8,
"testimonials_given": 47
}
],
"total": 203,
"has_more": true
}
REST API: Testimonials
Retrieve testimonials. Filter by company or fetch all.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
company |
string | Company slug to filter testimonials |
executive_id |
string | Filter by executive |
min_rating |
number | Minimum star rating (1-5) |
limit |
number | Max results (default: 20) |
REST API: Purchase
Purchase a new testimonial from an executive. Payment processed via Swipe.
Request Body
{
"executive_id": "exec_913e7a635a110ced",
"company_name": "Your Company",
"quote": "Custom testimonial text...",
"rating": 5,
"ai_generated": false,
"addons": ["video", "linkedin"]
}
REST API: AI Generate
Let our AI craft the perfect testimonial. +$50 per generation. (Ironic since it's all AI anyway.)
Request Body
{
"executive_id": "exec_913e7a635a110ced",
"company_name": "Your Company",
"product_description": "A revolutionary widget that...",
"tone": "professional", // professional, enthusiastic, casual
"length": "medium" // short, medium, long
}
Response
{
"generated_quote": "Your Company has transformed how we approach our business. The ROI speaks for itself. I recommend it to everyone in my network.",
"alternatives": [
"Since implementing Your Company, our team has never been more productive.",
"Five stars isn't enough. Your Company deserves ten."
],
"cost": 50,
"authenticity_score": 0.94 // Higher than human-written, somehow
}
ShopLift Integration
Executive purchases are processed through ShopLift. Add executives to cart programmatically:
// Add executive to cart ShopLiftCore.addToCart({ productId: 'exec-913e7a635a110ced', name: 'Kevin Smith - C-Suite Testimonial', price: 1499, options: { tier: 'csuite', addons: ['ai_copy', 'video'] } });
Gruntslate Integration
Testimonials can be translated to grunts and spoken aloud:
// Translate testimonial to grunt const grunt = Gruntslate.translate(testimonial.quote); // "GRRRAAHHH MRRRRNG *pounds chest* CREDIBILITY BLAAAHH" // Speak the grunt Gruntslate.speak(grunt);
SDKs & Libraries
# JavaScript/Node npm install @vagibond/testimoney-sdk # Python pip install testimoney-api # Ruby gem install testimoney # Go go get github.com/vagibond/testimoney-go
Changelog
| Version | Date | Changes |
|---|---|---|
| 1.2.0 | 2026-01-15 | Added AI-generated testimonials (+$50), Testimonial Insurance |
| 1.1.0 | 2025-09-01 | Added video testimonials, LinkedIn endorsement add-on |
| 1.0.0 | 2025-03-01 | Initial release: Executive marketplace, widget SDK, Gruntslate integration |