SEO API cho stack của riêng bạn
Dữ liệu SEO và hiển thị AI của bạn, qua một endpoint REST gọn gàng.
Kéo dữ liệu Google Search Console, thứ hạng và AI Tracker thẳng vào sản phẩm, bảng điều khiển hoặc kho dữ liệu của bạn. Xác thực bằng Bearer key từ bảng điều khiển của bạn, gọi REST `/v1`, và nhận về JSON có kiểu — cùng lớp dữ liệu chuẩn vận hành SEOcrawl AI MCP. GA4, xuất site audit đầy đủ và OAuth đối tác đa người thuê sẽ ra mắt tiếp theo.
Xác thực Bearer · 60 yêu cầu/phút · Cùng lớp dữ liệu với MCP · Không scraping
$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
-H "Authorization: Bearer sca_live_…"
{ "data": {
"period": { "from": "2026-06-09", "to": "2026-07-06" },
"metrics": {
"clicks": 2388, "impressions": 811019,
"ctr": 0.00294, "position": 22.87
},
"metrics_diff": { "clicks": 584, … }
} }
Xác thực một lần. Gọi REST.
Tạo một token Bearer từ bảng điều khiển của bạn và truyền nó trong header Authorization. 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_here# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
-H "Authorization: Bearer sca_live_…"
curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
-H "Authorization: Bearer sca_live_…"
// JavaScript
const res = await fetch(
"https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
{ headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();
# Python
import requests
r = requests.get(
f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
params={"range": "last_28_days"},
headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())Một lớp dữ liệu, hai bề mặt
Mọi endpoint REST đều đọc từ cùng lớp chuẩn với các công cụ MCP — nên bảng điều khiển và các tác nhân AI của bạn luôn thấy những con số y hệt nhau. Các nhóm này đã trực tiếp trong v1; phạm vi liên tục được mở rộng.
Thuộc tính
Liệt kê các thuộc tính Search Console mà bạn có thể truy cập. Dùng `id` của mỗi thuộc tính trong path của mọi endpoint dữ liệu.
- GET
/v1/propertiesTrực tiếp
Google Search Console
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ỳ.
- GET
/v1/properties/{id}/gsc/summaryTrực tiếp - GET
/v1/properties/{id}/gsc/compareTrực tiếp - GET
/v1/properties/{id}/gsc/top-keywordsTrực tiếp - GET
/v1/properties/{id}/gsc/top-pagesTrực tiếp - GET
/v1/properties/{id}/gsc/keywords/detailTrực tiếp - GET
/v1/properties/{id}/gsc/pages/detailTrực tiếp
AI Tracker
Đọc các prompt bạn theo dõi cho lượt nhắc thương hiệu trên ChatGPT, Claude, Gemini và Perplexity.
- GET
/v1/properties/{id}/ai-tracker/promptsTrực tiếp
Nhiệm vụ
Đọc và ghi các nhiệm vụ SEO — kết nối bảng nhiệm vụ của bạn vào stack quản lý dự án của riêng bạn.
- GET
/v1/properties/{id}/tasksTrực tiếp - POST
/v1/properties/{id}/tasksTrực tiếp - GET
/v1/properties/{id}/tasks/{ticketId}Trực tiếp - PATCH
/v1/properties/{id}/tasks/{ticketId}Trực tiếp - POST
/v1/properties/{id}/tasks/{ticketId}/commentsTrực tiếp
GA4 & Lập chỉ mục
Lưu lượng, nguồn giới thiệu AI và trạng thái lập chỉ mục. Điểm kết nối đã sẵn sàng; các endpoint REST đang được triển khai.
- GET
/v1/properties/{id}/ga4/summarySắp có - GET
/v1/properties/{id}/indexation/summarySắp có
Site Audit
Sức khỏe thu thập, on-page, kỹ thuật và danh sách vấn đề — toàn bộ tập dữ liệu audit, cung cấp qua REST.
- GET
/v1/properties/{id}/audit/summarySắp có - GET
/v1/properties/{id}/audit/issuesSắp có
Xây cho sản phẩm, không phải cho scraper
Một REST API đích thực với xác thực Bearer, scope và giới hạn tần suất — dùng chung một lớp dữ liệu chuẩn với MCP nên các con số không bao giờ mâu thuẫn.
REST gọn gàng, JSON có kiểu
Tài nguyên dễ đoán, các verb chuẩn, phản hồi JSON có kiểu và lỗi tuân thủ RFC (401 chưa xác thực, 403 scope_required, 429 kèm Retry-After). Không scraping HTML, không xuất dữ liệu dễ gãy.
Một lớp dữ liệu chuẩn
Endpoint REST và công cụ MCP là anh em trên cùng các 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.
Key tự phục vụ
Tạo và thu hồi token Bearer từ bảng điều khiển của bạn trong vài giây. Cùng một key sca_live_ xác thực cả REST API lẫn máy chủ MCP — một thông tin xác thực, hai bề mặt.
Giới hạn tần suất có tài liệu
60 yêu cầu mỗi phút và 1.000 mỗi giờ trên mỗi token, với phản hồi 429 + Retry-After rõ ràng. Giới hạn REST là một pool tách biệt với mức dùng MCP — cái này không bao giờ làm cạn cái kia.
Truy cập theo scope
Các scope đọc và ghi ở mức thô kiểm soát mọi endpoint, được thực thi tại tường lửa với phản hồi step-up chuẩn. Chỉ cấp cho một key đúng những gì nó cần.
Đa người thuê, sắp có
Một luồng Google OAuth theo từng người thuê để đối tác có thể kết nối từng thuộc tính GSC của khách hàng của họ dưới một tài khoản — với cách ly dữ liệu nghiêm ngặt. Đang được phát triển tích cực; hãy hỏi chúng tôi để có quyền truy cập sớm.
Bắt đầu trong 3 bước
Từ con số không đến lệnh gọi có xác thực đầu tiên của bạn chỉ trong vài phút.
Tạo một key
Mở token API trong bảng điều khiển của bạn và tạo một token Bearer. Sao chép nó một lần — nó bắt đầu bằng `sca_live_`.
Gửi header
Truyền `Authorization: Bearer sca_live_…` trên mọi yêu cầu tới `https://api.seocrawl.ai/v1`. Cùng một key cũng hoạt động với máy chủ MCP.
Kéo dữ liệu
Gọi `GET /v1/properties` để lấy `id` của một thuộc tính, rồi truy cập `/v1/properties/{id}/…` để lấy hiệu suất GSC, prompt AI Tracker hoặc nhiệm vụ — và đưa JSON thẳng vào sản phẩm, bảng điều khiển hoặc kho dữ liệu của bạn.
Ba cách tiếp cận dữ liệu của bạn
Cùng con số, khác bề mặt — chọn cái phù hợp với cách 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.
Máy chủ MCP
Cho các tác nhân AI — Claude, ChatGPT và bất kỳ client MCP nào truy vấn dữ liệu 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 của bạn từ bất kỳ tác nhân terminal hỗ trợ MCP nào.
Xem CLIAi xây dựng trên API
Các đội muốn có dữ liệu SEO và hiển thị AI ngay trong hệ thống của riêng họ.
SaaS & đối tác
Nhúng số liệu SEO trực tiếp vào giao diện sản phẩm của riêng bạn. Cung cấp cho người dùng của bạn dữ liệu Search Console và hiển thị AI mà không phải tự xây pipeline.
Agency
Đưa dữ liệu của mọi khách hàng vào một cổng tùy chỉnh, 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 xuất thủ công.
Đội dữ liệu
Đưa dữ liệu GSC, thứ hạng và AI Tracker vào kho dữ liệu của bạn theo lịch. Kết hợp với doanh thu và dựng các 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 kiểm tra và cảnh báo, đồng bộ nhiệm vụ với công cụ PM của bạn, và kết nối giám sát hiển thị AI vào các ứng dụng bạn đã phát hành.
Câu hỏi thường gặp
Có thật sự tồn tại một SEO API công khai không?
Có — một REST `/v1` API xác thực bằng Bearer đã trực tiếp, bao phủ hiệu suất Search Console, thuộc tính, prompt AI Tracker và nhiệm vụ, với tài liệu tham khảo công khai đầy đủ được xuất bản tại api.seocrawl.ai/docs. Phạm vi rộng hơn (GA4, xuất site audit đầy đủ) và OAuth đối tác đa người thuê sẽ ra mắt tiếp theo. Cần thứ gì đó chưa trực tiếp? Hãy hỏi chúng tôi để có quyền truy cập sớm.
Tôi xác thực bằng cách nào?
Bằng một token Bearer. Tạo một 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>` trên mọi yêu cầu. Không có bước OAuth nào cho tài khoản của riêng bạn — chỉ cần header.
Có phải cùng một key với MCP không?
Đúng vậy. Cùng một token xác thực cả REST API lẫn máy chủ MCP, vì cả hai đều đọc từ một lớp dữ liệu chuẩn. Một thông tin xác thực, hai bề mặt — và những con số y hệt nhau trên cả 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ờ trên mỗi token. Vượt quá thì bạn nhận được một `429` kèm header `Retry-After`. Giới hạn REST được theo dõi tách biệt với mức dùng MCP, nên cả hai không bao giờ tranh cùng một ngân sách.
Tôi có thể kết nối các thuộc tính Search Console của khách hàng không?
Luồng đối tác đa người thuê đó — một Google OAuth theo từng người thuê để bạn có thể kết nối từng thuộc tính GSC của khách hàng dưới tài khoản của riêng bạn, với cách ly dữ liệu nghiêm ngặt — đang được phát triển tích cực. Nếu bạn đang xây một tích hợp đối tác, hãy liên hệ để có quyền truy cập sớm.
Hôm nay tôi có thể kéo dữ liệu gì?
Tóm tắt Search Console và so sánh theo kỳ, từ khóa và trang hàng đầu, chi tiết một từ khóa/trang, danh sách thuộc tính của bạn, prompt AI Tracker, và đọc/ghi đầy đủ trên nhiệm vụ. Nó phản chiếu những gì MCP cung cấp, qua REST.
Sẵn sàng xây dựng trên dữ liệu SEO của bạn?
Tạo một Bearer key từ bảng điều khiển của bạn và thực hiện lệnh gọi REST đầu tiên trong vài phút — hoặc trao đổi với chúng tôi về quyền truy cập đối tác và đa người thuê.