Ihre Reputationsmanagement-API: REST-Integration für Entwickler
ReputationRadar stellt eine vollständige REST-API bereit, mit der Sie Bewertungsdaten programmatisch abrufen, Sentiment analysieren, Antworten generieren und Automatisierungen auslösen können. SDKs für JavaScript, Python und Go. Sandbox inklusive.
Sie entwickeln eine Kundenplattform und möchten Ihren Nutzern eine einheitliche Ansicht ihres Online-Rufs bieten — Google-Bewertungen, Yelp-Einträge, Branchenverzeichnisse, alles an einem Ort. Das Problem: Reputationsdaten sind fragmentiert. Jede Plattform ist ein Silo. Manuelle Exporte oder Einzelintegrationen kosten Zeit und bieten nicht die Flexibilität, die moderne Anwendungen erfordern.
Oder Sie leiten ein Business-Intelligence-Team und möchten Reputations-KPIs in Ihr Executive-Dashboard integrieren — Bewertungstrends, Sentiment-Entwicklung, Antwortquote — neben Kundenwert, Abwanderungsrate und NPS. Doch Ihre BI-Plattform kann sich nicht nativ mit Google Business Profile oder Yelp verbinden. Individuelle Integrationen wären aufwendig und wartungsintensiv.
ReputationRadar löst diese Probleme mit einer vollständigen Reputationsmanagement-API. Entwickler erhalten programmatischen Zugang zu allen Reputationsdaten und Funktionen: Marken, Bewertungen, Analytik, Antworten, Webhooks. Die API ist REST-basiert, vollständig dokumentiert und über offizielle SDKs in JavaScript, Python und Go verfügbar.
93 % der Verbraucher lesen Bewertungen, bevor sie eine Kaufentscheidung treffen. Unternehmen, die aktiv auf Bewertungen reagieren, verzeichnen bis zu 35 % mehr Conversions. Mit der ReputationRadar-API können Sie diese Daten direkt in Ihre Anwendungen einbetten und Prozesse automatisieren, die bisher manuell waren.
ReputationRadar-API-Übersicht: Endpunkte und Funktionen
Die Reputation-Data-API von ReputationRadar bietet vollständigen programmatischen Zugang zu allen Reputationsmanagement-Funktionen. Alle Endpunkte geben JSON zurück, unterstützen Standard-REST-Konventionen und umfassen eine vollständige Fehlerbehandlung mit aussagekräftigen HTTP-Statuscodes. Die Basis-URL der API lautet https://api.reputationradar.de/v1.
Kern-API-Endpunkte
Brands (Marken)
Verwalten Sie Marken in Ihrem Konto. Erstellen, listen, aktualisieren und löschen Sie Marken. Jede Marke verfügt über eigene Einträge, Bewertungen und Analytik-Daten.
GET /api/v1/brands
GET /api/v1/brands/{id}
PUT /api/v1/brands/{id}
DELETE /api/v1/brands/{id}
Listings (Einträge)
Greifen Sie auf alle entdeckten Einträge einer Marke zu — Google Business Profile, Yelp, TripAdvisor, Trustpilot und weitere. Rufen Sie Eintragdetails, Bewertungen und plattformspezifische Metadaten ab.
GET /api/v1/listings/{id}
POST /api/v1/listings/{id}/sync
Reviews (Bewertungen) — Review-API-Integration
Fragen Sie Bewertungen plattformübergreifend mit umfassenden Filter-, Sortier- und Paginierungsoptionen ab. Greifen Sie auf Bewertungstext, Sterne-Ratings, Reviewer-Informationen und Sentimentanalyse zu. Die Review-Monitoring-API unterstützt Filter nach Plattform, Rating, Sentiment, Zeitraum und Antwortstatus.
GET /api/v1/reviews/{id}
GET /api/v1/reviews?platform=google&rating=1&sentiment=negative
Responses (Antworten)
Verwalten Sie Antworten auf Bewertungen über die API. Generieren Sie KI-gestützte Antwortvorschläge, erstellen Sie manuelle Antworten und verfolgen Sie Antwortstatus sowie Veröffentlichung.
POST /api/v1/reviews/{reviewId}/response
GET /api/v1/reviews/{reviewId}/responses
Analytics (Analytik)
Rufen Sie aggregierte Reputationskennzahlen ab: Health Score, Bewertungstrends, Sentiment-Aufschlüsselung, Antwortquoten, Plattformvergleich und Zeitreihendaten. Ideal für die Einbindung in Dashboards und BI-Berichte.
GET /api/v1/brands/{brandId}/analytics
GET /api/v1/brands/{brandId}/analytics/sentiment
Webhooks
Erhalten Sie Echtzeit-Benachrichtigungen, wenn Bewertungen eingehen, Stimmungsveränderungen auftreten oder Alerts ausgelöst werden. Webhooks senden POST-Anfragen an Ihre URL mit vollständigen Ereignisdaten und HMAC-Signatur zur Verifizierung.
GET /api/v1/webhooks
DELETE /api/v1/webhooks/{id}
API-Code-Beispiele
Beispiel 1: Health Score abrufen (JavaScript)
const axios = require('axios');
const API_KEY = 'sk_live_ihr_schluessel_hier';
const BRAND_ID = 'brand_123';
async function getHealthScore() {
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('Bewertungstrend:', response.data.ratingTrend);
console.log('Antwortquote:', response.data.responseRate);
}
getHealthScore();
Beispiel 2: Aktuelle Bewertungen abfragen (cURL)
# Negative Bewertungen der letzten 7 Tage
curl -X GET "https://api.reputationradar.de/v1/brands/brand_123/reviews?sentiment=negative&sort=newest&limit=50" \
-H "Authorization: Bearer sk_live_ihr_schluessel_hier"
# Antwort (Beispiel):
# {
# "data": [
# {
# "id": "rev_abc",
# "platform": "google",
# "rating": 1,
# "sentiment": "negative",
# "text": "Leider sehr lange Wartezeit...",
# "created_at": "2025-04-10T09:15:00Z"
# }
# ],
# "meta": { "total": 12, "page": 1 }
# }
Beispiel 3: Webhook-Empfänger einrichten (Node.js)
const express = require('express');
const app = express();
app.post('/webhooks/bewertungen', express.json(), (req, res) => {
const { event, data } = req.body;
if (event === 'review.created') {
const { reviewId, rating, sentiment, platform } = data;
if (rating <= 2 || sentiment === 'negative') {
// Slack-Alert bei negativer Bewertung auslösen
sendSlackAlert(`Neue negative Bewertung auf ${platform}: ${reviewId}`);
}
// KI-Antwortvorschlag automatisch generieren
generateResponseSuggestion(reviewId);
}
res.json({ received: true });
});
app.listen(3000, () => console.log('Webhook-Server läuft'));
Authentifizierung, Sicherheit und Rate-Limits
API-Schlüssel und Bearer-Token-Authentifizierung
Alle API-Anfragen erfordern eine Bearer-Token-Authentifizierung. API-Schlüssel werden im ReputationRadar-Dashboard generiert. Jeder Schlüssel ist umgebungsspezifisch (Entwicklung vs. Produktion) und kann auf bestimmte Marken oder Aktionen (nur Lesen, vollständiger Zugriff) eingeschränkt werden. Kompromittierte Schlüssel lassen sich sofort widerrufen.
Rate-Limits nach Tarif
Rate-Limits werden pro API-Schlüssel und Tarif angewendet. Anfragen nach Überschreitung des Limits erhalten den HTTP-Status 429 Too Many Requests. Die verbleibende Quote ist jederzeit in den Antwort-Headern einsehbar.
| Tarif | Anfragen/Monat | Burst |
|---|---|---|
| Starter | 1.000 | 10 Req/s |
| Professional | 10.000 | 10 Req/s |
| Enterprise | Individuell | Individuell |
X-RateLimit-Remaining: 9153
X-RateLimit-Reset: 1714608000
Webhook-Sicherheit
Webhooks enthalten eine HMAC-Signatur im X-Signature-Header. Verifizieren Sie die Signatur, um sicherzustellen, dass der Webhook von ReputationRadar stammt. Alle Webhook-Payloads sind JSON und enthalten einen Zeitstempel. Replay-Angriffe werden durch Zeitstempel-Validierung verhindert.
Sandbox-Umgebung
Jeder API-Tarif beinhaltet eine vollständige Sandbox-Umgebung mit Testdaten. Entwickeln und testen Sie Integrationen, ohne Produktionsdaten zu beeinflussen oder das Rate-Limit zu verbrauchen. Die Sandbox-URL lautet https://api-sandbox.reputationradar.de/v1 und ist strukturell identisch mit der Produktionsumgebung.
Offizielle SDKs: JavaScript, Python, Go
Alle offiziellen SDKs übernehmen Authentifizierung, Rate-Limit-Retries, Fehlerbehandlung und Paginierung automatisch, sodass Sie sich auf Ihre Integrationslogik konzentrieren können. Die SDKs sind Open-Source und werden aktiv gepflegt.
JavaScript/Node.js SDK
npm install @reputationradar/sdk
const ReputationRadar = require('@reputationradar/sdk');
const rr = new ReputationRadar({ apiKey: 'sk_...' });
// Health Score abrufen
const healthScore = await rr.brands.getHealthScore('brand_123');
// Bewertungen filtern
const reviews = await rr.reviews.list('brand_123', {
rating: { $lte: 2 },
sentiment: 'negative'
});
// Antwortvorschlag generieren
const suggestion = await rr.reviews.suggestResponse('review_456');
Python SDK
pip install reputationradar
from reputationradar import ReputationRadar
rr = ReputationRadar(api_key='sk_...')
# Health Score abrufen
health = rr.brands.health_score('brand_123')
print(f"Score: {health.score}, Trend: {health.trend}")
# Bewertungen auflisten
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_..."))
// Health Score abrufen
health, err := client.Brands.HealthScore(ctx, "brand_123")
if err != nil {
log.Fatal(err)
}
// Bewertungen filtern
reviews, err := client.Reviews.List(ctx, "brand_123", &rr.ReviewFilter{
Rating: &rr.NumericFilter{LTE: 2},
Sentiment: "negative",
})
API-Anwendungsfälle: Wo Sie die ReputationRadar-API einsetzen können
Anwendungsfall 1: SaaS-Plattform-Integration
Eine Kundenerfahrungsplattform für kleine Unternehmen integriert die ReputationRadar-API, um Nutzern eine einheitliche Ansicht ihres Online-Rufs zu geben. Benutzer sehen Google-, Yelp- und Facebook-Bewertungen in einem einzigen Dashboard. Die Plattform sendet Benachrichtigungen, wenn neue Bewertungen eingehen, und verwaltet Antwort-Workflows. Endnutzer sehen die Reputations-Funktionen, ohne zu wissen, dass sie von ReputationRadar bereitgestellt werden.
Umsetzung: Webhooks empfangen review.created-Ereignisse. Die Plattform zeigt Bewertungen im eigenen UI. Antwortvorschläge werden über /api/v1/reviews/{id}/suggest-response generiert. Kunden erleben eine nahtlose Oberfläche mit Ihrem Branding — ReputationRadar arbeitet im Hintergrund.
Anwendungsfall 2: Business-Intelligence und Executive-Reporting
Ein BI-Team möchte Reputations-KPIs in sein Executive-Dashboard aufnehmen. Mit den Analytics-Endpunkten der API werden Health Score, Bewertungstrends und Sentiment-Daten täglich abgerufen. Ein geplanter Job extrahiert die Daten und aktualisiert das Data Warehouse. Das Führungsteam sieht Reputationsmetriken neben Umsatz, Kundenwert und NPS — alles in einem Bericht.
Umsetzung: Täglicher Cron-Job fragt /api/v1/brands/{id}/analytics ab. Ergebnisse werden in S3 oder einem Data Warehouse gespeichert. BI-Tool verbindet sich und rendert Dashboards. Reputation wird messbar, vergleichbar, accountable.
Anwendungsfall 3: CRM-Integration und Kundenkontextdaten
Vertriebsmitarbeiter benötigen Kontext, wenn sie Kunden anrufen. Mit der Review-API-Integration wird der Reputationsstatus — Health Score, aktuelle Bewertungen, Sentiment-Trend — direkt im Salesforce-Kontaktdatensatz angezeigt. Webhooks benachrichtigen das Vertriebsteam, wenn ein Interessent Ihr Unternehmen in einer Bewertung erwähnt.
Umsetzung: Salesforce-Integration fragt /api/v1/reviews gefiltert nach Kunden-E-Mail ab. Bewertungen und Sentiment werden in der Salesforce-Sidebar angezeigt. Vertriebsgespräche werden gezielter — weil Sie wissen, was der Kunde zuletzt über Sie geschrieben hat.
Anwendungsfall 4: Automatisierung und Krisenmanagement
Eine Marketing-Automatisierungsplattform nutzt Webhooks, um bei negativen Bewertungen automatisch benachrichtigt zu werden. Der Webhook löst einen Workflow aus, der eine Slack-Benachrichtigung an das Krisenmanagement-Team sendet und ein Ticket im Ticketing-System erstellt. Alles geschieht automatisch — ohne manuelle Schritte, ohne Reaktionsverzögerung.
Umsetzung: Webhook-Empfänger prüft Rating und Sentiment. Bei negativem Signal: Slack-Alert, Jira-Ticket, automatischer Antwortvorschlag via API. Das Team kann innerhalb von Minuten reagieren — nicht erst nach Tagen, wenn der Reputationsschaden bereits eingetreten ist.
Anwendungsfall 5: Einbettbare Widgets und Website-Integration
Zeigen Sie Ihre Reputation direkt auf Ihrer Website. Mit dem JavaScript SDK lassen sich Widgets einbetten, die Health Score, Durchschnittsbewertung und aktuelle Bewertungen anzeigen — vollständig anpassbar in Farbe, Layout und Inhalt. Die Widgets aktualisieren sich automatisch, wenn neue Bewertungen eingehen, und bauen Vertrauen bei Website-Besuchern auf. Studien zeigen, dass 53 % der Nutzer eine Entscheidung überdenken, wenn Sie auf kritische Bewertungen keine Antwort sehen.
API-Preise und Developer-Tarif
Der API-Developer-Tarif beginnt bei 99 € pro Monat und beinhaltet ein monatliches Anfragekontingent, Zugang zur Sandbox-Umgebung, vollständige API-Dokumentation sowie Entwickler-Support. Zusätzliche Anfragen über das inkludierte Kontingent hinaus werden nutzungsbasiert abgerechnet.
Für SaaS-Anbieter und Agenturen, die die API für mehrere Mandanten nutzen, stehen spezielle Enterprise-Tarife mit individuellen Rate-Limits, dedizierten Endpoints und priorisierten Support zur Verfügung. Einen vollständigen Tarifvergleich finden Sie auf der Preisseite.
Die ReputationRadar-API ist Teil des vollständigen Funktionsumfangs von ReputationRadar. Weitere Informationen zur Nutzung der API im Rahmen des Online-Reputationsmanagements sowie spezifische Anwendungsfälle für Agenturen finden Sie in den verlinkten Ressourcen.
Häufig gestellte Fragen
Finden Sie Antworten auf häufige Fragen zu ReputationRadar.
Für wen ist die ReputationRadar-API konzipiert?
Die Reputationsmanagement-API ist für Entwickler und technische Entscheidungsträger konzipiert, die Reputationsdaten programmatisch in eigene Anwendungen, Dashboards oder Automatisierungsworkflows einbinden möchten. Typische Anwender sind SaaS-Plattformen, die ihren Kunden eine Reputationsansicht bieten möchten, BI-Teams, die Reputations-KPIs in Executive-Dashboards einbetten, CRM-Integrationen, die Feedback-Kontext für Vertriebsmitarbeiter bereitstellen, sowie Agenturen, die Reputationsdaten mehrerer Mandanten über eine einzige Schnittstelle verwalten.
Wie authentifiziere ich API-Anfragen?
Alle API-Anfragen erfordern einen API-Schlüssel, der im Authorization-Header als Bearer-Token übergeben wird. Generieren Sie einen API-Schlüssel im Dashboard unter Einstellungen > API-Schlüssel. Der Schlüssel ist geheim und darf niemals in clientseitigem Code offengelegt werden. Alle Anfragen müssen über HTTPS erfolgen. Schlüssel können auf bestimmte Marken oder Aktionen (nur Lesen, vollständiger Zugriff) eingeschränkt und jederzeit widerrufen werden.
Welche Rate-Limits gelten für die API?
Die Starter-API-Stufe erlaubt 1.000 Anfragen pro Monat. Die Professional-Stufe bietet 10.000 Anfragen pro Monat. Für Enterprise-Kunden werden individuelle Limits vereinbart. Alle Stufen beinhalten eine Burst-Toleranz von 10 Anfragen pro Sekunde. Die verbleibende Quote ist in den Antwort-Headern einsehbar: X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset.
Kann ich Webhooks für automatische Benachrichtigungen nutzen?
Ja. Webhooks ermöglichen Echtzeit-Benachrichtigungen bei Ereignissen wie neuen Bewertungen, Stimmungsveränderungen oder ausgelösten Alerts. Konfigurieren Sie Webhooks im Dashboard; ReputationRadar sendet dann POST-Anfragen mit Ereignisdaten an Ihre URL. Jedes Webhook-Paket enthält eine HMAC-Signatur im X-Signature-Header zur Authentizitätsprüfung. So lassen sich externe Systeme wie Slack, Jira oder CRM-Plattformen vollautomatisch auslösen.
Welche Programmiersprachen werden unterstützt?
Die API ist sprachunabhängig (REST über HTTP). Offizielle SDKs stehen für JavaScript/Node.js, Python und Go bereit. Jede andere Sprache, die HTTP-Anfragen unterstützt, kann die REST-Endpunkte direkt ansprechen. Zusätzlich stellen wir eine OpenAPI-Spezifikation zur automatischen Code-Generierung sowie eine Postman-Collection für schnelle Tests bereit.
Was kostet der API-Developer-Tarif?
Der API-Developer-Tarif beginnt bei 99 € pro Monat und beinhaltet ein monatliches Anfragekontingent sowie Zugang zur Sandbox-Umgebung. Zusätzliche Anfragen über das inkludierte Kontingent hinaus werden nach Verbrauch abgerechnet. Detaillierte Preisinformationen und einen Vergleich aller Tarife finden Sie auf unserer Preisseite.
Gibt es eine Sandbox-Umgebung zum Testen?
Ja. Jeder API-Tarif beinhaltet eine Sandbox-Umgebung mit Testdaten. Entwickeln und testen Sie Integrationen gegen Sandbox-Endpunkte, ohne Produktionsdaten zu beeinflussen oder das Rate-Limit zu verbrauchen. Die Sandbox hat eine identische API-Struktur wie die Produktionsumgebung, sodass der Wechsel von Entwicklung zu Produktion ohne Code-Änderungen möglich ist.
Ihre Reputationsdaten programmatisch nutzen
ReputationRadar API: REST-Endpunkte für Bewertungen, Analytik und Webhooks. SDKs für JavaScript, Python und Go. Sandbox-Umgebung inklusive. Ab 99 EUR/Monat.
API-Zugang anfordernKeine Kreditkarte erforderlich. 14-tägige kostenloser Free-Plan.