Für Entwickler & Agenturen

Die 5Sterne-API

Beauftragen Sie die Löschung von Google- und Trustpilot-Bewertungen aus Ihrer eigenen Software und verfolgen Sie jede Bewertung, bis die Plattform entschieden hat. Für Agenturen, die viele Kundenprofile betreuen, und für Unternehmen mit eigenen Tools.

Finden

Google-Unternehmen suchen und Bewertungen auflisten, schlechteste zuerst.

Beauftragen

Google: Bewertungs-IDs senden, wir lesen sie bei Google nach. Trustpilot: Profil- und Bewertungslinks senden.

Verfolgen

Status und Verlauf je Bewertung: eingereicht, gelöscht, abgelehnt, Widerspruch.

Automatisieren

Lösch-Abo je Google-Profil einschalten: neue 1–3-Sterne-Bewertungen alle 30 Tage.

So erhalten Sie Zugang

  1. Geben Sie einen Auftrag auf 5sterne.net auf. Die API übernimmt daraus Ihre Kontakt- und Rechnungsdaten.
  2. Öffnen Sie Ihren Kundenbereich und beantragen Sie unten auf der Seite den API-Zugang.
  3. Nach der Freischaltung erhalten Sie eine E-Mail mit einem Einmal-Link. Er erstellt Ihren Schlüssel und zeigt ihn einmalig an.
Zum Kundenbereich

Preise

Es gelten dieselben Bedingungen wie auf der Website: 19 € netto pro gelöschter Google-Bewertung, 49 € netto pro gelöschter Trustpilot-Bewertung. Keine Grundgebühr, nichts für abgelehnte Bewertungen. Aufträge und Rechnungen laufen über Ihr Kundenkonto; bezahlt wird mit Ihrer hinterlegten Karte oder Ihrem SEPA-Mandat, sonst per Rechnung. AGB

Schnellstart

1. Unternehmen finden

curl "https://api.5sterne.net/v1/businesses?query=Autohaus%20M%C3%BCller%20Berlin" \
  -H "Authorization: Bearer $API_KEY"

2. Bewertungen auflisten

curl "https://api.5sterne.net/v1/businesses/0x47a84e373f035901%3A0x42120465b5e3b70/reviews?sort=lowest" \
  -H "Authorization: Bearer $API_KEY"

3. Löschung beauftragen

curl -X POST "https://api.5sterne.net/v1/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kunde-42-2026-10-01" \
  -d '{
    "businessDataId": "0x47a84e373f035901:0x42120465b5e3b70",
    "reviewIds": ["ChZDSUhNMG9nS0VJQ0FnSUM..."],
    "termsVersion": "2026-10-price-19-v1",
    "externalReference": "kunde-42"
  }'

4. Trustpilot-Löschung beauftragen

curl -X POST "https://api.5sterne.net/v1/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kunde-43-2026-10-01" \
  -d '{
    "platform": "trustpilot",
    "profileUrl": "https://de.trustpilot.com/review/example.de",
    "reviewUrls": ["https://de.trustpilot.com/reviews/6826c5dc3e443a37c3e1b44a"],
    "termsVersion": "2026-10-price-19-v1"
  }'

5. Auftrag verfolgen

curl "https://api.5sterne.net/v1/orders/ORDER_ID" \
  -H "Authorization: Bearer $API_KEY"

Grundlagen

Basis-URL
https://api.5sterne.net
Authentifizierung
Authorization: Bearer 5s_live_…. Schlüssel werden einmalig angezeigt; widerrufen können Sie sie im Kundenbereich.
Limits
60 Anfragen pro Minute und Schlüssel. Pro Kunde und Tag: 1.000 Google-Abrufe (jede Suche, Bewertungsseite und jede beim Auftrag gelesene Seite).
Wiederholungen
Senden Sie bei jedem Auftrag einen Idempotency-Key-Header. Eine Wiederholung mit demselben Schlüssel liefert den ursprünglichen Auftrag.
Preisänderungen
Aufträge nennen die aktuelle termsVersion (2026-10-price-19-v1). Nach einer Preisänderung erhalten alte Versionen einen 422, statt zum neuen Preis abgerechnet zu werden.
Fehler
RFC-7807-JSON: {"type","title","status","detail"}. 409 und 422 zu Bewertungen nennen zusätzlich die betroffenen reviewIds.
Spezifikation
OpenAPI 3.1: https://api.5sterne.net/v1/openapi.yaml, importierbar in Postman, Insomnia oder einen Client-Generator.

Referenz

Spec

The machine-readable contract.

GET/v1/openapi.yaml(ohne API-Schlüssel)

This specification

Antworten
  • 200OpenAPI document.

Lookup

Find a Google business and the reviews you want removed (Google only; Trustpilot orders name their reviews by link). Each search, each review page, and each page read while placing an order counts towards a daily budget of 1000 Google calls per customer (resets 00:00 UTC).

GET/v1/businesses

Search Google businesses in Germany

Parameter
query Pflicht string Business name and city, e.g. Autohaus Müller Berlin.
Antworten
  • 200Matches.
  • 400RFC 7807 problem.
  • 401RFC 7807 problem.
  • 429RFC 7807 problem.
  • 503RFC 7807 problem.
Antworten 200
data Pflicht Business[]
GET/v1/businesses/{dataId}/reviews

List a business's reviews

Up to 8 reviews on the first page, 18 on later ones. Pass nextPageToken as pageToken for more.

Parameter
dataId (path) Pflicht string dataId from the search, URL-encoded.
sort "lowest" | "newest"
pageToken string
Antworten
  • 200A page of reviews.
  • 400RFC 7807 problem.
  • 401RFC 7807 problem.
  • 429RFC 7807 problem.
  • 503RFC 7807 problem.
