Các đội đang tìm API xếp hạng của Google thường chỉ muốn một thứ cụ thể: một lệnh gọi trả về vị trí của một trang với một từ khóa. Google không công bố thứ đó.
Thứ Google công bố là một nhóm API mô tả hiệu suất của chính bạn, trạng thái chỉ mục của chính bạn và tình hình thu thập dữ liệu của chính bạn. Chúng thực sự hữu ích và đều miễn phí. Về mặt cấu trúc, chúng cũng không thể trả lời câu hỏi mà phần lớn người ta mang đến khi tìm kiếm điều này.
Chúng tôi dành một ngày để đo xem các API đó thực sự trả về gì trên một site đang hoạt động, kể cả những phần dễ đọc sai. Ba phát hiện nổi bật: dữ liệu đến muộn ba ngày, con số vị trí là một giá trị trung bình không tái lập được so với kết quả trực tiếp, và API nghe giống kiểm tra thứ hạng nhất lại trả về một phán quyết mà tự nó không nói lên điều gì hữu ích.
Google thực sự công bố những gì
Bốn bề mặt thường bị nhầm với API xếp hạng. Đây là mục đích của từng cái, theo tài liệu của chính Google.
Search Analytics API trả về lượt nhấp, lượt hiển thị, CTR và vị trí trung bình cho một property đã xác minh. Đây là thứ gần nhất với dữ liệu xếp hạng mà Google cung cấp, và là nguồn của mọi con số "vị trí trung bình" trong Search Console.
URL Inspection API trả về trạng thái chỉ mục cho một URL: Google có biết nó không, nó đã được lập chỉ mục chưa, và nếu chưa thì vì sao.
Indexing API nghe như thể gửi trang đi lập chỉ mục. Tài liệu Google giới hạn các loại được hỗ trợ ở dữ liệu có cấu trúc JobPosting và BroadcastEvent, một trường hợp dùng hẹp chứ không phải gửi chỉ mục nói chung.
Custom Search JSON API trả về kết quả web cho một truy vấn. Nó tìm trong chỉ mục do bạn tự cấu hình, và không cho biết site của bạn đứng ở đâu trong kết quả chính của Google.
Không cái nào trả về "thứ hạng của bạn cho từ khóa này". Công việc đó không tồn tại trong dòng sản phẩm của Google, và sự vắng mặt là có chủ đích chứ không phải sơ suất. Google không có lý do thương mại nào để phát dữ liệu thứ hạng của đối thủ ở quy mô lớn.
Những gì chúng tôi đo: dữ liệu cũ ba ngày
Chúng tôi kéo bản phân tích theo ngày cho property của mình vào ngày 12 tháng 9 năm 2026. Ngày mới nhất có dữ liệu là ngày 9 tháng 9.
Ngày có sẵn | Số dòng trả về |
|---|---|
2026-09-02 | có |
2026-09-03 | có |
2026-09-04 | có |
2026-09-05 | có |
2026-09-06 | có |
2026-09-07 | có |
2026-09-08 | có |
2026-09-09 | có, mới nhất |
Độ trễ ba ngày, đều đặn. Tham số window đếm ngược từ ngày có sẵn mới nhất chứ không phải từ hôm nay, và đó là một cái bẫy nhỏ: yêu cầu bảy ngày trả về tám ngày kết thúc vào 9 tháng 9, không phải 12 tháng 9.
Với báo cáo hàng tháng thì điều này không quan trọng. Với câu hỏi "thay đổi trang hôm qua có làm hỏng thứ gì không", nó loại công cụ này ra. Không cấu hình nào sửa được. Độ trễ nằm ở phía Google.
Những gì chúng tôi đo: vị trí trung bình không phải thứ hạng
Đây là phát hiện quan trọng hơn, và là thứ khiến người ta tin rằng API xếp hạng của Google có tồn tại và chỉ đang lảng tránh.
Vị trí trung bình là vị trí trung bình của URL bạn trên mọi lượt hiển thị trong kỳ, được gia trọng theo quốc gia, thiết bị và biến thể truy vấn. Kiểm tra thứ hạng trực tiếp trả về một con số, từ một vị trí, trên một thiết bị, tại một thời điểm. Đó là hai phép đo khác nhau dùng chung một cái tên.
Chúng tôi kiểm nghiệm khoảng cách này trên 25 truy vấn lấy từ dữ liệu Search Console của chính mình, rồi kiểm tra đúng 25 từ khóa đó với SERP trực tiếp của Hoa Kỳ, tiếng Anh, máy tính để bàn ở độ sâu 100.
Kết quả | Số lượng |
|---|---|
Truy vấn dùng được trong cả hai tập | 23 |
Xuất hiện trong top 100 trực tiếp | 14 (61%) |
Có lượt hiển thị trong Search Console nhưng không có kết quả trực tiếp tái lập được | 9 (39%) |
Trung vị của chênh lệch tuyệt đối khi cả hai cùng có | 7,4 bậc |
Chênh lệch tuyệt đối trung bình | 8,5 bậc |
Chênh lệch lớn nhất | 36,6 bậc |
Cách nhau trong vòng 3 bậc | 4 trên 14 |
Lệch hơn 10 bậc | 4 trên 14 |
Ở nơi cả hai phép đo cùng tồn tại, chúng lệch nhau ở trung vị 7,4 bậc.
Có hai chi tiết quan trọng hơn các giá trị trung bình.
Thứ nhất, chín trong 23 truy vấn cho ra vị trí trong Search Console nhưng hoàn toàn không có kết quả trực tiếp trong lần kiểm tra Hoa Kỳ, tiếng Anh, máy tính để bàn. Đây không phải lỗi. Lượt hiển thị tích tụ từ quốc gia khác, ngôn ngữ khác, thiết bị khác và các bề mặt hình ảnh hay video. Một lần kiểm tra khóa vào một khu vực địa lý sẽ không tái lập được chúng, và một đội coi hai con số là cùng một phép đo sẽ mất cả tuần đuổi theo một khác biệt vốn chỉ là hệ quả của phương pháp.
Thứ hai, hướng không nhất quán. Phần lớn vị trí trực tiếp nằm dưới mức trung bình của Search Console, điều đáng lẽ phải như vậy khi mức trung bình bao gồm cả những bề mặt hoạt động tốt hơn. Nhưng một truy vấn dịch chuyển 36,6 bậc theo hướng ngược lại, từ 73,6 xuống 37. Không có hệ số hiệu chỉnh nào để áp dụng.
Chênh lệch chạy theo cả hai hướng, nên không có hệ số hiệu chỉnh nào để áp dụng.
Hệ quả thực tế cho bất kỳ ai đang chọn API xếp hạng của Google: dữ liệu miễn phí sẽ không cho bạn biết thứ hạng, và dữ liệu trả phí sẽ không khớp với nó. Cả hai đều đo đúng những thứ khác nhau. Coi cái này là thay thế cho cái kia chính là chỗ báo cáo bắt đầu sai.
Chỗ mà phía dữ liệu gốc thực sự không thể thay thế là độ phủ, và chúng tôi đã đo riêng trong so sánh các lựa chọn thay thế API SERP.
URL Inspection API trả về gì thay vào đó
URL Inspection API là bề mặt duy nhất của Google cho cảm giác như kiểm tra thứ hạng, vì bạn đưa cho nó một URL không có từ khóa và nhận lại một trạng thái. Chúng tôi thử hai URL.
Trạng thái URL | Phán quyết | Trạng thái độ phủ | Thời điểm thu thập lần cuối |
|---|---|---|---|
Xuất bản khoảng một giờ trước | NEUTRAL | URL mà Google không biết | Không rõ |
Xuất bản khoảng chín giờ trước | NEUTRAL | Đã phát hiện, hiện chưa được lập chỉ mục | Không rõ |
Cả hai trả về cùng một phán quyết. Trường thực sự phân biệt hai trường hợp là chuỗi trạng thái độ phủ, một câu chứ không phải một enum. Trường phán quyết ghi NEUTRAL cho cả URL mà Google chưa từng thấy lẫn URL mà nó đã phát hiện nhưng chưa lập chỉ mục.
Đây là một API dùng được và là tín hiệu giám sát yếu nếu đứng một mình. Nếu bạn muốn được cảnh báo khi một trang không được lập chỉ mục, hãy phân tích trạng thái độ phủ chứ không phải phán quyết, và hãy chờ đợi rằng thời điểm thu thập lần cuối sẽ vắng mặt đúng ở những URL bạn quan tâm nhất.
Bốn bề mặt và công việc mà không bề mặt nào làm
Câu hỏi | Bề mặt của Google | Câu trả lời |
|---|---|---|
Tuần trước tôi thể hiện thế nào với truy vấn này | Search Analytics API | Có, muộn ba ngày, dưới dạng trung bình |
URL này đã được lập chỉ mục chưa | URL Inspection API | Có, theo từng URL, khi có yêu cầu |
Tôi đang đứng ở đâu với bất kỳ từ khóa nào | không có | Không |
Đối thủ của tôi đang đứng ở đâu | không có | Không |
SERP của một từ khóa tôi chưa xếp hạng trông thế nào | không có | Không |
Mẫu hình nhất quán. API của Google mô tả property của bạn từ bên trong. Câu hỏi về thứ hạng được đặt từ bên ngoài, về một trang kết quả, và Google không cung cấp điều đó.
Cách lấp khoảng trống mà không trả quá nhiều
Cách bố trí thực tế là hai nguồn với hai nhiệm vụ khác nhau, không phải một nguồn bị đòi hỏi làm cả hai.
Dùng API của Google làm sự thật nền tảng về property của chính bạn. Lượt nhấp, lượt hiển thị và trạng thái chỉ mục là những dữ kiện gốc bạn không lấy được ở nơi nào khác, và chúng miễn phí. Kéo chúng theo lịch và coi độ trễ ba ngày là một thuộc tính của dụng cụ đo.
Dùng một nguồn SERP cho góc nhìn bên ngoài. Vị trí trực tiếp, vị trí đối thủ và những từ khóa bạn chưa xếp hạng. Đây là phần phải trả tiền, và nó rẻ hơn mức phần lớn các đội phỏng đoán: trong thử nghiệm của chúng tôi, kiểm tra 23 từ khóa ở độ sâu 100 tốn $0,2975, tức $0,0129 mỗi lần kiểm tra.
Đừng cố hòa giải hai con số. Chúng đo những thứ khác nhau. Nước đi hữu ích là đọc chúng cùng nhau: Search Console cho biết đã xảy ra chuyện gì, và kiểm tra trực tiếp cho biết đang xảy ra chuyện gì. Khi chúng không khớp, hãy xem cơ cấu quốc gia và thiết bị của truy vấn đó trước khi kết luận bất cứ điều gì.
Cơ chế chạy cả hai từ một script nằm trong bản dựng trình theo dõi hai nguồn của chúng tôi, và phần chi phí của nửa trực tiếp được định giá trong thử nghiệm kiểm tra hàng loạt.
Câu hỏi thường gặp
Google có API xếp hạng chính thức không? Không. Google công bố API cho hiệu suất tìm kiếm của chính bạn (Search Analytics), trạng thái chỉ mục (URL Inspection) và hai kiểu gửi hẹp (Indexing). Không cái nào trả về thứ hạng cho một từ khóa.
Vì sao Search Console hiển thị vị trí nếu không có API xếp hạng? Vì vị trí trung bình là một chỉ số hiệu suất tính từ lượt hiển thị của bạn, không phải một truy vấn thứ hạng. Đó là vị trí trung bình trên mọi lượt hiển thị trong kỳ, được lấy trung bình qua các quốc gia, thiết bị và bề mặt.
Dữ liệu Search Console trễ bao lâu? Ba ngày trong phép đo của chúng tôi vào ngày 12 tháng 9 năm 2026, với ngày có sẵn mới nhất là ngày 9 tháng 9. Tham số window đếm ngược từ ngày đó, nên yêu cầu bảy ngày trả về tám ngày kết thúc vào ngày có sẵn mới nhất.
URL Inspection API có cho biết một trang đã được lập chỉ mục chưa không? Có, và đó là công cụ đúng cho việc này. Hãy đọc chuỗi trạng thái độ phủ chứ không phải trường phán quyết, vì phán quyết trả về NEUTRAL cho cả URL không xác định lẫn URL đã phát hiện nhưng chưa lập chỉ mục.
Custom Search JSON API có phải API xếp hạng không? Không. Nó trả về kết quả từ một công cụ tìm kiếm do bạn tự cấu hình, không phải vị trí của bạn trong kết quả chính của Google.
Cách rẻ nhất để có dữ liệu thứ hạng thật là gì? Kiểm tra tập từ khóa nhỏ nhất mà bạn thực sự hành động dựa trên nó, ở độ sâu phù hợp với nơi bạn đang xếp hạng. Kiểm tra ở độ sâu 10 tốn $0,002 mỗi từ khóa trong thử nghiệm của chúng tôi và độ sâu 100 tốn $0,014, nghĩa là thiết lập độ sâu làm hóa đơn dịch chuyển gấp bảy lần so với số lượng từ khóa.
Góc nhìn của Auspia: câu trả lời trung thực cho "có API xếp hạng của Google không" là không, và bước tiếp theo hữu ích là ngừng tìm kiếm nó. API của Google trả lời tốt các câu hỏi dữ liệu gốc và hoàn toàn không thể trả lời câu hỏi về thứ hạng. Hãy dành một khoản nhỏ cho góc nhìn bên ngoài, và dùng phần công sức còn lại cho phần mà Google sẽ không làm thay bạn, đó là quyết định phải thay đổi điều gì khi hai con số không khớp.
Tác giả: Gabriel Finch, nhà nghiên cứu truy xuất tìm kiếm, với việc rà soát hơn 1.200 câu trả lời AI tại Auspia. Viết về hạ tầng tìm kiếm, hệ thống truy xuất và việc mỗi nguồn dữ liệu thực sự nhìn thấy được gì.
