Your Reputation Management API: REST Integration for Developers
ReputationRadar delivers a complete REST API for programmatic access to review data, sentiment analysis, response generation, and real-time webhooks. SDKs for JavaScript, Python, and Go. Sandbox included.
You're building a customer experience platform. Your goal is to give your clients a unified view of customer feedback across all channels: support tickets, social media, reviews, and surveys. But reputation data is siloed. Review sites like Google and Yelp aren't connected to your platform. You'd have to manually pull data or use limited integrations that don't give you the flexibility you need.
Or you're a business intelligence team. You want to include reputation metrics in your executive dashboard alongside customer lifetime value, churn rate, and satisfaction scores. But your BI platform can't natively connect to Google Business Profile or Yelp. You'd need custom integrations or manual data exports that are slow, brittle, and difficult to maintain.
The ReputationRadar reputation management API solves these problems. It gives developers programmatic access to all reputation data and functionality: brands, reviews, analytics, responses, webhooks. The API is REST-based, fully documented, and available through official SDKs for JavaScript, Python, and Go.
93% of consumers read reviews before making a purchase decision. Businesses that actively respond to reviews see up to 35% more conversions. With the ReputationRadar API, you can embed that data directly into your applications and automate processes that were previously manual.
ReputationRadar API Overview
The ReputationRadar reputation data API provides complete programmatic access to reputation management capabilities. All API endpoints return JSON, support standard REST conventions, and include comprehensive error handling and rate limiting. The API base URL is https://api.reputationradar.de/v1.
Core API Endpoints
Brands
Manage brands within your account. Create, list, update, and delete brands. Each brand has its own set of listings, reviews, and analytics.
GET /api/v1/brands
GET /api/v1/brands/{id}
PUT /api/v1/brands/{id}
DELETE /api/v1/brands/{id}
Listings
Access all discovered listings for a brand (Google Business Profile, Yelp, TripAdvisor, Trustpilot, and more). Retrieve listing details, ratings, and platform-specific metadata.
GET /api/v1/listings/{id}
POST /api/v1/listings/{id}/sync
Reviews — Review Monitoring API
Query reviews across all platforms with comprehensive filtering, sorting, and pagination. Access review text, ratings, reviewer info, and sentiment analysis. The review API integration supports filters by platform, rating, sentiment, date range, and response status.
GET /api/v1/reviews/{id}
GET /api/v1/reviews?platform=google&rating=1&sentiment=negative
Responses
Manage your responses to reviews. Generate AI response suggestions, create manual responses, track response status and posting.
POST /api/v1/reviews/{reviewId}/response
GET /api/v1/reviews/{reviewId}/responses
Analytics
Retrieve aggregated reputation metrics: Health Score, ratings trends, sentiment breakdown, response rates, platform comparison, and time-series data for dashboards and reports.
GET /api/v1/brands/{brandId}/analytics
GET /api/v1/brands/{brandId}/analytics/sentiment
Webhooks
Receive real-time notifications when reviews arrive, sentiment changes occur, or alerts trigger. Configure webhooks to automatically drive automations in external systems. Each delivery includes HMAC signature verification.
GET /api/v1/webhooks
DELETE /api/v1/webhooks/{id}
API Code Examples
Example 1: Get Health Score (JavaScript)
const axios = require('axios');
const API_KEY = 'your_api_key_here';
const BRAND_ID = 'brand_123';
async function getHealthScore() {
try {
const response = await axios.get(
`https://api.reputationradar.de/v1/brands/${BRAND_ID}/health-score`,
{
headers: { 'Authorization': `Bearer ${API_KEY}` }
}
);
console.log('Health Score:', response.data.score);
console.log('Rating Trend:', response.data.ratingTrend);
console.log('Response Rate:', response.data.responseRate);
} catch (error) {
console.error('API Error:', error.response.data);
}
}
getHealthScore();
Example 2: Query Recent Reviews (Python)
import requests
from datetime import datetime, timedelta
API_KEY = 'your_api_key_here'
BRAND_ID = 'brand_123'
# Get reviews from last 7 days
seven_days_ago = (datetime.now() - timedelta(days=7)).isoformat()
response = requests.get(
f'https://api.reputationradar.de/v1/brands/{BRAND_ID}/reviews',
headers={'Authorization': f'Bearer {API_KEY}'},
params={
'since': seven_days_ago,
'sort': 'newest',
'limit': 50
}
)
reviews = response.json()['data']
for review in reviews:
print(f"{review['rating']} stars - {review['platform']}")
print(f"Sentiment: {review['sentiment']}")
print(f"Text: {review['text'][:100]}...")
print('---')
Example 3: Generate & Post Response (cURL)
# Step 1: Generate AI response suggestion
curl -X POST https://api.reputationradar.de/v1/reviews/review_456/suggest-response \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json"
# Response:
# {
# "suggestion": "Thank you for your feedback. We're sorry you experienced a delay...",
# "confidence": 0.92,
# "platform": "google"
# }
# Step 2: Post the response
curl -X POST https://api.reputationradar.de/v1/reviews/review_456/response \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"text": "Thank you for your feedback. We are sorry you experienced a delay...",
"platform": "google"
}'
Example 4: Real-time Webhooks (Node.js)
const express = require('express');
const app = express();
app.post('/webhooks/reviews', express.json(), (req, res) => {
const { event, data } = req.body;
if (event === 'review.created') {
const { reviewId, rating, sentiment, platform } = data;
if (rating <= 2 || sentiment === 'negative') {
// Trigger alert for negative reviews
sendSlackAlert(`New negative review on ${platform}: ${reviewId}`);
}
// Auto-generate response suggestion
generateAndSuggestResponse(reviewId);
}
res.json({ received: true });
});
app.listen(3000, () => console.log('Webhook server running'));
API Use Cases: Real-World Integration Patterns
Use Case 1: BI Integration & Executive Dashboard
Your executive team wants reputation metrics in their BI dashboard alongside other KPIs. Build a data pipeline that queries the Analytics endpoint daily, stores results in your data warehouse, and visualizes Health Score, rating trends, and sentiment breakdown in Tableau or Power BI.
Implementation: Scheduled job (Lambda, cron) queries /api/v1/brands/{id}/analytics daily. Store results in S3. Connect BI tool to S3. Executives see real-time reputation metrics alongside revenue, churn, and NPS data. Reputation becomes measurable, accountable, and comparable to other business metrics.
Use Case 2: CRM Integration & Customer Context
Sales teams need context when calling customers. Show reputation data (Health Score, recent feedback, sentiment trends) in the Salesforce contact record. Use webhooks to alert sales when a prospect or customer mentions your company in a review.
Implementation: Custom Salesforce integration queries /api/v1/reviews filtered by customer phone or email. Display reviews and sentiment in Salesforce sidebar. Sales calls become more informed. Relationships improve because you have real customer feedback context before the conversation starts.
Use Case 3: Customer Experience Platform & Feedback Loop
You're building a unified customer experience platform. Ingest reputation data alongside support tickets, survey responses, and social media mentions. Use webhooks to automatically trigger support tickets when negative reviews arrive, closing the loop between external feedback and internal action.
Implementation: Webhook receiver listens for review.created events. Parse review sentiment. If negative, automatically create Jira or Zendesk ticket tagged with reviewer context. Support team investigates and reaches out. Feedback becomes actionable intelligence that improves operations rather than sitting in a separate portal.
Use Case 4: Multi-Location Management & Heatmaps
You're managing 50+ locations. Build a geographic dashboard showing Health Score and rating trends by location. Identify underperforming locations quickly. Analyze what high-performing locations are doing right and replicate it across the chain.
Implementation: Create location sub-brands in ReputationRadar. Query /api/v1/brands for all locations. Fetch Health Score for each. Render on map. Click locations to drill into reviews and trends. Management can immediately identify which locations need operational improvements.
Use Case 5: Embeddable Widgets & Website Integration
Display your reputation on your website. Embed a widget showing your Health Score, aggregate rating, recent reviews, and review counts. Automatically updates as new reviews arrive. Builds trust with website visitors — 53% of users reconsider a decision when they see no response to a critical review.
Implementation: Include single script tag from ReputationRadar JS SDK. Configure brand ID and widget type. Widget renders on page, pulls live data via API. Fully customizable (colors, layout, content). Works on WordPress, Webflow, or any custom site. No build process required.
Authentication, Security & Rate Limiting
API Keys & Bearer Token Authentication
All API requests require Bearer token authentication. Generate API keys in the ReputationRadar dashboard. Each key is environment-specific (development vs. production) and can be scoped to specific brands or actions (read-only, full access). Revoke keys instantly if compromised.
Rate Limiting by Tier
API rate limits are applied per API key and per tier. Requests after the limit is consumed return HTTP 429 Too Many Requests. Rate limit headers show remaining quota at all times.
| Tier | Requests/month | Burst |
|---|---|---|
| Starter | 1,000 | 10 req/s |
| Professional | 10,000 | 10 req/s |
| Enterprise | Custom | Custom |
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1714608000
Webhook Security
Webhooks include an HMAC signature in the X-Signature header. Verify the signature to confirm the webhook came from ReputationRadar. All webhook payloads are JSON and include a timestamp. Replay attacks are prevented through timestamp validation. Failed deliveries are retried automatically with exponential backoff.
Sandbox Environment
Every API tier includes a sandbox endpoint for testing. Sandbox uses identical API structure to production with test data. Develop and test without affecting production or consuming rate limits. Generate test events manually to validate webhook integrations before going live.
Production: https://api.reputationradar.de/v1
Official SDKs: JavaScript, Python, Go
All official SDKs handle authentication, rate limit retries, error handling, and pagination automatically, so you can focus on your integration logic rather than boilerplate. SDKs are open-source on GitHub. Contributions and feature requests are welcome.
JavaScript/Node.js SDK
npm install @reputationradar/sdk
const ReputationRadar = require('@reputationradar/sdk');
const rr = new ReputationRadar({ apiKey: 'sk_...' });
// Get Health Score
const healthScore = await rr.brands.getHealthScore('brand_123');
// Query reviews
const reviews = await rr.reviews.list('brand_123', {
rating: { $lte: 2 },
sentiment: 'negative'
});
// Generate response suggestion
const suggestion = await rr.reviews.suggestResponse('review_456');
Python SDK
pip install reputationradar
from reputationradar import ReputationRadar
rr = ReputationRadar(api_key='sk_...')
# Get Health Score
health = rr.brands.health_score('brand_123')
print(f"Score: {health.score}, Trend: {health.trend}")
# List reviews
reviews = rr.reviews.list('brand_123',
rating__lte=2,
sentiment='negative'
)
for review in reviews:
print(f"{review.text} ({review.platform})")
Go SDK
import "github.com/reputationradar/sdk-go"
client := rr.NewClient(rr.WithAPIKey("sk_..."))
// Get Health Score
health, err := client.Brands.HealthScore(ctx, "brand_123")
if err != nil {
log.Fatal(err)
}
// List reviews
reviews, err := client.Reviews.List(ctx, "brand_123", &rr.ReviewFilter{
Rating: &rr.NumericFilter{LTE: 2},
Sentiment: "negative",
})
Developer Resources & Pricing
Documentation & Tooling
- → OpenAPI Specification: Full API spec for code generation in any language
- → Postman Collection: Pre-built requests for quick testing against sandbox or production
- → Interactive Playground: Test API endpoints in browser with live sandbox data
- → Integration Guides: Step-by-step tutorials for Salesforce, Tableau, Zapier, and more
- → GitHub Repository: SDKs, example integrations, and issue tracking
API Developer Tier Pricing
The API Developer tier starts at 99 EUR per month and includes a monthly request quota, sandbox access, full API documentation, and developer support. Additional requests beyond the included quota are billed on a usage basis. Enterprise tiers with custom rate limits, SLA guarantees, and dedicated technical support are available for agencies and SaaS providers with multi-tenant requirements.
See the pricing page for a complete tier comparison. The API is part of ReputationRadar's full feature set. For broader context on programmatic reputation management, see our online reputation management guide. Agency-specific use cases are covered in the agencies section.
Support Options
Starter API tier includes standard support (24–48 hour response). Professional tier includes priority support (4-hour response). Enterprise tier includes dedicated technical support with direct access to the engineering team. Developers can ask questions in the community Slack, file issues on GitHub, or contact support directly.
Frequently Asked Questions
Find answers to common questions about ReputationRadar.
What is the ReputationRadar API?
The ReputationRadar API is a REST API that exposes all core reputation management functionality: review monitoring, sentiment analysis, response generation, and analytics. It allows developers to integrate reputation data into custom applications, BI platforms, CRM systems, or proprietary dashboards. All API endpoints are fully documented with code examples in JavaScript, Python, and cURL.
What rate limits apply to the API?
Starter API tier allows 1,000 requests/month. Professional tier provides 10,000 requests/month. Enterprise tier includes custom rate limits and dedicated support. All tiers include burst allowance of 10 requests/second. Additional requests can be purchased on a usage-based basis. Most integrations consume fewer than 100 requests/month after initial sync.
Do you offer a sandbox environment?
Yes. Every API tier includes a sandbox environment with test data. Develop and test integrations against sandbox endpoints without affecting production data or consuming rate limits. The sandbox has an identical API structure to production, making it straightforward to move from development to production without code changes. Trigger test events manually to validate webhook integrations.
Which programming languages are supported?
Official SDKs are available for JavaScript/Node.js, Python, and Go. The underlying API is REST with JSON payloads, so it works with any language that supports HTTP requests. We provide cURL examples for manual API calls and an OpenAPI specification for code generation in other languages.
Can I embed ReputationRadar widgets in my application?
Yes. The JavaScript SDK provides embeddable widgets for displaying ratings, review streams, and health scores on your website or web application. Widgets are fully customizable (colors, layout, branding) and automatically update as new reviews arrive. No build process required—embed a single script tag and configure with JSON.
How does webhook security work?
Every webhook delivery includes an HMAC signature in the X-Signature header. Verify the signature using your webhook secret to confirm the payload came from ReputationRadar and has not been tampered with. All webhook payloads are JSON and include a timestamp. Replay attacks are prevented through timestamp validation. Failed deliveries are retried with exponential backoff.
What does the API Developer tier cost?
The API Developer tier starts at 99 EUR per month and includes a monthly request quota, sandbox access, full API documentation, and developer support. Additional requests beyond the included quota are billed on a usage basis. Enterprise tiers with custom rate limits and SLA guarantees are available for agencies and SaaS providers with multi-tenant requirements. See the pricing page for a full tier comparison.
Build Custom Integrations with Your Reputation Management API
ReputationRadar REST API: endpoints for reviews, analytics, and webhooks. SDKs for JavaScript, Python, and Go. Full documentation, sandbox environment, and dedicated developer support. From 99 EUR/month.
Request API AccessNo credit card required. free plan.