Für Entwickler & Agenturen

Die 5Sterne-API

Beauftragen Sie die Löschung von Google-Bewertungen aus Ihrer eigenen Software und verfolgen Sie jede Bewertung, bis Google 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

Bewertungs-IDs senden. Wir lesen sie bei Google nach und reichen die Meldungen ein.

Verfolgen

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

Automatisieren

Lösch-Abo je 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 Bewertung, deren Löschung Google bestätigt. 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. 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. 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 Google 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

We re-read the business's reviews from Google, so every id must be one of its current 1-3 star reviews. 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
businessDataId Pflicht string
reviewIds Pflicht string[] Google 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 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)
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 Google.
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)
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 Google.
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 Google profiles you have ordered for, and their Lösch-Abo.

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