Google Search Console API cho stack của riêng bạn
Dữ liệu hiệu suất Search Console của bạn, qua một endpoint REST gọn gàng.
Kéo số nhấp, hiển thị, CTR và vị trí trung bình — theo truy vấn, trang và khoảng thời gian — thẳng từ Google Search Console vào sản phẩm, bảng điều khiển hoặc kho dữ liệu của bạn. Kết nối GSC một lần bên trong SEOcrawl AI, tạo Bearer key từ bảng điều khiển của bạn, rồi gọi REST /v1 — không phải tự dựng OAuth của Google. Đây chính là lớp dữ liệu chuẩn vận hành SEOcrawl AI MCP, nên các con số của bạn luôn khớp nhau. Phạm vi lập chỉ mục và URL Inspection sẽ lên REST ngay sau đó; qua MCP thì đã dùng được rồi.
Lấy một thuộc tính. Kéo dữ liệu GSC.
Tạo một token Bearer từ bảng điều khiển của bạn và truyền nó trong header Authorization. Lấy id của thuộc tính Search Console một lần, rồi truy vấn hiệu suất của nó qua REST. Cùng một key hoạt động trên cả REST API lẫn máy chủ MCP.
Base URL
https://api.seocrawl.ai/v1Header Authorization
Authorization: Bearer sca_live_your_token_hereMọi chỉ số Search Console, qua REST
Số nhấp, hiển thị, CTR và vị trí trung bình — theo truy vấn, trang, khoảng thời gian và so sánh giữa các kỳ. Mọi endpoint đều gắn với một thuộc tính: lấy id của thuộc tính trước, rồi mới đọc dữ liệu Search Console của nó. Các nhóm GSC này đã chạy trong v1; phạm vi lập chỉ mục và URL Inspection hôm nay có trên MCP và sẽ lên REST ngay sau đó.
Thuộc tính
Liệt kê các thuộc tính Search Console đã kết nối với tài khoản của bạn. Dùng id của từng thuộc tính trong path của mọi endpoint GSC.
- GET
/v1/propertiesTrực tiếp
Hiệu suất
Tổng số nhấp, hiển thị, CTR và vị trí trung bình cho một khoảng thời gian — kèm chênh lệch so với kỳ liền trước của cùng cửa sổ đó.
- GET
/v1/properties/{id}/gsc/summaryTrực tiếp - GET
/v1/properties/{id}/gsc/compareTrực tiếp
Truy vấn
Những truy vấn tìm kiếm bạn đang xuất hiện, kèm chỉ số cho từng truy vấn — và toàn bộ lịch sử theo ngày của bất kỳ từ khóa nào.
- GET
/v1/properties/{id}/gsc/top-keywordsTrực tiếp - GET
/v1/properties/{id}/gsc/keywords/detailTrực tiếp
Trang
Những URL có hiệu suất tốt nhất cùng chỉ số Search Console — và toàn bộ diễn biến theo ngày của bất kỳ trang nào.
- GET
/v1/properties/{id}/gsc/top-pagesTrực tiếp - GET
/v1/properties/{id}/gsc/pages/detailTrực tiếp
Phạm vi lập chỉ mục
Những gì Google thực sự lập chỉ mục: trạng thái phạm vi và lịch sử lập chỉ mục. Hôm nay đã chạy trên MCP; các endpoint REST đang được triển khai.
- GET
/v1/properties/{id}/indexation/summarySắp có
URL Inspection
Kiểm tra từng URL — phạm vi, lần thu thập gần nhất và trạng thái lập chỉ mục của một trang. Đã dùng được qua MCP; REST sẽ có tiếp theo.
- GET
/v1/properties/{id}/url-inspectionSắp có
Dữ liệu Search Console thật, dựng cho sản phẩm
Hiệu suất Google Search Console thật của bạn — không phải ước lượng của bên thứ ba — qua một REST API gọn gàng với xác thực Bearer và giới hạn tần suất, dùng chung một lớp dữ liệu chuẩn với MCP để các con số không bao giờ lệch nhau.
Thẳng từ Search Console
Số nhấp, hiển thị, CTR và vị trí trung bình lấy từ chính thuộc tính GSC của bạn — con số thật mà Google báo cáo, không phải ước lượng mô hình hóa hay cào về. Tài nguyên dễ đoán, verb chuẩn, JSON có kiểu và lỗi tuân thủ RFC.
Không phải tự dựng OAuth của Google
Kết nối Search Console một lần bên trong SEOcrawl AI, rồi đọc nó bằng đúng một Bearer key sca_live_. Bỏ qua dự án Google Cloud, màn hình đồng ý và việc làm mới token — tạo và thu hồi key ngay trên bảng điều khiển trong vài giây.
Một lớp dữ liệu chuẩn duy nhất
Các endpoint REST của GSC và các công cụ GSC trong MCP là anh em trên cùng một nhà cung cấp, với tính tương đương được kiểm thử trong CI. Bảng điều khiển và các tác nhân AI của bạn luôn thấy số nhấp, hiển thị và vị trí y hệt nhau.
Chi tiết tới từng truy vấn và từng trang
Đọc tổng của một thuộc tính, hoặc đi sâu vào truy vấn hàng đầu, trang hàng đầu, xu hướng theo ngày của một từ khóa hay lịch sử của một URL — đúng những chiều bạn thấy trong Search Console, gọi được qua HTTP.
So sánh giữa các kỳ có sẵn
Yêu cầu một range (last_7_days, last_28_days, last_3_months, last_year) hoặc cặp ngày from/to tường minh, và nhận luôn phần so sánh giữa các kỳ — không cần gọi lần hai, không phải tính ngày ở phía client để khớp chênh lệch.
Giới hạn tần suất được ghi rõ
60 yêu cầu mỗi phút và 1.000 mỗi giờ cho mỗi token, với phản hồi 429 + Retry-After rõ ràng. Hạn mức REST được tính riêng, tách khỏi mức dùng MCP — bên này không bao giờ ăn hết phần của bên kia.
Bắt đầu trong 3 bước
Từ con số không đến lần gọi Search Console đầu tiên chỉ trong vài phút.
Tạo một key
Kết nối Search Console trong SEOcrawl AI, mở Token API và tạo một token Bearer. Sao chép ngay lần đầu — nó bắt đầu bằng sca_live_.
Lấy một thuộc tính
Gọi GET /v1/properties kèm Authorization: Bearer sca_live_… để lấy id (một UUID) của thuộc tính Search Console bạn muốn đọc.
Kéo dữ liệu GSC
Gọi /v1/properties/{id}/gsc/summary?range=last_28_days để lấy số tổng, hoặc /gsc/top-keywords, /gsc/top-pages và các endpoint /detail — rồi đẩy thẳng JSON vào sản phẩm, bảng điều khiển hay kho dữ liệu của bạn.
Ba cách tiếp cận dữ liệu Search Console
Cùng những con số GSC, khác bề mặt — chọn cách hợp với lối bạn xây dựng.
REST API
Cho sản phẩm, bảng điều khiển và pipeline dữ liệu. Xác thực Bearer, JSON có kiểu, giới hạn tần suất. Bạn đang ở trang này — SEO API đầy đủ bổ sung endpoint thứ hạng và hiển thị AI trên cùng một key.
Máy chủ MCP
Cho các tác nhân AI — Claude, ChatGPT và mọi client MCP hỏi dữ liệu Search Console của bạn bằng ngôn ngữ tự nhiên.
Khám phá MCPTerminal & CLI
Cho script và CI/CD — điều khiển dữ liệu GSC của bạn từ bất kỳ tác nhân terminal nào hỗ trợ MCP.
Xem CLIAi xây dựng trên Search Console API
Những đội muốn có dữ liệu hiệu suất GSC thật ngay trong hệ thống của riêng mình.
Agency
Đẩy dữ liệu Search Console của từng khách hàng vào portal riêng, Looker Studio hoặc lớp báo cáo của bạn — một key, mọi thuộc tính, không còn xuất GSC thủ công.
SaaS & đối tác
Nhúng chỉ số Search Console trực tiếp vào giao diện sản phẩm của riêng bạn. Đem số nhấp, hiển thị và vị trí đến cho người dùng mà không phải tự đấu nối API của Google.
Đội dữ liệu
Đưa số nhấp, hiển thị, CTR và vị trí từ GSC vào kho dữ liệu theo lịch. Ghép với doanh thu và dựng những mô hình mà bảng điều khiển của bạn cần.
Nhà phát triển
Tự động hóa việc theo dõi truy vấn và trang, cảnh báo khi thứ hạng tụt, và nối dữ liệu Search Console vào những ứng dụng và quy trình bạn đã phát hành.
Câu hỏi thường gặp
Đây có phải API Search Console chính thức của Google không?
Không. Đây là REST API của riêng SEOcrawl AI, xác thực bằng Bearer, đặt trên dữ liệu Search Console mà bạn đã kết nối vào tài khoản của mình. Bạn kết nối GSC một lần bên trong SEOcrawl AI, rồi đọc số nhấp, hiển thị, CTR và vị trí qua một key sca_live_ duy nhất — không phải tự tạo dự án Google Cloud, màn hình đồng ý OAuth hay cơ chế làm mới token. Các con số là số Search Console thật của bạn; còn API và phần xác thực là của chúng tôi.
Hôm nay tôi kéo được những dữ liệu Search Console nào?
Số tổng cho một khoảng thời gian (số nhấp, hiển thị, CTR, vị trí trung bình), so sánh giữa các kỳ, truy vấn hàng đầu và trang hàng đầu kèm chỉ số, cùng toàn bộ chi tiết theo ngày của một từ khóa hay một trang — cộng với danh sách các thuộc tính đã kết nối. Phạm vi lập chỉ mục và URL Inspection trực tiếp hiện đã dùng được qua MCP; các endpoint REST tương ứng sẽ ra tiếp theo. Còn nếu bạn muốn đọc cả tài khoản thay vì truy vấn nó, bài kiểm tra Google Search Console bao quát cùng dữ liệu đó chỉ trong một prompt.
Tôi xác thực bằng cách nào?
Bằng một token Bearer. Tạo key sca_live_ từ bảng điều khiển của bạn và gửi nó dưới dạng Authorization: Bearer <key> trong mọi yêu cầu. Với chính tài khoản của bạn thì không có màn OAuth nào cả — chỉ cần header đó.
Hỗ trợ những khoảng thời gian nào?
Mọi endpoint GSC đều nhận hoặc một range (last_7_days, last_28_days, last_3_months hay last_year), hoặc một cặp from/to tường minh. Endpoint gsc/compare trả về đúng cửa sổ đó đem so với kỳ liền trước, nên bạn có ngay chênh lệch mà không cần gọi lần hai.
Giới hạn tần suất là bao nhiêu?
60 yêu cầu mỗi phút và 1.000 mỗi giờ cho mỗi token. Vượt ngưỡng, bạn nhận 429 kèm header Retry-After. Hạn mức REST được tính tách khỏi mức dùng MCP, nên hai bên không bao giờ tranh nhau cùng một ngân sách.
Có phải cùng key và cùng dữ liệu với MCP không?
Đúng vậy. Cùng một token sca_live_ xác thực cho cả REST API lẫn máy chủ MCP, và cả hai đều đọc từ một lớp dữ liệu chuẩn duy nhất — nên những con số Search Console bạn kéo qua REST giống hệt những gì các tác nhân AI của bạn thấy qua MCP. Một thông tin xác thực, hai bề mặt.
Sẵn sàng xây dựng trên dữ liệu Search Console của bạn?
Kết nối GSC một lần, tạo Bearer key từ bảng điều khiển, và thực hiện lần gọi REST Search Console đầu tiên chỉ trong vài phút — hoặc khám phá MCP dành cho tác nhân AI.
