SERP API quick start: lần tìm kiếm đầu tiên của bạn bằng curl, Python và Node.js

Làm thế nào để tôi chạy lần tìm kiếm đầu tiên với curl?

Export khóa một lần, sau đó gửi một yêu cầu GET. Cờ -G với --data-urlencode tạo query string và mã hóa dấu cách và dấu cho bạn. Câu trả lời là một tài liệu JSON duy nhất, và jq giữ nó dễ đọc trong terminal.

Ví dụ hỏi Google, engine mặc định, cho kết quả US bằng tiếng Anh. Đổi q, gl hoặc hl và chạy lại: mỗi lần chạy thành công dùng một 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]'

Làm thế nào để tôi chạy cùng tìm kiếm đó trong Python?

Dùng bất kỳ HTTP client nào. Với requests, truyền các tham số dưới dạng dictionary và khóa trong header. raise_for_status() biến câu trả lời lỗi, chẳng hạn 401 khi khóa sai, thành một exception bạn có thể bắt.

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

Và trong Node.js?

Node.js 18 trở lên có sẵn fetch, nên không cần package nào. Lưu tệp với đuôi .mjs để dùng await ở cấp cao nhất, sau đó chạy 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);
}

Làm sao để kiểm tra tôi còn bao nhiêu credit?

Gọi GET https://serpcrypto.com/api/v1/credits với cùng khóa API. Miễn phí và trả về ba con số: số credit còn lại, số credit đã dùng hôm nay và số truy vấn tài khoản của bạn có thể chạy đồng thời. Mỗi tài khoản có thể chạy một số lượng truy vấn tìm kiếm cùng lúc; giới hạn được hiển thị trong dashboard và có thể tăng theo yêu cầu.

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

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

Kết quả tìm kiếm trả về những gì?

Mọi câu trả lời đều có cùng khung trên tất cả engine. search_metadata cho biết truy vấn có thành công không và đã dùng bao nhiêu credit. search_parameters lặp lại các cài đặt đã áp dụng, kể cả giá trị mặc định. Tiếp theo là một mảng hoặc object cho mỗi khối của trang kết quả, chẳng hạn organic_results hoặc people_also_ask.

Một khối chỉ xuất hiện khi trang hiển thị nó, nên hãy đọc với giá trị mặc định. Trang định dạng phản hồi mô tả từng khối và từng 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 }
}

Một truy vấn tốn bao nhiêu, và khi nào miễn phí?

1 credit = 1 truy vấn tìm kiếm thành công, trả về một trang kết quả trên bất kỳ engine nào được hỗ trợ. Truy vấn thất bại không bị tính phí. Khoảng 10 kết quả organic mỗi trang, đúng như Google đã trả về kể từ khi ngừng áp dụng num=100 vào tháng 9 năm 2025; mỗi trang thêm là thêm một credit. Một request bị từ chối vì parameter sai, khóa API sai, số dư trống hoặc tài khoản đang bận cũng miễn phí, và mọi lần gọi endpoint credit cũng vậy.

Giá từ 7,50 US$ cho 10.000 tìm kiếm đến 0,30 US$/1K lượt tìm kiếm ở pack lớn nhất, tính đến tháng 10 năm 2026. Credit tìm kiếm trả trước không bao giờ hết hạn: các lượt tìm kiếm chưa dùng vẫn nằm trong tài khoản của bạn cho đến khi bạn dùng. Trang lỗi liệt kê từng mã lỗi và cách thử lại đúng.