Cách kiểm tra vị trí từ khóa bằng Google API (hướng dẫn 2026)

Bài trắc nghiệm nhanh

Bạn nên theo dõi thứ hạng trên Google bằng cách nào?

Câu hỏi 1 trên 425%

Vì sao bạn muốn theo dõi thứ hạng?

Để xem vị trí của tôi ở đâuĐể cải thiện chúngĐể cho khách hàng hoặc cấp trên thấy kết quả

Cố gắng kiểm tra vị trí từ khóa bằng Google API là một trong những việc trông như đã được giải quyết cho đến khi bạn thực sự thử. Không có endpoint rankings.get(), và hai API Google mà người ta dùng đầu tiên mỗi API trả lời một câu hỏi hơi khác với câu hỏi được đặt ra. Tài liệu Search Analytics của Search Console là nơi nên bắt đầu, miễn là bạn hiểu “vị trí” nghĩa là gì ở đó.

Google có API xếp hạng từ khóa chính thức không?

Không. Google chưa bao giờ phát hành API nhận một từ khóa và trả về vị trí trực tiếp của bạn trên google.com. Điều này là có chủ đích: truy vấn tự động vào trang kết quả tìm kiếm bị cấm theo điều khoản của Google, và công ty không có lợi ích thương mại nào trong việc cung cấp hạ tầng theo dõi thứ hạng.

Thay vào đó, có ba lối đi một phần, mỗi lối có một giới hạn cứng:

Làm sao để lấy vị trí từ khóa từ Search Console API?

Truy vấn endpoint searchAnalytics với chiều query và đọc trường position. Đây là dữ liệu bên thứ nhất lấy trực tiếp từ Google, miễn phí, và không có giới hạn số từ khóa: bạn nhận được mọi truy vấn mà trang đã nhận lượt hiển thị.

Yêu cầu hoạt động bằng Python:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

Ba giới hạn khiến người ta vấp

• Vị trí là một trung bình, không phải thứ hạng. Giá trị 7.4 không có nghĩa là bạn đứng vị trí 7; nó có nghĩa là lượt hiển thị được phân bố ở các vị trí có trung bình 7.4, có thể dao động từ 3 đến 15 tùy thiết bị và địa điểm.
• Chỉ trang của bạn. Không có cách nào xem vị trí của đối thủ. Search Console là một API được giới hạn theo thuộc tính, đó là thiết kế của nó.
• Từ khóa không có lượt hiển thị thì vô hình. Nếu bạn đứng vị trí 60 và không ai cuộn tới đó, truy vấn đó không xuất hiện trong dữ liệu chút nào.

Điểm thứ ba là điều âm thầm làm hỏng báo cáo. Một từ khóa mà bạn chưa đưa lên trang đầu đơn giản là không tồn tại trong Search Console, khiến việc đo tiến độ từ vị trí 60 lên vị trí 20 chỉ bằng API này là không thể.

Tôi có thể dùng Custom Search JSON API để kiểm tra thứ hạng không?

Về mặt kỹ thuật thì được, về mặt ý nghĩa thì không. Custom Search JSON API yêu cầu bạn tạo một Programmable Search Engine trước. Ngay cả khi được cấu hình để tìm trên toàn bộ web, nó vẫn áp dụng cách xếp hạng và các giới hạn riêng, nên thứ tự nó trả về không phải thứ tự google.com trả về.

Gói miễn phí cũng giới hạn 100 truy vấn mỗi ngày, còn dùng trả phí được tính theo mỗi nghìn truy vấn và có trần hằng ngày. Với một vài từ khóa kiểm tra thỉnh thoảng thì vẫn dùng được. Nhưng khi làm công cụ theo dõi thứ hạng, nó cho ra những con số trông có thẩm quyền mà thật ra sai một cách âm thầm, và điều này còn tệ hơn việc không có dữ liệu nào.

Còn việc cào dữ liệu trực tiếp từ Google thì sao?

Đừng. Truy vấn tự động vào Google Search mà không có sự cho phép là trái với Điều khoản dịch vụ của Google, và ở bất kỳ quy mô nào cũng dễ bị chặn IP và gặp màn hình CAPTCHA. Ngoài vấn đề chính sách, thực tế kỹ thuật cũng khó chịu: kết quả được cá nhân hóa, bản địa hóa và ngày càng được ghép với các tính năng AI, nên một “vị trí” cào được thay đổi theo trung tâm dữ liệu, vị trí địa lý và phiên làm việc, ngay cả khi không có gì trên trang của bạn thay đổi.

Nếu bạn cần vị trí của đối thủ, một API SERP thương mại là con đường vừa hợp pháp theo thỏa thuận của nhà cung cấp, vừa ổn định khi vận hành. Đây là một khoản chi trả, và chi phí đó là cái giá trung thực cho dữ liệu mà Google không cho không. Các doanh nghiệp cần xây dựng và giám sát đường ống này mà không muốn tuyển nội bộ thường thuê một chuyên gia; bảng so sánh 10 đơn vị phân tích dữ liệu hàng đầu tại Pháp của chúng tôi liệt kê các nhà cung cấp thiết lập loại báo cáo này.

Bạn thực sự nên xây dựng gì?

Với hầu hết các đội nhóm, kiến trúc thực dụng là một mô hình lai, trông như sau:

• Search Console API làm xương sống. Miễn phí, không giới hạn từ khóa, là dữ liệu bên thứ nhất, và là nguồn duy nhất cho bạn biết bạn thực sự đang nhận lượt hiển thị cho những gì.
• Một API SERP cho một tập từ khóa nhỏ được chọn lọc. Khoảng hai mươi đến ba mươi thuật ngữ quan trọng về thương mại, kiểm tra mỗi ngày, bao gồm vị trí của đối thủ.
• Một lớp hiển thị AI. Ngày càng nhiều, câu hỏi không chỉ là “tôi đang ở vị trí nào” mà còn là “tôi có được trích dẫn khi ai đó hỏi một trợ lý không”. Các API xếp hạng cổ điển không trả lời được điều nào trong số đó.

Các đội nhóm muốn tự xây dựng hệ này thường giao cho chuyên gia; bảng so sánh 10 đơn vị SEO hàng đầu tại Pháp của chúng tôi giới thiệu những nhà cung cấp quản lý ngăn xếp báo cáo này cho khách hàng.

Điểm cuối cùng này không phải là mối lo tương lai. Khi một câu trả lời AI giải quyết truy vấn ngay trên giao diện, vị trí mười và vị trí ba cùng dẫn đến một kết quả như nhau: không có cú nhấp chuột. Theo dõi trích dẫn cùng với vị trí là điều máy chủ MCP của Search Console và nền tảng hiển thị AI của chúng tôi được xây dựng để làm, còn tài liệu hướng dẫn cài đặt đầy đủ từ đầu đến cuối.

Kết luận

Không có API chính thức nào của Google cho vị trí từ khóa trực tiếp: hãy dùng Search Console API cho dữ liệu trung bình của chính bạn, một API SERP bên thứ ba cho vị trí chính xác và vị trí cạnh tranh, và bỏ qua Custom Search JSON API hoàn toàn khi làm việc về thứ hạng. Xây dựng trên công cụ sai là lỗi phổ biến nhất ở đây, và nó tạo ra một bảng điều khiển sai một cách rất tự tin.

Nếu bạn không muốn tự xây dựng và duy trì đường ống đó, Sorank kết nối Search Console của bạn và theo dõi trích dẫn AI ở cùng một nơi.