Trả lời nhanh
Phản hồi của SerpCrypto SERP API chứa gì?
Mỗi phản hồi SerpCrypto là một object JSON: search_metadata (trạng thái, engine, credit đã dùng), search_parameters (các thiết lập đã áp dụng), search_information, rồi một block cho từng phần của trang kết quả, chẳng hạn organic_results, ai_overview, people_also_ask hoặc local_results. Các phần không có sẽ đơn giản là vắng mặt. Một trang tốn 1 credit, từ 0,30 US$/1K lượt tìm kiếm; thanh toán bằng crypto, không cần KYC.
Một phản hồi Google đầy đủ trông như thế nào?
Ví dụ dưới đây là một tìm kiếm Google cho standing desk tại United Kingdom, được rút gọn thành một mục cho mỗi mảng. Một phản hồi thật có khoảng mười kết quả organic và mọi block khác mà trang đã hiển thị cho truy vấn, vị trí và thiết bị đó.
{
"search_metadata": {
"id": "srch_2b81d0c6fa47",
"status": "success",
"engine": "google",
"created_at": "2026-10-22T10:02:31Z",
"credits_used": 1
},
"search_parameters": {
"engine": "google",
"q": "standing desk",
"gl": "gb",
"hl": "en",
"google_domain": "google.co.uk",
"device": "desktop",
"page": 1
},
"search_information": { "total_results": 52400000, "query_displayed": "standing desk" },
"ai_overview": {
"text": "A standing desk lets you work while standing or sitting…",
"references": [
{ "index": 1, "title": "How to choose a standing desk", "link": "https://www.example.co.uk/guide", "source": "Example Guide" }
]
},
"ads": [
{ "position": 1, "block": "top", "title": "Electric Standing Desks", "link": "https://shop.example.com/desks", "displayed_link": "shop.example.com", "description": "Free delivery on…" }
],
"organic_results": [
{
"position": 1,
"title": "Best standing desks 2026, tested",
"link": "https://www.example.co.uk/best-standing-desks",
"displayed_link": "www.example.co.uk › reviews",
"snippet": "We tested 14 electric and manual desks…",
"date": "12 Oct 2026",
"sitelinks": [ { "title": "Budget picks", "link": "https://www.example.co.uk/best-standing-desks#budget" } ]
}
],
"people_also_ask": [
{ "question": "Is it healthy to stand all day at a desk?", "snippet": "…", "title": "Standing at work", "link": "https://www.example.org/standing" }
],
"shopping_results": [
{ "position": 1, "title": "Example Desk Pro 140 cm", "price": "£299.00", "source": "Example Store", "link": "https://shop.example.com/desk-pro" }
],
"related_searches": [ { "query": "standing desk electric" }, { "query": "standing desk converter" } ],
"pagination": { "current": 1, "next_page": 2 }
}Vì sao một số block bị thiếu trong phản hồi của tôi?
Vì trang kết quả không hiển thị chúng. Google quyết định theo từng truy vấn, vị trí và thiết bị việc có hiển thị ads, AI Overview, local pack hay top stories hay không. SerpCrypto trả về những gì trang đã hiển thị và bỏ qua phần còn lại, thay vì gửi placeholder rỗng.
Đọc mọi block với một giá trị mặc định, như các dòng Python dưới đây. Quy tắc tương tự áp dụng bên trong một block: các field tùy chọn như date hoặc sitelinks chỉ xuất hiện trên những kết quả có chúng.
data = response.json()
# A block is present only when the results page shows it: read with a default.
overview = data.get("ai_overview") or {}
organic = data.get("organic_results", [])
questions = [item["question"] for item in data.get("people_also_ask", [])]
if overview:
print("AI Overview sources:", [ref["link"] for ref in overview.get("references", [])])
print(len(organic), "organic results,", len(questions), "questions")search_metadata chứa gì?
| Trường | Loại | Mô tả |
|---|---|---|
id | string | Định danh của lượt tìm kiếm. Trích dẫn nó khi bạn liên hệ hỗ trợ. |
status | string | success trong phản hồi 200. |
engine | string | Engine đã chạy lượt tìm kiếm. |
created_at | string | Thời điểm tìm kiếm, ISO 8601 theo UTC. |
credits_used | integer | Credit bị trừ cho lượt tìm kiếm này: 1 khi thành công. |
search_parameters và search_information là gì?
Lưu search_parameters cùng với kết quả của bạn: nó ghi lại chính xác thứ hạng đến từ quốc gia, ngôn ngữ, địa điểm và thiết bị nào.
| Trường | Loại | Mô tả |
|---|---|---|
search_parameters | object | Các tham số đã áp dụng, với giá trị mặc định được điền vào: engine, q, gl, hl, location, google_domain, device, page và những tham số khác bạn đã gửi. |
search_information.total_results | integer | Số lượng kết quả mà engine hiển thị, khi engine có hiển thị. Đây là con số ước tính, không phải con số chính xác. |
search_information.query_displayed | string | Truy vấn đúng như trang kết quả đã hiển thị. |
organic_results có những trường nào?
Kết quả organic là các kết quả web không phải trả phí. Trên Bing, organic_results có cùng cấu trúc.
| Trường | Loại | Mô tả |
|---|---|---|
position | integer | Thứ tự của kết quả trong block này trên trang này, bắt đầu từ 1. |
title | string | Tiêu đề của liên kết màu xanh. |
link | string | URL của kết quả. |
displayed_link | string | URL hoặc breadcrumb như hiển thị bên dưới tiêu đề. |
snippet | string | Đoạn văn bản hiển thị bên dưới tiêu đề. |
date | string | Ngày hiển thị bên cạnh snippet, đúng như ghi trên trang. Tùy chọn. |
sitelinks | array | Các liên kết bổ sung hiển thị bên dưới kết quả, mỗi liên kết gồm title và link. Tùy chọn. |
AI Overview được trả về như thế nào?
ai_overview chỉ xuất hiện khi Google hiển thị AI Overview cho truy vấn và địa điểm đó. Nhiều truy vấn không có.
| Trường | Loại | Mô tả |
|---|---|---|
ai_overview.text | string | Nội dung văn bản của AI Overview như hiển thị trên trang. |
ai_overview.references[].index | integer | Thứ tự của nguồn trong phần tổng quan. |
ai_overview.references[].title | string | Tiêu đề của trang được trích dẫn. |
ai_overview.references[].link | string | URL của trang được trích dẫn. |
ai_overview.references[].source | string | Tên của trang web, như hiển thị. |
ads và people_also_ask chứa những gì?
| Trường | Loại | Mô tả |
|---|---|---|
ads[].position | integer | Thứ tự trong block của nó. |
ads[].block | string | top hoặc bottom của trang. |
ads[].title, link, displayed_link | string | Tiêu đề, URL đích và URL hiển thị của quảng cáo. |
ads[].description | string | Văn bản quảng cáo. |
people_also_ask[].question | string | Câu hỏi như được hiển thị. |
people_also_ask[].snippet | string | Văn bản câu trả lời hiển thị khi mở câu hỏi. |
people_also_ask[].title, link | string | Tiêu đề và URL của trang mà câu trả lời đến từ. |
Những khối nào khác của Google có thể xuất hiện?
| Khối | Trường | Đây là gì |
|---|---|---|
local_results | position, title, address, rating, reviews, type | Local pack: các doanh nghiệp trên bản đồ cho những truy vấn có ý định về địa điểm. |
knowledge_graph | title, type, description, source.name, source.link | Knowledge panel về một người, địa điểm, công ty hoặc sự vật. |
top_stories | title, link, source, date | Các bài báo hiển thị trong một carousel. |
inline_videos | title, link, source, duration | Kết quả video hiển thị bên trong kết quả tìm kiếm web. |
shopping_results | position, title, price, source, link | Danh sách sản phẩm hiển thị bên trong kết quả tìm kiếm web. |
related_searches | query | Các tìm kiếm được gợi ý ở cuối trang. |
pagination | current, next_page | Số trang hiện tại và trang tiếp theo, khi có. |
Các engine khác trả về những gì?
Mỗi vertical giữ nguyên khung và thêm mảng riêng của nó. Trên Google Maps, local_results phong phú hơn local pack của một tìm kiếm web.
engine | Mảng chính | Trường |
|---|---|---|
google_news | news_results | position, title, link, source, date, snippet, thumbnail |
google_images | images_results | position, title, original, original_width, original_height, thumbnail, source, link |
google_maps | local_results | position, title, place_id, address, phone, website, rating, reviews, type, hours, gps_coordinates.latitude, gps_coordinates.longitude |
google_shopping | shopping_results | position, title, price, extracted_price, currency, source, link, delivery, rating, reviews |
bing | organic_results, related_searches | Cùng các field như kết quả tìm kiếm Google hữu cơ |
Giá, đánh giá và ngày tháng được định kiểu thế nào?
Giá trị giữ đúng dạng mà trang đã dùng mỗi khi trang viết chúng dưới dạng văn bản. price là chuỗi kèm ký hiệu tiền tệ, ví dụ £299.00, và Google Shopping thêm extracted_price dưới dạng số với currency là mã. rating là số và reviews là số nguyên. Ngày tháng như date giữ nguyên như trên trang, ví dụ 12 Oct 2026 hoặc 3 days ago, nên bạn tự parse trong code nếu cần timestamp.
Làm sao để xây dựng thứ hạng tổng thể qua nhiều trang?
Lưu số trang cùng với mỗi kết quả. position cho biết thứ tự bên trong khối của nó trên một trang, và search_parameters.page cho biết đó là trang nào. 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.
Để theo dõi thứ hạng, hầu hết các đội giữ link, position, page, gl, location, device và created_at theo từng từ khóa và từng ngày. Thế là đủ để vẽ biểu đồ thứ hạng và giải thích thay đổi theo vị trí hoặc thiết bị. Xem theo dõi thứ hạng để biết toàn bộ phương pháp.
Câu hỏi về định dạng response
Cách đặt tên field có ổn định không?
Có, trong phạm vi version 1. Các khối hoặc field mới có thể được thêm vào, nên hãy bỏ qua những key bạn không biết. Việc xóa hoặc đổi tên một field sẽ đi kèm một version mới trong path, ví dụ /api/v2/.
Tôi có thể lấy HTML thô của trang không?
Không. Version 1 chỉ trả về JSON đã parse. Các khối đã parse bao phủ những gì hầu hết công cụ cần: kết quả, quảng cáo, câu hỏi, AI Overview, local pack và knowledge panel.
Tại sao total_results lại khác với con số tôi đếm được?
Đó là con số ước tính mà engine in ra, không phải số kết quả bạn có thể chuyển trang để xem. Các trang dừng lại từ lâu trước con số đó; hãy dùng pagination.next_page để biết còn trang tiếp theo hay không.
Một response không có kết quả hữu cơ có tốn credit không?
Có, nếu tìm kiếm thành công: một trang rỗng vẫn là một kết quả. Chỉ lỗi là 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í.