SERP API hızlı başlangıç: curl, Python ve Node.js ile ilk aramanız

İlk aramamı curl ile nasıl çalıştırırım?

Anahtarı bir kez dışa aktarın, ardından tek bir GET isteği gönderin. --data-urlencode ile birlikte -G bayrağı sorgu dizesini oluşturur ve boşlukları ve aksanları sizin için kodlar. Yanıt tek bir JSON belgesidir ve jq onu bir terminalde okunabilir tutar.

Örnek, varsayılan motor olan Google'dan İngilizce olarak ABD sonuçlarını ister. q, gl veya hl değiştirin ve yeniden çalıştırın: başarılı her çalıştırma bir kredi kullanır.

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

Aynı aramayı Python'da nasıl çalıştırırım?

Herhangi bir HTTP istemcisi kullanın. requests ile parametreleri bir sözlük olarak ve anahtarı başlıkta geçirin. raise_for_status(), yanlış bir anahtar için 401 gibi bir hata yanıtını yakalayabileceğiniz bir istisnaya dönüştürür.

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

Peki Node.js'te?

Node.js 18 ve sonrası fetch ile birlikte gelir, bu yüzden herhangi bir paket gerekmez. Üst düzeyde await kullanmak için dosyayı .mjs uzantısıyla kaydedin, ardından node first-search.mjs çalıştırın.

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

Kalan kredimi nasıl kontrol ederim?

Aynı anahtarla GET https://serpcrypto.com/api/v1/credits çağırın. Ücretsizdir ve üç sayı döndürür: kalan krediler, bugün kullanılan krediler ve hesabınızın aynı anda çalıştırabileceği arama sayısı. Her hesap aynı anda belirli sayıda arama çalıştırabilir; limit dashboard'ınızda gösterilir ve talep üzerine yükseltilir.

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

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

Bir aramadan ne döner?

Her yanıt tüm motorlarda aynı çerçeveye sahiptir. search_metadata, aramanın başarılı olup olmadığını ve kaç kredi kullandığını söyler. search_parameters, varsayılanlar dahil uygulanan ayarları yineler. Ardından sonuçlar sayfasının her bloğu için organic_results veya people_also_ask gibi bir dizi ya da nesne gelir.

Bir blok yalnızca sayfada göründüğünde yer alır, bu yüzden onu varsayılan bir değerle okuyun. Yanıt biçimi sayfası her bloğu ve alanı açıklar.

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

Bir arama ne kadar tutar ve ne zaman ücretsizdir?

1 kredi = desteklenen herhangi bir motorda bir sayfa sonuç döndüren 1 başarılı arama isteği. Başarısız olan istek ücretlendirilmez. Google'ın Eylül 2025'te num=100 değerini dikkate almayı bırakmasından bu yana sunduğu gibi sayfa başına yaklaşık 10 organik sonuç; her ek sayfa bir kredi daha. Hatalı bir parametre, yanlış bir anahtar, boş bir bakiye veya meşgul bir hesap nedeniyle reddedilen istek de ücretsizdir; credits endpoint'ine yapılan her çağrı da öyle.

Fiyatlar, Ekim 2026 itibarıyla 10.000 arama için $7,50 ile en büyük packte $0,30/1K arama arasında değişir. Ön ödemeli arama kredileri hiçbir zaman sona ermez: kullanılmayan aramalar siz kullanana kadar hesabınızda kalır. Hatalar sayfası her hata kodunu ve doğru yeniden deneme yolunu listeler.