SERP API — szybki start: Twoje pierwsze wyszukiwanie w curl, Python i Node.js

Jak wykonać pierwsze wyszukiwanie za pomocą curl?

Wyeksportuj klucz raz, potem wyślij jedno zapytanie GET. Flaga -G z --data-urlencode buduje query string i sama koduje spacje i znaki diakrytyczne. Odpowiedź to pojedynczy dokument JSON, a jq utrzymuje ją czytelną w terminalu.

Przykład pyta Google, domyślny engine, o wyniki w USA w języku angielskim. Zmień q, gl lub hl i uruchom ponownie: każde udane uruchomienie zużywa jeden kredyt.

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]'

Jak wykonać to samo wyszukiwanie w Python?

Użyj dowolnego klienta HTTP. W requests przekaż parametry jako słownik, a klucz API w nagłówku. raise_for_status() zamienia odpowiedź błędu, np. 401 dla nieprawidłowego klucza, na wyjątek, który możesz przechwycić.

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"])

A w Node.js?

Node.js 18 i nowsze mają wbudowany fetch, więc żaden pakiet nie jest potrzebny. Zapisz plik z rozszerzeniem .mjs, aby użyć await na najwyższym poziomie, a następnie uruchom node first-search.mjs.

// 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);
}

Jak sprawdzić, ile kredytów mi zostało?

Wywołaj GET https://serpcrypto.com/api/v1/credits z tym samym kluczem. Jest bezpłatne i zwraca trzy liczby: pozostałe kredyty, kredyty wykorzystane dzisiaj oraz ile zapytań Twoje konto może wykonywać jednocześnie. Każde konto może wykonywać określoną liczbę wyszukiwań jednocześnie; limit jest widoczny w panelu i podwyższany na żądanie.

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

{
  "credits_remaining": 84210,
  "credits_used_today": 1290,
  "concurrency_limit": 10
}

Co zwraca wyszukiwanie?

Każda odpowiedź ma ten sam szkielet na wszystkich silnikach. search_metadata mówi, czy wyszukiwanie się powiodło i ile kredytów zużyło. search_parameters powtarza zastosowane ustawienia, łącznie z domyślnymi. Następnie pojawia się jedna tablica lub obiekt na każdy blok strony wyników, taki jak organic_results lub people_also_ask.

Blok jest obecny tylko wtedy, gdy strona go pokazuje, więc odczytuj go z wartością domyślną. Strona format odpowiedzi opisuje każdy blok i pole.

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

Ile kosztuje wyszukiwanie i kiedy jest bezpłatne?

1 kredyt = 1 udane zapytanie wyszukiwania, które zwraca jedną stronę wyników na dowolnym obsługiwanym silniku. Nieudane zapytanie nie jest rozliczane. Około 10 wyników organicznych na stronę, tak jak Google serwuje od czasu, gdy we wrześniu 2025 przestało respektować num=100; każda dodatkowa strona to jeden kredyt więcej. Zapytanie odrzucone z powodu złego parametru, błędnego klucza, pustego salda lub zajętego konta również jest bezpłatne, podobnie jak każde wywołanie endpointu kredytów.

Ceny zaczynają się od 7,50 USD za 10 000 wyszukiwań do 0,30 USD/1K wyszukiwań przy największym pakiecie, według stanu na październik 2026. Prepaid kredyty wyszukiwania nigdy nie wygasają: niewykorzystane wyszukiwania pozostają na Twoim koncie, dopóki ich nie wykorzystasz. Strona błędów wymienia każdy kod błędu i właściwy sposób ponowienia.