# LocalSERP Proxy API-Dokumentation

> LocalSERP Proxy REST API unter localserpproxy.com/api: API-Schlüssel, Fehler, Limits und Endpunkte für Guthaben, Aufladungen, Bestellungen und Proxys.

- URL: https://localserpproxy.com/de/docs/api/
- Zuletzt aktualisiert: 2026-10-15
- Publisher: LocalSERP Proxy (https://localserpproxy.com)

Alles, was Sie in Ihrem Konto tun, lässt sich skripten: Guthaben prüfen, mit Krypto bezahlen, einen Tarif kaufen, Proxy-Zugangsdaten erstellen, eine mobile IP wechseln. JSON über HTTPS, ein API-Schlüssel, Beispiele mit curl, Python und Node.js.

## Wie verwende ich die LocalSERP Proxy API?

**Kurzantwort**

Senden Sie HTTPS-Anfragen an `https://localserpproxy.com/api/v1` und geben Sie Ihren API-Schlüssel im Header `Authorization: Bearer API_KEY` an. Erstellen Sie den Schlüssel auf der [Entwicklerseite](https://localserpproxy.com/app/developer?lang=de) Ihres Kontos (oder mit `POST /v1/api-keys`) und weisen Sie ihm nur die erforderlichen Berechtigungen zu. Anfragen und Antworten verwenden JSON; Fehler werden immer als `{ "error": { "code", "message" } }` zurückgegeben.

## Auf einen Blick

| Attribut | Wert |
| --- | --- |
| Basis-URL | `https://localserpproxy.com/api/v1` |
| Format | JSON über HTTPS, UTF-8 |
| Authentifizierung | API-Schlüssel: `Authorization: Bearer API_KEY` |
| Berechtigungen des API-Schlüssels | `read`, `proxies`, `billing` |
| Geldbeträge | USD als Zeichenfolge mit 2 Dezimalstellen (`"29.00"`) |
| Kryptobeträge | Dezimalzahlen als Zeichenfolgen, niemals als Gleitkommazahlen (`"0.00045210"`) |
| Datenverkehr | Bytes (1 GB = 1.000.000.000 Bytes) |
| Daten | ISO 8601 in UTC (`2026-10-05T14:03:11Z`) |
| Version | `/v1` in jedem Pfad |

## Authentifizierung

Jede Anfrage außer dem öffentlichen Katalog erfordert einen API-Schlüssel: `Authorization: Bearer API_KEY`. Ein Schlüssel wird bei der Erstellung **einmal vollständig** angezeigt: Bewahre ihn wie ein Passwort auf. Du kannst einen Schlüssel jederzeit widerrufen; Anfragen mit diesem Schlüssel geben dann `401 unauthorized` zurück.

### Berechtigungsbereiche

Gib jedem Schlüssel nur die Berechtigungen, die dein Skript benötigt. Ein Schlüssel ohne den erforderlichen Berechtigungsbereich gibt `403 forbidden` zurück.

| Berechtigungsbereich | Berechtigung |
| --- | --- |
| `read` | alles lesen (Konto, Guthaben, Dienste, Nutzung). |
| `proxies` | Proxy-Einstellungen und Zugangsdaten ändern (Bezeichnungen, automatische Verlängerung, neue Passwörter), Unterbenutzer verwalten, die IP-Allowlist verwalten und mobile Ports rotieren (einschließlich Rotationslink). |
| `billing` | Bestellungen und Aufladungen erstellen, mit dem Guthaben bezahlen. |

Die einzige Ausnahme ist der **Link zur Rotation mobiler Proxys**. Er ist dafür vorgesehen, über ein Browser-Lesezeichen oder ein einfaches `curl` aufgerufen zu werden: `GET https://localserpproxy.com/api/v1/mobile/PORT_ID/rotate?key=API_KEY` (Schlüssel mit dem Geltungsbereich `proxies`). Siehe [Mobile Ports und IP-Rotation](https://localserpproxy.com/de/docs/api/mobile/).

*Guthaben prüfen*

```bash
curl -s "https://localserpproxy.com/api/v1/balance" \
  -H "Authorization: Bearer $API_KEY"
```

## Anfragen und Antworten

- **JSON rein, JSON raus**: Sende `Content-Type: application/json` mit einem Body.
- **Listen**, die wachsen können, sind mit `page` (ab 1) und `perPage` (1–100, Standardwert 20) paginiert und geben `{ "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } }` zurück. Kurze Listen geben `{ "data": [...] }` zurück.
- **IDs** sind undurchsichtige Zeichenfolgen mit einem Typpräfix: `ord_` (Bestellung), `top_` (Aufladung), `txn_` (Guthabenbewegung), `res_` (Traffic-Abo), `mob_` (mobiler Port), `key_` (API-Schlüssel) und `ipw_` (IP-Allowlist-Eintrag).
- **Sichere Wiederholungen**: `POST /v1/orders` und `POST /v1/topups` akzeptieren einen `Idempotency-Key`-Header (beliebige eindeutige Zeichenfolge, 24 h gespeichert). Bei erneuter Verwendung desselben Schlüssels wird die erste Antwort zurückgegeben, statt erneut zu kaufen oder aufzuladen.
- **Beispiele** zeigen den Aufbau jeder Antwort: Die darin enthaltenen IDs, IPs, Beträge und Daten dienen nur der Veranschaulichung; die Plan-IDs und Preise sind echt.

## Fehler

Alle Fehler haben denselben Body. `code` ist stabil und für deinen Code vorgesehen; `message` ist ein englischer Satz, der sich ändern kann. Validierungsfehler führen jedes ungültige Feld in `fields` auf. Es können neue Codes hinzukommen: Behandle unbekannte Codes als allgemeinen Fehler.

*422 validation_failed*

```json
{
  "error": {
    "code": "validation_failed",
    "message": "Some fields are invalid.",
    "fields": [
      {
        "field": "amountUsd",
        "code": "too_small",
        "message": "The minimum top-up is 25.00 USD."
      }
    ],
    "requestId": "req_2b7c0f"
  }
}
```

### HTTP-Statuscodes

| Status | Bedeutung |
| --- | --- |
| `422` | `validation_failed`: Ein oder mehrere Felder sind ungültig. |
| `401` | `unauthorized`: Token fehlt, ist ungültig oder abgelaufen. |
| `402` | `insufficient_balance`: Das Guthaben reicht für die Bestellung nicht aus. `details` = `InsufficientBalanceDetails`. |
| `403` | `forbidden`: Dem API-Schlüssel fehlt der erforderliche Scope oder das Konto ist gesperrt. |
| `404` | `not_found`: Die Ressource existiert nicht oder gehört zu einem anderen Konto. |
| `409` | `conflict` (oder ein spezifischerer Code): Die Aktion ist im aktuellen Status nicht möglich. |
| `429` | `rate_limited` oder `rotation_too_soon`. |

## Ratenbegrenzungen

Jede Antwort enthält `RateLimit-Limit`, `RateLimit-Remaining` und `RateLimit-Reset`. Bei Überschreitung des Limits antwortet die API mit `429 rate_limited` und einem `Retry-After`-Header (Sekunden): Warte so lange und versuche es dann erneut. Die IP eines mobilen Ports kann höchstens alle 30 Sekunden geändert werden (`429 rotation_too_soon`, mit `Retry-After`).

## API-Referenz

- **[Konto und Guthaben](https://localserpproxy.com/de/docs/api/account/)** — Rufe deine Kontoeinstellungen, dein vorausbezahltes USD-Guthaben und alle Kontobewegungen (Aufladungen, Käufe, Rückerstattungen) ab.
- **[Krypto-Aufladungen](https://localserpproxy.com/de/docs/api/top-ups/)** — Lade dein Guthaben mit Krypto auf: Rufe die Einzahlungsadresse und den genauen Betrag ab, sende genau diesen Betrag, melde die Zahlung als gesendet (die Transaktions-ID ist optional) und verfolge anschließend die Aufladung, bis das Guthaben gutgeschrieben ist. Mit dem Guthaben kannst du jeden unserer Tarife bezahlen.
- **[Bestellungen](https://localserpproxy.com/de/docs/api/orders/)** — Rufe die Tarife und ihre Preise ab, kaufe einen Tarif mit deinem Guthaben (neuer Dienst, mehr Traffic oder Verlängerung eines Ports) und sieh dir deine bisherigen Bestellungen an.
- **[Residential-Proxys und Zugangsdaten](https://localserpproxy.com/de/docs/api/residential/)** — Verwalte Traffic-Abos (Residential und rotierende 4G/5G pro GB): Proxy-Zugangsdaten, Unterbenutzer mit eigenen Zugangsdaten und Traffic-Limit, tägliche Nutzung und die Standorte, die du im Proxy-Benutzernamen angeben kannst.
- **[Mobile Ports und IP-Rotation](https://localserpproxy.com/de/docs/api/mobile/)** — Dedizierte 4G/5G-Ports: Ändere die IP jetzt oder nach Zeitplan, nutze den Rotationslink und lies den täglichen Traffic ab.
- **[API-Schlüssel und IP-Allowlist](https://localserpproxy.com/de/docs/api/api-keys/)** — Erstelle und widerrufe API-Schlüssel mit eingeschränkten Berechtigungen und verwalte die IP-Allowlist: Bis zu 10 Quell-IPs dürfen die Proxys ohne Benutzername und Passwort nutzen.

> **Per Skript bezahlen** Tarife werden immer über das vorausbezahlte USD-Guthaben bezahlt. Lade dein Guthaben mit Krypto auf (mindestens 25.00 USD) über POST /v1/topups und kaufe anschließend über POST /v1/orders. Beides ist in einem Aufruf möglich: Eine Aufladung kann die Bestellung in purchase enthalten, und der Tarif wird gekauft, sobald das Guthaben gutgeschrieben ist.

---

LocalSERP Proxy: LocalSERP Proxy ist ein US-Residential-Proxy-Dienst zur stadtweisen Prüfung lokaler Suchergebnisse, Anzeigen und Preise, mit Kryptozahlung und ohne Hochladen eines Ausweisdokuments.