Antworten 200
businessDataId Pflicht string
businessName Pflicht string
rating Pflicht number
totalReviews Pflicht integer
data Pflicht LookupReview[]
nextPageToken Pflicht string | null

Orders

Place removal orders and follow each review until the platform decides.

GET/v1/orders

List orders

Newest first. Includes orders placed on the website and by the Lösch-Abo.

Parameter
limit integer
cursor string The nextCursor of the previous page.
Antworten
  • 200A page of orders.
  • 400RFC 7807 problem.
  • 401RFC 7807 problem.
  • 429RFC 7807 problem.
Antworten 200
data Pflicht Order[]
nextCursor Pflicht string | null
POST/v1/orders

Order review removals

Google: we re-read the business's reviews from Google, so every id must be one of its current 1-3 star reviews. Trustpilot: send platform: trustpilot, profileUrl and reviewUrls instead of businessDataId and reviewIds; Trustpilot has no lookup, so the links are the order. Contact and billing data are taken from your latest order. Payment: your saved card or SEPA mandate, otherwise invoice. You are billed only for reviews Google confirms as deleted. Filing starts right away; the call can take several seconds while reviews are read. Each review page read counts towards the daily budget of 1000 Google calls (see Lookup).

Parameter
Idempotency-Key (header) string Retrying with the same key returns the original order (200, Idempotent-Replayed: true) instead of a second one.
Request-Body
platform "google" | "trustpilot" Defaults to google. More platforms may be added.
businessDataId string Google only.
profileUrl string Trustpilot only: the business page, e.g. https://de.trustpilot.com/review/example.de.
reviewUrls string[] Trustpilot only: review links, e.g. https://de.trustpilot.com/reviews/66f1….
reviewIds string[] Google only: review ids from GET /v1/businesses/{dataId}/reviews.
termsVersion Pflicht "2026-10-price-19-v1" Confirms the AGB you order under (19.00 EUR net per deleted Google review, 49.00 EUR net per deleted Trustpilot review). When prices change, old versions are rejected with 422 instead of silently billing a new price.
externalReference string Your own reference, e.g. your client's id. Returned on every order.
Antworten
  • 200Idempotent replay of an earlier order.
  • 201Order placed.
  • 400RFC 7807 problem.
  • 401RFC 7807 problem.
  • 409Some reviews are already part of a live order.
  • 422Unknown reviews (with reviewIds), outdated termsVersion, an Idempotency-Key reused with a different body, no usable payment method, or missing phone number.
  • 429RFC 7807 problem.
  • 503RFC 7807 problem.
Antworten 200
id Pflicht string (uuid)
platform Pflicht "google" | "trustpilot"
externalReference Pflicht string | null
createdAt Pflicht string (date-time)
source Pflicht "website" | "auto_delete" | "api"
businessName Pflicht string
status Pflicht "in_progress" | "completed" completed once no review awaits the platform.
reviewCount Pflicht integer
counts Pflicht Counts
currency Pflicht "EUR"
estimatedNetCents Pflicht integer Net amount if every review were deleted.
billedNetCents Pflicht integer | null Net amount actually billed, once invoiced.
reviews Pflicht Review[]
GET/v1/orders/{orderId}

Get an order with per-review status

Parameter
orderId (path) Pflicht string (uuid)
Antworten
  • 200The order.
  • 401RFC 7807 problem.
  • 404RFC 7807 problem.
  • 429RFC 7807 problem.
Antworten 200
id Pflicht string (uuid)
platform Pflicht "google" | "trustpilot"
externalReference Pflicht string | null
createdAt Pflicht string (date-time)
source Pflicht "website" | "auto_delete" | "api"
businessName Pflicht string
status Pflicht "in_progress" | "completed" completed once no review awaits the platform.
reviewCount Pflicht integer
counts Pflicht Counts
currency Pflicht "EUR"
estimatedNetCents Pflicht integer Net amount if every review were deleted.
billedNetCents Pflicht integer | null Net amount actually billed, once invoiced.
reviews Pflicht Review[]

Profiles

The profiles you have ordered for, and their Lösch-Abo (Google only).

GET/v1/profiles

List your Google profiles

Every Google Maps profile you have ordered for, with totals and Lösch-Abo state.

Antworten
  • 200Profiles.
  • 401RFC 7807 problem.
  • 429RFC 7807 problem.
Antworten 200
data Pflicht Profile[]
PUT/v1/profiles/{dataId}/auto-delete

Switch the Lösch-Abo on or off

Every 30 days we check the profile and order removal of reviews never ordered before (1-3 stars), lowest rating first, up to maxReviewsPerCycle. Each run creates a regular order (source: auto_delete), billed like any other. Sending consentVersion means: "I authorize 5Sterne to request removal of previously unordered negative reviews (1–3 stars) every 30 days, up to my chosen limit. €19 net per successful removal; I can disable this at any time." It is required to switch the Lösch-Abo on or to raise the limit; lowering the limit or switching off needs none. The profile must have been ordered for at least once.

Parameter
dataId (path) Pflicht string
Request-Body
enabled Pflicht boolean
maxReviewsPerCycle integer | null Omit to keep the current limit; null = unlimited.
consentVersion "2026-10-auto-delete-api-v1"
Antworten
  • 200The new state.
  • 400RFC 7807 problem.
  • 401RFC 7807 problem.
  • 404RFC 7807 problem.
  • 422RFC 7807 problem.
  • 429RFC 7807 problem.
Antworten 200
enabled Pflicht boolean
nextCheckAt Pflicht string (date-time) | null
maxReviewsPerCycle Pflicht integer | null null = unlimited.
enrolled Pflicht boolean
Jetzt Bewertung löschen