Không cần KYC — không giấy tờ tùy thân, không selfie, không tài liệu. Thanh toán bằng crypto: BTC, USDT, USDC, ETH, SOL, LTC
Ngôn ngữ: Tiếng Việt
Lấy khóa API

Tài liệu · Định dạng phản hồi · API v1

Định dạng phản hồi SERP API: mọi block và field của JSON

Một khung chung trên mọi engine, rồi một block cho từng phần của trang kết quả. Trang này liệt kê từng block, các field và kiểu của chúng. Trong các ví dụ, ID, số lượng, giá và kết quả chỉ mang tính minh họa.

Cập nhật lần cuối: · 8 phút đọc

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ị đó.

engine=google, gl=gb: giá trị minh họa, đã rút gọn
{
  "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.

Python: đọc các block tùy chọn một cách an toàn
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ườngLoạiMô tả
idstringĐịnh danh của lượt tìm kiếm. Trích dẫn nó khi bạn liên hệ hỗ trợ.
statusstringsuccess trong phản hồi 200.
enginestringEngine đã chạy lượt tìm kiếm.
created_atstringThời điểm tìm kiếm, ISO 8601 theo UTC.
credits_usedintegerCredit 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ườngLoạiMô tả
search_parametersobjectCá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_resultsintegerSố 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_displayedstringTruy 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ườngLoạiMô tả
positionintegerThứ tự của kết quả trong block này trên trang này, bắt đầu từ 1.
titlestringTiêu đề của liên kết màu xanh.
linkstringURL của kết quả.
displayed_linkstringURL hoặc breadcrumb như hiển thị bên dưới tiêu đề.
snippetstringĐoạn văn bản hiển thị bên dưới tiêu đề.
datestringNgày hiển thị bên cạnh snippet, đúng như ghi trên trang. Tùy chọn.
sitelinksarrayCá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ườngLoạiMô tả
ai_overview.textstringNội dung văn bản của AI Overview như hiển thị trên trang.
ai_overview.references[].indexintegerThứ tự của nguồn trong phần tổng quan.
ai_overview.references[].titlestringTiêu đề của trang được trích dẫn.
ai_overview.references[].linkstringURL của trang được trích dẫn.
ai_overview.references[].sourcestringTên của trang web, như hiển thị.

ads và people_also_ask chứa những gì?

TrườngLoạiMô tả
ads[].positionintegerThứ tự trong block của nó.
ads[].blockstringtop hoặc bottom của trang.
ads[].title, link, displayed_linkstringTiêu đề, URL đích và URL hiển thị của quảng cáo.
ads[].descriptionstringVăn bản quảng cáo.
people_also_ask[].questionstringCâu hỏi như được hiển thị.
people_also_ask[].snippetstringVăn bản câu trả lời hiển thị khi mở câu hỏi.
people_also_ask[].title, linkstringTiê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ốiTrườngĐây là gì
local_resultsposition, title, address, rating, reviews, typeLocal pack: các doanh nghiệp trên bản đồ cho những truy vấn có ý định về địa điểm.
knowledge_graphtitle, type, description, source.name, source.linkKnowledge panel về một người, địa điểm, công ty hoặc sự vật.
top_storiestitle, link, source, dateCác bài báo hiển thị trong một carousel.
inline_videostitle, link, source, durationKết quả video hiển thị bên trong kết quả tìm kiếm web.
shopping_resultsposition, title, price, source, linkDanh sách sản phẩm hiển thị bên trong kết quả tìm kiếm web.
related_searchesqueryCác tìm kiếm được gợi ý ở cuối trang.
paginationcurrent, next_pageSố 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.

engineMảng chínhTrường
google_newsnews_resultsposition, title, link, source, date, snippet, thumbnail
google_imagesimages_resultsposition, title, original, original_width, original_height, thumbnail, source, link
google_mapslocal_resultsposition, title, place_id, address, phone, website, rating, reviews, type, hours, gps_coordinates.latitude, gps_coordinates.longitude
google_shoppingshopping_resultsposition, title, price, extracted_price, currency, source, link, delivery, rating, reviews
bingorganic_results, related_searchesCù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í.

Từ 0,30 US$/1K lượt tìm kiếm · không cần KYC

Lấy khóa API