/v1/openapi.yaml(ohne API-Schlüssel)This specification
Antworten
200OpenAPI document.
Für Entwickler & Agenturen
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.
Google-Unternehmen suchen und Bewertungen auflisten, schlechteste zuerst.
Google: Bewertungs-IDs senden, wir lesen sie bei Google nach. Trustpilot: Profil- und Bewertungslinks senden.
Status und Verlauf je Bewertung: eingereicht, gelöscht, abgelehnt, Widerspruch.
Lösch-Abo je Google-Profil einschalten: neue 1–3-Sterne-Bewertungen alle 30 Tage.
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
curl "https://api.5sterne.net/v1/businesses?query=Autohaus%20M%C3%BCller%20Berlin" \
-H "Authorization: Bearer $API_KEY" curl "https://api.5sterne.net/v1/businesses/0x47a84e373f035901%3A0x42120465b5e3b70/reviews?sort=lowest" \
-H "Authorization: Bearer $API_KEY" 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"
}' 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"
}' curl "https://api.5sterne.net/v1/orders/ORDER_ID" \
-H "Authorization: Bearer $API_KEY" https://api.5sterne.netAuthorization: Bearer 5s_live_…. Schlüssel werden einmalig angezeigt; widerrufen können Sie sie im Kundenbereich.Idempotency-Key-Header. Eine Wiederholung mit demselben Schlüssel liefert den ursprünglichen Auftrag.termsVersion (2026-10-price-19-v1). Nach einer Preisänderung erhalten alte Versionen einen 422, statt zum neuen Preis abgerechnet zu werden.{"type","title","status","detail"}. 409 und 422 zu Bewertungen nennen zusätzlich die betroffenen reviewIds.The machine-readable contract.
/v1/openapi.yaml(ohne API-Schlüssel)200OpenAPI document.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).
/v1/businesses query Pflicht | string | Business name and city, e.g. Autohaus Müller Berlin. |
200Matches.400RFC 7807 problem.401RFC 7807 problem.429RFC 7807 problem.503RFC 7807 problem. data Pflicht | Business[] |
/v1/businesses/{dataId}/reviewsUp to 8 reviews on the first page, 18 on later ones. Pass nextPageToken as pageToken for more.
dataId (path) Pflicht | string | dataId from the search, URL-encoded. |
sort | "lowest" | "newest" | |
pageToken | string |
200A page of reviews.400RFC 7807 problem.401RFC 7807 problem.429RFC 7807 problem.503RFC 7807 problem. businessDataId Pflicht | string | |
businessName Pflicht | string | |
rating Pflicht | number | |
totalReviews Pflicht | integer | |
data Pflicht | LookupReview[] | |
nextPageToken Pflicht | string | null |
Place removal orders and follow each review until the platform decides.
/v1/ordersNewest first. Includes orders placed on the website and by the Lösch-Abo.
limit | integer | |
cursor | string | The nextCursor of the previous page. |
200A page of orders.400RFC 7807 problem.401RFC 7807 problem.429RFC 7807 problem. data Pflicht | Order[] | |
nextCursor Pflicht | string | null |
/v1/ordersGoogle: 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).
Idempotency-Key (header) | string | Retrying with the same key returns the original order (200, Idempotent-Replayed: true) instead of a second one. |
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. |
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. 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[] |
/v1/orders/{orderId} orderId (path) Pflicht | string (uuid) |
200The order.401RFC 7807 problem.404RFC 7807 problem.429RFC 7807 problem. 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[] |
The profiles you have ordered for, and their Lösch-Abo (Google only).
/v1/profilesEvery Google Maps profile you have ordered for, with totals and Lösch-Abo state.
200Profiles.401RFC 7807 problem.429RFC 7807 problem. data Pflicht | Profile[] |
/v1/profiles/{dataId}/auto-deleteEvery 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.
dataId (path) Pflicht | string |
enabled Pflicht | boolean | |
maxReviewsPerCycle | integer | null | Omit to keep the current limit; null = unlimited. |
consentVersion | "2026-10-auto-delete-api-v1" |
200The new state.400RFC 7807 problem.401RFC 7807 problem.404RFC 7807 problem.422RFC 7807 problem.429RFC 7807 problem. enabled Pflicht | boolean | |
nextCheckAt Pflicht | string (date-time) | null | |
maxReviewsPerCycle Pflicht | integer | null | null = unlimited. |
enrolled Pflicht | boolean |