Cùng bộ máy với SERP Checker
Không phải engine riêng biệt, cùng crawler, cùng độ tin cậy, chỉ khác cách nhận kết quả.
● Đã ra mắt
JSON thuần, không dashboard
Trả theo lượt dùng
200+ quốc gia
SERP API giá từ $0.002
Cùng dữ liệu SERP Checker, thẳng ra JSON
SERP API là mặt dữ liệu thô của SERP Checker: cùng crawler, cùng bảng giá, chỉ khác đầu ra là JSON thay vì dashboard. Gọi POST /serp-api/trigger, nhận kết quả qua webhook hoặc GET theo snapshot_id.
Quick start
3 lệnh gọi để có dữ liệu SERP
Header xác thực: X-API-KEY. Tạo và xoay key ngay trong dashboard.
1. Tạo snapshot (tính phí)
Gọi POST /serp-api/trigger, kèm header Idempotency-Key để gọi lại an toàn khi lỗi mạng.
curl -X POST https://app.serpupdate.com/api/v1/serp-api/trigger \
-H "X-API-KEY: 3f9a1c7e4b2d48a6915e0c83d7f6b214" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-8841" \
-d '{
"input": [{
"keyword": "best protein powder for muscle gain",
"language": "en",
"country": "US",
"device": "desktop",
"start_page": 1,
"end_page": 10,
"include_aio": true
}]
}'Phản hồi:
{ "snapshot_id": "sd_abc123xyz" }2. Lấy kết quả
Gọi GET /serp-api/{snapshot_id}: 200 khi xong, 202 khi còn chạy, 404 khi không tìm thấy, 410 khi hết hạn, 422 khi crawl lỗi.
curl https://app.serpupdate.com/api/v1/serp-api/sd_abc123xyz \
-H "X-API-KEY: 3f9a1c7e4b2d48a6915e0c83d7f6b214"3. Định dạng phản hồi
aio_text và aio_reference chỉ xuất hiện khi bật include_aio và Google thực sự hiển thị AI Overview cho truy vấn đó.
[{
"keyword": "best protein powder for muscle gain",
"organic": [
{ "rank": 1, "title": "...", "url": "...", "domain": "gnc.com", "description": "..." }
],
"aio_text": "markdown, only when include_aio is true",
"aio_reference": [
{ "rank": 1, "url": "...", "domain": "...", "title": "...", "description": "..." }
]
}]
Tham số
Body của POST /serp-api/trigger
Gửi trong {"input": [{ ... }]}, mỗi lần gọi 1 object.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
keyword |
string | Bắt buộc | Từ khóa cần crawl, 1 đến 500 ký tự. |
language |
string | Tùy chọn | Mã ngôn ngữ trả kết quả. |
country |
string | Tùy chọn | Mã quốc gia ISO-2. |
device |
string | Tùy chọn | desktop hoặc mobile. |
start_page / end_page |
number | Tùy chọn | Mặc định 1 đến 10, tức trọn Top 100. Giá phẳng theo lệnh gọi, lấy đủ 10 trang không tốn thêm. |
location |
string | Tùy chọn | Vị trí cụ thể, ví dụ tên thành phố. |
uule |
string | Tùy chọn | Mã vị trí chuẩn hóa của Google, dùng thay location khi cần chính xác tuyệt đối. |
include_aio |
boolean | Tùy chọn | true để lấy thêm AI Overview. Đây là tùy chọn duy nhất làm đổi đơn giá. |
custom_id |
string | Tùy chọn | ID riêng của bạn, lưu trong nhật ký request để đối chiếu. Không xuất hiện trong JSON trả về. |
Giá
Một lệnh gọi lấy trọn Top 100, từ $0.002
Mỗi từ khóa là một lệnh gọi. Mặc định lấy 10 trang, tức trọn Top 100, tính một lần giá.
1từ khóa
1lệnh gọi
10trang SERP
100kết quả organic
Dữ liệu thô
$0.002
/ lệnh gọi
Top 100 Organic, 10 trang, không lấy AI Overview
Đề xuất
Dữ liệu thô + AI Overview
$0.0022
/ lệnh gọi
Top 100 Organic, 10 trang, kèm aio_text và aio_reference
Bật AI Overview: mỗi lượt tính $0.0022 thay vì $0.002. Đây là đơn giá thay thế cho chính lượt gọi đó, không phải một khoản phí thứ hai cộng thêm vào.
Trừ thẳng vào cùng ví nạp sẵn (top-up wallet) với các dịch vụ khác của SERPUPDATE. Trả theo lượt dùng, số dư không hết hạn. Xem bảng giá đầy đủ.
Endpoint
4 endpoint, không hơn không kém
| Method | Path | Mô tả |
|---|---|---|
| GET | /serp-api/locations |
Tìm địa điểm: name (khớp gần đúng), country (ISO-2), page, size. |
| GET | /serp-api/languages |
Danh sách ngôn ngữ hỗ trợ, không tham số. |
| POST | /serp-api/trigger |
Tạo snapshot, đây là lệnh gọi tính phí. Trả về snapshot_id. |
| GET | /serp-api/{snapshot_id} |
Lấy kết quả: 200 khi xong, 202 khi đang chạy, 404 khi không tìm thấy, 410 khi hết hạn, 422 khi crawl lỗi. |
Pingback webhook (khuyến nghị thay cho polling)
SERPUPDATE tự POST tới URL bạn khai báo trong dashboard khi snapshot xong. Thử lại tối đa 3 lần nếu chưa nhận được: sau 30 giây, 5 phút, 30 phút. Kèm header X-SerpUpdate-Delivery và X-SerpUpdate-Token.
{
"snapshot_id": "sd_abc123xyz",
"status": "ready",
"keyword": "best protein powder for muscle gain",
"collect_time_ms": 4821
}| Mã lỗi | Ý nghĩa |
|---|---|
HTTP 429 |
Gọi quá tần suất cho phép. Không kèm mã lỗi, hãy đọc header Retry-After rồi thử lại. |
TOO_MANY_INPUTS |
Gửi nhiều hơn một từ khóa trong cùng một lượt. |
INSUFFICIENT_BALANCE |
Số dư ví không đủ để chạy snapshot. |
SNAPSHOT_EXPIRED |
Snapshot đã quá 30 ngày lưu trữ. |
SNAPSHOT_FAILED |
Crawl thất bại, không tính phí lượt này. |
COLLECTION_TIMEOUT |
Hạ tầng cào phản hồi quá lâu, thử gọi trigger lại. |
Công nghệ SERP API
Bên trong hạ tầng cào dữ liệu của SERP API
Cào dữ liệu thật như người dùng, ổn định, đúng vị trí, không bị chặn.
Ứng dụng của bạn
POST /serp-api/trigger
Từ khóa + Quốc gia + Thiết bị
Browser Fingerprint
Giả lập trình duyệt thật, bám sát SERP hiển thị.
Worldwide IP Rotation
Xoay IP theo quốc gia/thành phố, hơn 200.000 địa phương.
Geo Targeting
Chuẩn hóa vị trí theo mã quốc gia ISO 3166.
Human Like Behavior
Mô phỏng thao tác người dùng thật, tránh bị chặn.
CAPTCHA Solving
Tự động xử lý CAPTCHA, tracking ổn định liên tục.
Data Preprocessing
Làm sạch HTML SERP thành JSON chuẩn, dùng được ngay.
Kết quả trả về
Pingback khi sẵn sàng
JSON: organic + aio_text
Vì sao chọn
Sẵn crawler, sẵn dashboard quản trị API
JSON thô, tự do xử lý
Không dashboard, dữ liệu đổ thẳng vào pipeline hoặc kho dữ liệu của bạn.
Idempotency Key chống tính phí trùng
Gọi lại khi lỗi mạng vẫn an toàn, không bị trừ ví hai lần cho cùng một lượt.
Pingback webhook, khỏi polling
SERPUPDATE tự báo khi snapshot xong, thử lại tối đa 3 lần nếu chưa nhận được.
Phủ 200+ quốc gia
Hơn 200.000 địa điểm chi tiết, đúng phạm vi với SERP Checker.
Kèm dashboard quản trị
Playground thử trước khi code, nhật ký request, chi phí từng snapshot, xuất JSON/CSV.
Chưa cần code? Dùng SERP Checker trước
Cùng dữ liệu, cùng giá, nhưng xem qua dashboard thay vì gọi API. Hợp khi bạn muốn thử trước khi tích hợp.
Lấy key, gọi thử ngay hôm nay
Trả theo lượt dùng từ $0.002, không hợp đồng, không phí ẩn.
Lấy API key
FAQ
Câu hỏi thường gặp
SERP API khác gì so với SERP Checker?
Cùng bộ máy cào và cùng đơn giá. SERP Checker là bản có giao diện, nên đóng gói sẵn thêm lớp phân tích như Brand Mention và biểu đồ theo thời gian. SERP API luôn là dữ liệu thô, bạn chỉ chọn lấy AI Overview hay không.
Bật AI Overview có bị tính thêm phí không?
Đơn giá lượt đó thành $0.0022 thay vì $0.002. Đây là giá thay thế cho chính lượt gọi, không phải một khoản phí thứ hai cộng thêm.
Idempotency-Key dùng để làm gì?
Gửi kèm header Idempotency-Key (tối đa 64 ký tự) khi gọi trigger. Nếu bạn phải gọi lại do lỗi mạng, hệ thống nhận ra và không tính phí lần hai.
Nên polling hay dùng webhook?
Nên dùng pingback webhook. SERPUPDATE tự gọi lại URL bạn khai báo khi snapshot xong, thử tối đa 3 lần nếu thất bại, đỡ tốn request polling.
Kết quả snapshot lưu được bao lâu?
30 ngày. Gọi lại snapshot_id sau thời hạn này sẽ nhận mã lỗi SNAPSHOT_EXPIRED (410).
SERP API hỗ trợ công cụ tìm kiếm nào?
Google, ở giai đoạn hiện tại. Phạm vi hơn 200 quốc gia và 200.000+ địa điểm giống hệt SERP Checker.