SERP-API-Schnellstart: Ihre erste Suche in curl, Python und Node.js

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.

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.

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.

// 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.

curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY"

{
  "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 beschreibt jeden Block und jedes Feld.

{
  "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 }
}

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 listet jeden Fehlercode und die richtige Art des erneuten Versuchs auf.