Quick start SERP API: pencarian pertama Anda di curl, Python, dan Node.js

Bagaimana cara menjalankan pencarian pertama saya dengan curl?

Export API key sekali, lalu kirim satu permintaan GET. Flag -G dengan --data-urlencode membangun query string dan meng-encode spasi serta aksen untuk Anda. Jawabannya adalah satu dokumen JSON, dan jq menjaganya tetap mudah dibaca di terminal.

Contoh ini meminta Google, engine default, untuk hasil US dalam bahasa Inggris. Ubah q, gl, atau hl lalu jalankan lagi: setiap eksekusi yang berhasil memakai satu kredit.

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

Bagaimana cara menjalankan pencarian yang sama di Python?

Gunakan HTTP client apa pun. Dengan requests, oper parameter sebagai dictionary dan API key di header. raise_for_status() mengubah jawaban error, seperti 401 untuk API key yang salah, menjadi exception yang bisa Anda tangkap.

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

Dan di Node.js?

Node.js 18 dan setelahnya sudah menyertakan fetch, jadi tidak perlu package. Simpan file dengan ekstensi .mjs untuk memakai await di top level, lalu jalankan 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);
}

Bagaimana cara memeriksa berapa kredit yang tersisa?

Panggil GET https://serpcrypto.com/api/v1/credits dengan API key yang sama. Gratis dan mengembalikan tiga angka: kredit tersisa, kredit yang dipakai hari ini, dan berapa banyak pencarian yang dapat dijalankan akun Anda secara bersamaan. Setiap akun dapat menjalankan sejumlah pencarian secara bersamaan; batasnya ditampilkan di dashboard Anda dan dinaikkan atas permintaan.

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

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

Apa yang dikembalikan dari sebuah pencarian?

Setiap jawaban memiliki kerangka yang sama di semua mesin. search_metadata menyatakan apakah pencarian berhasil dan berapa kredit yang dipakai. search_parameters mengulang pengaturan yang diterapkan, termasuk nilai default. Lalu ada satu array atau object per blok halaman hasil, seperti organic_results atau people_also_ask.

Sebuah blok hanya ada jika halaman menampilkannya, jadi baca dengan nilai default. Halaman format respons menjelaskan setiap blok dan field.

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

Berapa biaya satu pencarian, dan kapan gratis?

1 kredit = 1 permintaan pencarian yang berhasil, yang mengembalikan satu halaman hasil di mesin mana pun yang didukung. Permintaan yang gagal tidak dikenai biaya. Sekitar 10 hasil organik per halaman, sebagaimana yang disajikan Google sejak berhenti mematuhi num=100 pada September 2025; setiap halaman tambahan dikenai satu kredit lagi. Permintaan yang ditolak karena parameter salah, API key salah, saldo kosong, atau akun sibuk juga gratis, begitu pula setiap panggilan ke endpoint kredit.

Harga mulai dari US$7,50 untuk 10.000 pencarian hingga US$0,30/1K pencarian pada paket terbesar, per Oktober 2026. Kredit pencarian prabayar tidak pernah kedaluwarsa: pencarian yang belum terpakai tetap ada di akun Anda sampai Anda menggunakannya. Halaman error mencantumkan setiap kode error dan cara retry yang tepat.