# SERP-API-Schnellstart: Ihre erste Suche in curl, Python und Node.js > Erste SerpCrypto-Suche mit curl, Python oder Node.js: Schlüssel holen, Endpunkt aufrufen, JSON lesen, Credits prüfen. Ohne KYC, mit Krypto zahlen. - URL: https://serpcrypto.com/de/docs/ - Zuletzt aktualisiert: 2026-10-22 - Herausgeber: SerpCrypto (https://serpcrypto.com) Ein HTTPS-Endpunkt, ein API-Schlüssel, ein Credit pro erfolgreicher Suche. Diese Seite führt Sie von einem leeren Konto zu einer geparsten Google-Suchergebnisseite und verweist für alles Weitere auf die Referenz. **Kurze Antwort — Wie stelle ich meine erste SERP-API-Anfrage mit SerpCrypto?** Kaufen Sie ein Credit-Paket, kopieren Sie den API-Schlüssel aus Ihrem Dashboard und senden Sie `GET https://serpcrypto.com/api/v1/search?q=your+query` mit dem Header `Authorization: Bearer YOUR_KEY`. **SerpCrypto** antwortet mit der Ergebnisseite als JSON und berechnet 1 Credit nur, wenn die Suche erfolgreich ist. 10.000 Suchanfragen kosten 7,50 $, mit Krypto bezahlt und ohne KYC, und Credits verfallen nie. ## Die API auf einen Blick | Attribut | Wert | | --- | --- | | Basis-URL | `https://serpcrypto.com/api/v1` | | Suche | `GET https://serpcrypto.com/api/v1/search` | | Credits | `GET https://serpcrypto.com/api/v1/credits` (kostenlos) | | Authentifizierung | Ein API-Schlüssel im Authorization-Header (Bearer) oder im api_key-Query-Parameter | | Engines | Google Search, Google News, Google Images, Google Maps (lokale Ergebnisse), Google Shopping und Bing | | Abrechnung | 1 Credit = 1 erfolgreiche Suchanfrage, die eine Ergebnisseite auf jeder unterstützten Engine liefert. Eine fehlgeschlagene Anfrage wird nicht berechnet | | Verfall von Credits | Vorausbezahlte Such-Credits verfallen nie: ungenutzte Suchen bleiben auf Ihrem Konto, bis Sie sie verwenden | | Format | JSON über HTTPS, UTF-8 | ## Wie bekomme ich einen API-Schlüssel? Vier Schritte. Kein Ausweis, kein Selfie, keine Dokumente und keine E-Mail, außer Sie möchten eine. 1. **Konto eröffnen** — Login per Kontonummer; E-Mail ist optional. Speichern Sie die Kontonummer in einem Passwort-Manager: Sie ist Ihr Login. 2. **Mit Krypto aufladen** — Senden Sie mindestens 25 $ in BTC, USDT, USDC, ETH, SOL, LTC. Das Guthaben wird nach den Netzwerkbestätigungen gutgeschrieben, die auf der Zahlungsseite aufgeführt sind. 3. **Credit-Paket kaufen** — 10.000 Suchanfragen für 7,50 $ reicht, um jede Engine zu testen. Größere Pakete senken den Preis auf 0,30 $/1K Suchanfragen. Siehe Preise. 4. **Schlüssel kopieren** — Ihr API-Schlüssel erscheint in Ihrem Dashboard, sobald Sie ein Credit-Pack von Ihrem bestätigten Krypto-Guthaben kaufen. Bewahren Sie ihn in einer Umgebungsvariablen namens SERPCRYPTO_API_KEY auf, niemals in einem Code-Repository. ## Wie führe ich meine erste Suche mit curl aus? Exportieren Sie den Schlüssel einmal und senden Sie dann eine GET-Anfrage. Das Flag `-G` mit `--data-urlencode` baut den Query-String und kodiert Leerzeichen und Akzente für Sie. Die Antwort ist ein einzelnes JSON-Dokument, und `jq` hält es in einem Terminal lesbar. Das Beispiel fragt Google, die Standard-Engine, nach US-Ergebnissen auf Englisch. Ändern Sie `q`, `gl` oder `hl` und führen Sie es erneut aus: Jeder erfolgreiche Lauf verbraucht einen Credit. *curl + jq: die ersten drei organischen Ergebnisse* ```bash export SERPCRYPTO_API_KEY="paste-your-key-here" curl -sG "https://serpcrypto.com/api/v1/search" \ -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \ --data-urlencode "q=best espresso grinder" \ -d gl=us -d hl=en | jq '.organic_results[:3]' ``` ## Wie führe ich dieselbe Suche in Python aus? Verwenden Sie einen beliebigen HTTP-Client. Mit `requests` übergeben Sie die Parameter als Dictionary und den Schlüssel im Header. `raise_for_status()` macht aus einer Fehlerantwort, etwa `401` bei einem falschen Schlüssel, eine Exception, die Sie abfangen können. *Python 3.9+ mit requests* ```python import os import requests API_URL = "https://serpcrypto.com/api/v1/search" API_KEY = os.environ["SERPCRYPTO_API_KEY"] response = requests.get( API_URL, params={"q": "best espresso grinder", "gl": "us", "hl": "en"}, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=60, ) response.raise_for_status() data = response.json() print("credits used:", data["search_metadata"]["credits_used"]) for result in data.get("organic_results", [])[:3]: print(result["position"], result["title"], result["link"]) ``` ## Und in Node.js? Node.js 18 und später liefern `fetch` mit, es wird also kein Paket benötigt. Speichern Sie die Datei mit der Erweiterung `.mjs`, um `await` auf oberster Ebene zu verwenden, und führen Sie dann `node first-search.mjs` aus. *Node.js 18+ mit dem eingebauten fetch* ```javascript // first-search.mjs (Node.js 18 or later: fetch and top-level await are built in) const API_URL = "https://serpcrypto.com/api/v1/search"; const params = new URLSearchParams({ q: "best espresso grinder", gl: "us", hl: "en" }); const response = await fetch(`${API_URL}?${params}`, { headers: { Authorization: `Bearer ${process.env.SERPCRYPTO_API_KEY}` }, }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${await response.text()}`); } const data = await response.json(); console.log("credits used:", data.search_metadata.credits_used); for (const result of (data.organic_results ?? []).slice(0, 3)) { console.log(result.position, result.title, result.link); } ``` ## Wie prüfe ich, wie viele Credits mir noch bleiben? Rufen Sie `GET https://serpcrypto.com/api/v1/credits` mit demselben Schlüssel auf. Der Aufruf ist kostenlos und liefert drei Zahlen: verbleibende Credits, heute verbrauchte Credits und wie viele Suchanfragen Ihr Konto gleichzeitig ausführen darf. Jedes Konto kann eine festgelegte Anzahl von Suchen gleichzeitig ausführen; das Limit wird in Ihrem Dashboard angezeigt und auf Anfrage erhöht. *Ihre Credits abrufen* ```bash curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY" ``` *Antwort (Beispielwerte)* ```json { "credits_remaining": 84210, "credits_used_today": 1290, "concurrency_limit": 10 } ``` ## Was kommt von einer Suchanfrage zurück? Jede Antwort hat bei allen Engines denselben Rahmen. `search_metadata` sagt, ob die Suche erfolgreich war und wie viele Credits sie verbraucht hat. `search_parameters` wiederholt die angewendeten Einstellungen, einschließlich der Standardwerte. Danach folgt ein Array oder Objekt pro Block der Ergebnisseite, etwa `organic_results` oder `people_also_ask`. Ein Block ist nur vorhanden, wenn die Seite ihn anzeigt, daher lesen Sie ihn mit einem Standardwert aus. Die Seite [Antwortformat](https://serpcrypto.com/de/docs/response/) beschreibt jeden Block und jedes Feld. *Aufbau einer Google-Antwort (gekürzt, illustrative Werte)* ```json { "search_metadata": { "id": "srch_7f3a9c2e41b8", "status": "success", "engine": "google", "credits_used": 1 }, "search_parameters": { "engine": "google", "q": "best espresso grinder", "gl": "us", "hl": "en", "page": 1 }, "search_information": { "total_results": 18600000, "query_displayed": "best espresso grinder" }, "organic_results": [ { "position": 1, "title": "…", "link": "https://www.example.com/…", "snippet": "…" } ], "people_also_ask": [ { "question": "…", "snippet": "…", "link": "https://www.example.org/…" } ], "related_searches": [ { "query": "best espresso grinder under 300" } ], "pagination": { "current": 1, "next_page": 2 } } ``` ## Welche Parameter werde ich zuerst nutzen? Die vollständige Liste mit Standardwerten und erlaubten Werten finden Sie in der [API-Referenz](https://serpcrypto.com/de/docs/search/). | Parameter | Beispiel | Was er tut | | --- | --- | --- | | `q` | `best espresso grinder` | Die Suchanfrage, wie ein Mensch sie eintippen würde. Erforderlich. | | `engine` | `google_news` | Welche Engine und welche Vertikale durchsucht werden soll. Standard `google`. | | `gl` | `de` | Land der Ergebnisse, zwei Buchstaben. Standard `us`. | | `hl` | `de` | Sprache der Oberfläche. Standard `en`. | | `location` | `Austin, Texas, United States` | Ein Ort auf Stadtebene für lokale Ergebnisse. | | `device` | `mobile` | `desktop` (Standard) oder `mobile` Ergebnisse. | | `page` | `2` | Ergebnisseite, 1 bis 10. Jede Seite kostet einen Credit. | ## Was kostet eine Suchanfrage, und wann ist sie kostenlos? 1 Credit = 1 erfolgreiche Suchanfrage, die eine Ergebnisseite auf jeder unterstützten Engine liefert. Eine fehlgeschlagene Anfrage wird nicht berechnet. Etwa 10 organische Ergebnisse pro Seite, so wie Google sie liefert, seit num=100 im September 2025 nicht mehr berücksichtigt wird; jede weitere Seite kostet einen weiteren Credit. Eine Anfrage, die wegen eines falschen Parameters, eines falschen Schlüssels, eines leeren Guthabens oder eines ausgelasteten Kontos abgelehnt wird, ist ebenfalls kostenlos, und jeder Aufruf des Credits-endpoints ist es auch. Die Preise reichen von 7,50 $ für 10.000 Suchanfragen bis 0,30 $/1K Suchanfragen beim größten Pack, Stand Oktober 2026. Vorausbezahlte Such-Credits verfallen nie: ungenutzte Suchen bleiben auf Ihrem Konto, bis Sie sie verwenden. Die Seite [Fehler](https://serpcrypto.com/de/docs/errors/) listet jeden Fehlercode und die richtige Art des erneuten Versuchs auf. ## Wohin gehe ich als Nächstes? - [API-Referenz: GET /search](https://serpcrypto.com/de/docs/search/) — jeder Parameter, Standardwert und Fehler - [Antwortformat](https://serpcrypto.com/de/docs/response/) — jeder Block und jedes Feld des JSON - [Standorte und Sprachen](https://serpcrypto.com/de/docs/locations/) — gl, hl, location, device - [Fehler und Wiederholungen](https://serpcrypto.com/de/docs/errors/) — Codes, Ursachen, Backoff - [Python](https://serpcrypto.com/de/docs/python/) — Anfragen, httpx async, CSV-Export - [Node.js](https://serpcrypto.com/de/docs/node/) — fetch, ein Concurrency-Pool, Pagination - [curl und jq](https://serpcrypto.com/de/docs/curl/) — Einzeiler-Rezepte - [MCP-Server](https://serpcrypto.com/de/docs/mcp/) — Websuche in Claude Desktop und Cursor - [LangChain und LlamaIndex](https://serpcrypto.com/de/docs/langchain/) — ein Suchtool für Agents - [OpenAI Function Calling](https://serpcrypto.com/de/docs/openai/) — Tool-Schema und der Aufruf-Loop ## Fragen zum Schnellstart ### Gibt es ein offizielles SerpCrypto SDK? Nein. Die Doku enthält Copy-and-paste-Code für Python, Node.js und curl, der den HTTPS-Endpoint direkt aufruft – es gibt also kein Paket zu installieren oder aktuell zu halten. Jede Sprache mit einem HTTP-Client funktioniert genauso: eine GET-Anfrage, ein Header, eine JSON-Antwort. ### Kann ich den API-Schlüssel in die URL setzen? Ja. `api_key=YOUR_KEY` funktioniert als Query-Parameter, was für einen schnellen Test im Browser hilft. Im Code sollten Sie den Header `Authorization: Bearer` bevorzugen: URLs landen häufiger in Logs, im Browser-Verlauf und auf geteilten Screenshots als Header. ### Brauche ich KYC oder eine Kreditkarte? Nein. SerpCrypto verlangt keinen Ausweis, kein Selfie, keine Dokumente und keine Karte. Login per Kontonummer; E-Mail ist optional. Sie zahlen in BTC, USDT, USDC, ETH, SOL, LTC ab einer Mindestaufladung von 25 $. ### Wie teste ich, bevor ich ein großes Paket kaufe? Kein kostenloser Tarif: Testen Sie mit dem kleinsten Pack, bezahlt ab dem Mindestaufladebetrag; der nur zum Erreichen des Minimums hinzugefügte Teil ist auf Anfrage innerhalb von 30 Tagen in USDT oder USDC erstattbar, sofern er ungenutzt ist. Das kleinste Paket läuft über denselben Endpoint und dieselben Engines wie das größte – ein Test damit zeigt Ihnen, wie sich der Produktivbetrieb verhält. --- SerpCrypto: SerpCrypto ist eine SERP-API für Entwickler und KI-Agenten, die Google- und Bing-Ergebnisse als JSON zurückgibt und mit Krypto bezahlt wird, ohne Ausweisupload. Vorausbezahlte Such-Credits ab 0,30 $/1K Suchanfragen verfallen nie. Ohne KYC — kein Ausweis, kein Selfie, keine Dokumente. Mit Krypto bezahlen.