Tham chiếu API

API SEO

Trả theo LƯỢT, không tạo đơn: mỗi lệnh tra trừ ví giá FLAT ngay rồi lấy dữ liệu trong lượt gọi (thường 5–60 giây — đặt timeout phía bạn ≥ 100 giây). Không có dữ liệu · trang đích không truy cập được · lỗi khiến lượt không chốt được kết quả ⇒ hệ thống HOÀN TIỀN (lỗi thường kèm data.request_id · charged · refunded · refund_status). Ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy (gửi lại cùng Idempotency-Key) — trạng thái chắc chắn: GET /seo/request. Lệnh tra có thu tiền trả request_id — tra lại bằng GET /seo/request; gửi kèm Idempotency-Key để gửi lại an toàn (không trừ hai lần). Quét cả website và bản đồ nhiệt từ 7×7 chạy NỀN ⇒ HTTP 202 + request_id, hỏi tiến độ. Kết quả được lưu ⇒ xem lại bằng /seo/result (chủ bản miễn phí trong hạn). Giới hạn mỗi tài khoản (số cụ thể ở mục Giới hạn): lượt đang xử lý cùng lúc + lượt chạy nền chưa xong (429 BUSY) · lượt được hoàn do đầu vào (không có dữ liệu / trang không truy cập được) mỗi 24 giờ (429 RATE_LIMITED + Retry-After; reason daily_refund_limit). Gói miễn phí (tra domain free · đo tốc độ) giới hạn lượt / ngày. Theo dõi thứ hạng là THUÊ BAO THÁNG (dự án có order_code): tạo · thêm / bớt từ · gia hạn · tự gia hạn · kiểm ngay · lịch sử hạng. Chạy thử (X-Sandbox: 1): 0 đồng · 0 ghi · 0 gọi nguồn dữ liệu — kết quả mẫu cùng hình dạng phản hồi thật; lệnh chạy nền trả mã SANDBOX… để hỏi tiến độ (30 giây đầu đang chạy). Mảng tạm bảo trì ⇒ lệnh tra mới · tạo dự án · thêm từ khoá · xem bản có phí 503 SERVICE_DISABLED (gia hạn · chủ xem lại miễn phí · các thao tác khác trên dự án vẫn chạy).

Trên trang này
  1. Tổng quan
  2. Trả theo lượt & hoàn tiền
  3. Các món & giá
  4. Lượt chạy nền
  5. Bản lưu & xem lại
  6. Tra lại một lượt
  7. Giới hạn
  8. Theo dõi thứ hạng
  9. Tạm ngừng bán & bảo trì
  10. Chạy thử
  11. Luật riêng
  12. Mã lỗi riêng
  13. GET /seo/products
  14. GET /seo/pricing
  15. POST /seo/quote
  16. POST /seo/lookup
  17. POST /seo/keyword
  18. POST /seo/audit
  19. POST /seo/audit-compete
  20. POST /seo/audit-compete/speed
  21. POST /seo/speed
  22. POST /seo/local
  23. POST /seo/local-pro/find
  24. POST /seo/local-pro/grid
  25. GET /seo/local-pro/grid/status
  26. POST /seo/backlink
  27. POST /seo/tech
  28. POST /seo/crawl
  29. GET /seo/crawl/status
  30. GET /seo/crawl/history
  31. GET /seo/request
  32. GET /seo/requests
  33. GET /seo/result
  34. GET /seo/versions
  35. POST /seo/rank/create
  36. GET /seo/rank/list
  37. GET /seo/rank/info
  38. GET /seo/rank/detail
  39. GET /seo/rank/history
  40. GET /seo/rank/keyword-history
  41. POST /seo/rank/add-keywords
  42. POST /seo/rank/remove-keyword
  43. POST /seo/rank/auto-renew
  44. POST /seo/rank/toggle-renew
  45. POST /seo/rank/alerts
  46. POST /seo/rank/note
  47. POST /seo/rank/renew
  48. POST /seo/rank/check
  49. POST /seo/rank/delete

Tổng quan

Địa chỉ gốc của các endpoint trên trang này:

Base URL
https://cloudmoon.net/api/v1
EndpointViệcQuyền khoá
GET /seo/products Danh mục món SEO: mỗi mục tool · endpoint · enabled · giá theo VNĐ (giá FLAT — như nhau với mọi tài khoản, không chiết … Chỉ đọc
GET /seo/pricing Bảng giá khuôn CŨ của web con (danh mục kiểu mới: /seo/products) — cùng một nguồn giá. free_ratelimit_per_day = lượt tr… Chỉ đọc
POST /seo/quote BÁO GIÁ — không trừ tiền, không ghi gì, khoá chỉ đọc gọi được. Lệnh tra: {tool, …tham số y như lệnh thật} — tool = doma… Chỉ đọc
POST /seo/lookup TRA DOMAIN. tier free: 0 đồng — điểm on-page + chỉ số uy tín (onpage · authority), giới hạn lượt / ngày / tài khoản dùn… Toàn quyền
POST /seo/keyword NGHIÊN CỨU TỪ KHOÁ: lượng tìm · độ khó · ý định · CPC · xu hướng · từ liên quan / gợi ý / câu hỏi thường gặp · SERP top… Toàn quyền
POST /seo/audit KIỂM TRA ON-PAGE một URL: điểm on-page · issues (mức độ + cách sửa) · điểm tốt (goods) · thẻ tiêu đề / mô tả / heading … Toàn quyền
POST /seo/audit-compete SO ĐỐI THỦ — ĐỢT 1: kiểm tra on-page trang của bạn + trang đối thủ (mode top1 = tự chọn đối thủ: trang tự nhiên đầu tiê… Toàn quyền
POST /seo/audit-compete/speed SO ĐỐI THỦ — ĐỢT 2: đo tốc độ (Core Web Vitals) hai trang của bản so đối thủ lookup_id ⇒ bảng so sánh có tốc độ (speed_… Toàn quyền
POST /seo/speed TỐC ĐỘ TRANG (Google PageSpeed, MIỄN PHÍ): điểm + LCP · CLS · FCP · TBT · Speed Index (bản mobile). Dùng CHUNG hạn mức … Toàn quyền
POST /seo/local LOCAL SEO / Google Maps: top doanh nghiệp cho một từ khoá dịch vụ tại MỘT điểm (lãnh thổ Việt Nam) — hạng · đánh giá · … Toàn quyền
POST /seo/local-pro/find LOCAL PRO — BƯỚC 1: dò doanh nghiệp trên Google Maps quanh một điểm (theo name hoặc keyword) ⇒ candidates (tên · đánh g… Toàn quyền
POST /seo/local-pro/grid LOCAL PRO — BƯỚC 2: BẢN ĐỒ NHIỆT thứ hạng của doanh nghiệp tại N×N điểm quanh tâm (bán kính radius km). Giá theo cỡ lướ… Toàn quyền
GET /seo/local-pro/grid/status Tiến độ lượt bản đồ nhiệt CHẠY NỀN (7×7 trở lên): state running (msg tiến độ) · done (bản đồ đầy đủ như lưới đồng bộ, l… Chỉ đọc
POST /seo/backlink BACKLINK. mode explorer (mặc định): hồ sơ backlink của tên miền — điểm uy tín · số backlink / tên miền trỏ về · dofollo… Toàn quyền
POST /seo/tech SOI CÔNG NGHỆ WEBSITE: nền tảng (CMS / thương mại điện tử / tự viết) · mức tự sửa được · CDN / bảo mật · công cụ đo lườ… Toàn quyền
POST /seo/crawl QUÉT CẢ WEBSITE (bất đồng bộ): HTTP 202 state crawling + request_id ⇒ hỏi GET /seo/crawl/status tới done (báo cáo: điểm… Toàn quyền
GET /seo/crawl/status Tiến độ lượt quét cả web: state crawling (pages_crawled · in_queue · max_pages) · done (result = báo cáo đầy đủ) · bloc… Chỉ đọc
GET /seo/crawl/history Các lượt quét cả web của bạn (mới nhất trước): request_id · job_id · domain · max_pages · status (crawling · done · fai… Chỉ đọc
GET /seo/request MỘT lượt tra của bạn theo request_id (lệnh tra có thu tiền trả mã này — cả khi lỗi sau lúc đã trừ, trừ vài lỗi hệ thống… Chỉ đọc
GET /seo/requests Các lượt tra của bạn, MỚI nhất trước — mỗi mục như /seo/request. channel = web · api (lượt trên trang web cũng hiện). Chỉ đọc
GET /seo/result XEM LẠI một bản lưu (lookup_id): chủ bản trong hạn xem lại miễn phí ⇒ 0 đồng (free: true, khoá chỉ đọc gọi được) · còn … Chỉ đọc
GET /seo/versions Các BẢN LƯU gần nhất của một chủ đề (siêu dữ liệu — nội dung: /seo/result?id=lookup_id): kind domain (mặc định) · keywo… Chỉ đọc
POST /seo/rank/create TẠO dự án theo dõi thứ hạng từ khoá (THUÊ BAO THÁNG) — trừ phí tháng NGAY: max(min_price, làm tròn lên 1.000 của số từ … Toàn quyền
GET /seo/rank/list Các dự án theo dõi của bạn (mới nhất trước; không gồm dự án đã xoá) — mỗi mục như /seo/rank/info (không kèm từ khoá) + … Chỉ đọc
GET /seo/rank/info MỘT dự án: thông tin + price_renew (giá lần gia hạn kế — cùng hàm với lệnh gia hạn) + paid_keywords (số từ đã trả của k… Chỉ đọc
GET /seo/rank/detail Khuôn CŨ của web con {project, keywords} (nội dung như /seo/rank/info) + diagnose — Bác sĩ thứ hạng: từ sát top 10 · đa… Chỉ đọc
GET /seo/rank/history Hạng TRUNG BÌNH của dự án theo ngày (tối đa 120 ngày có bản ghi gần nhất, cũ → mới — vẽ biểu đồ): d · avg_rank · top10 … Chỉ đọc
GET /seo/rank/keyword-history Lịch sử hạng của MỘT từ khoá (60 lần kiểm gần nhất, cũ → mới; rank 0 = ngoài top). keyword_id lấy từ /seo/rank/info. Chỉ đọc
POST /seo/rank/add-keywords THÊM từ khoá: chỉ phần VƯỢT số từ đã trả của kỳ (paid_keywords) mới thu — phí = (giá tháng theo số từ sau khi thêm − gi… Toàn quyền
POST /seo/rank/remove-keyword BỚT một từ khoá — xoá MỀM (lịch sử giữ; thêm lại trong kỳ là khôi phục), KHÔNG hoàn tiền tháng đang dùng; số từ đã trả … Toàn quyền
POST /seo/rank/auto-renew ĐẶT tự gia hạn (không lật — gửi lại cùng giá trị vẫn đúng). Bật ⇒ từ 2 ngày trước hạn, mỗi giờ hệ thống thử tự trừ ví g… Toàn quyền
POST /seo/rank/toggle-renew Khuôn CŨ của web con: gửi enabled ⇒ ĐẶT; vắng ⇒ LẬT trạng thái tự gia hạn. Dùng mới: /seo/rank/auto-renew. Toàn quyền
POST /seo/rank/alerts ĐẶT nhận cảnh báo biến động thứ hạng (gửi theo kênh trong cài đặt thông báo của tài khoản). Toàn quyền
POST /seo/rank/note Ghi chú riêng của bạn cho dự án (≤ 255 ký tự; rỗng = xoá). Toàn quyền
POST /seo/rank/renew GIA HẠN +1 tháng — trừ ví NGAY theo price_renew lúc gọi (giá cao hơn giữa giá đã chốt và giá hiện hành theo số từ); phả… Toàn quyền
POST /seo/rank/check KIỂM HẠNG NGAY các từ của dự án trong ngân sách thời gian của lượt gọi (KHÔNG trừ tiền — nằm trong thuê bao): dự án đan… Toàn quyền
POST /seo/rank/delete XOÁ dự án — KHÔNG hoàn tiền tháng đang dùng, không khôi phục được (confirm = đúng order_code): ngừng đo, status expired… Toàn quyền

Giá đại lý: Giá FLAT như nhau với mọi tài khoản — mảng SEO không có chiết khấu đại lý (danh mục, báo giá và lệnh trả về đúng số trừ ví). — xem mục Tài khoản đại lý.

Trả theo lượt & hoàn tiền

Mảng SEO không tạo đơn cho lượt tra: mỗi lệnh tra kiểm hết (đầu vào, món đang bán, giới hạn, số dư) rồi trừ ví ngay và lấy dữ liệu trong cùng lượt gọi — thường 5–60 giây, tối đa khoảng 85 giây. Đặt thời gian chờ HTTP phía bạn từ 100 giây. Lệnh bị chối ở bước kiểm chưa trừ đồng nào.

  • Thành công — HTTP 200: phong bì chung của lệnh tra có thu tiền — request_id (mã lượt — mục Tra lại một lượt) · tool · tier (gói của tra domain / từ khoá; backlink normal · link gap premium; món khác null) · subject (đối tượng đã chuẩn hoá) · amount (số đã trừ) · charged · lookup_id (bản lưu — null với món không lưu) — kèm kết quả của món. Tra domain tier: free không trừ tiền, request_id: null; /seo/speed có phản hồi riêng (không phong bì).
  • Lượt không chốt được kết quả sau khi đã trừ ⇒ hệ thống hoàn tiền: không có dữ liệu cho đối tượng ⇒ 422 NO_DATA · trang / website đích không truy cập được ⇒ 422 TARGET_UNREACHABLE · nguồn dữ liệu hoặc hệ thống lỗi, hết thời gian ⇒ 503 UNAVAILABLE. Lỗi thường kèm data: request_id · charged · refunded · refund_status (bảng dưới) · reason khi có. Chỉ refunded: true mới xác nhận tiền đã về ví; lần hoàn chưa xong (refund_pending / checking) thì hệ thống tự hoàn tiếp — theo dõi bằng GET /seo/request.
  • Ngoại lệ hiếm: lượt đã xong (đã thu, đã chốt kết quả) mà máy chủ chưa dựng được câu trả lời ⇒ 503 UNAVAILABLE chỉ kèm request_id — không hoàn tiền: gửi lại cùng Idempotency-Key; món có bản lưu thì còn đọc được qua GET /seo/request (lookup_id) rồi /seo/result; món không lưu bản (dò doanh nghiệp, soi công nghệ) có thể chỉ khôi phục được trạng thái lượt (result_unavailable: true) — liên hệ hỗ trợ kèm request_id. Lệnh chạy nền: lỗi khi dựng phản hồi 202 cũng ⇒ 503 chỉ kèm request_id, lượt vẫn chạy tiếp như bình thường — theo dõi GET /seo/request (gửi lại cùng khoá khi lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING).
  • Đối tượng vừa được xác định là không có dữ liệu (tra domain, từ khoá, backlink) ⇒ 422 NO_DATA ngay ở bước kiểm, không thu tiền (data.reason no_data_recent, không có request_id).
  • Lượt đã thu rồi hoàn xong vì đầu vào (NO_DATA · TARGET_UNREACHABLE) tính vào giới hạn lượt được hoàn mỗi 24 giờ (mục Giới hạn); lỗi phía hệ thống không tính. Không phải món nào rỗng cũng hoàn: dò doanh nghiệp không tìm thấy ai và link gap không có cơ hội nào vẫn là kết quả có phí.
  • Idempotency-Key bắt buộc ở mọi lệnh tra (kể cả hạng free), ba lệnh tiền của theo dõi thứ hạng (tạo · gia hạn · thêm từ) và lượt xem lại có phí — thiếu ⇒ 400 IDEMPOTENCY_KEY_REQUIRED, lệnh chưa chạy: gửi lại cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai. Lượt đầu còn đang chạy ⇒ 409 IDEMPOTENCY_PENDING (kèm data.request_id khi lượt đã được nhận). Lệnh tra mà phản hồi lần đầu chưa kịp lưu (đứt giữa chừng) ⇒ hệ thống dựng lại từ dữ liệu còn giữ — có thể result: null + result_unavailable: true; xem lại bản có phí và ba lệnh tiền của theo dõi thứ hạng thì không dựng lại mà trả 409 — xem dự án bằng /seo/rank/info / /seo/rank/list, đừng đổi khoá để thử lại (409 kéo dài ⇒ liên hệ hỗ trợ kèm Idempotency-Key). Bản phát lại giữ trạng thái hoàn lúc lưu: trạng thái mới nhất của lượt đọc bằng GET /seo/request. Lượt đã hoàn muốn tra lại ⇒ gửi lệnh mới với khoá mới. /seo/speed (miễn phí) không nhận khoá này.
  • 503 UNAVAILABLE không có request_id thường là lời chối trước khi nhận lượt (hệ thống bận, nguồn dữ liệu tạm ngắt, món đang cập nhật giá — chưa trừ tiền); hiếm khi là lỗi hệ thống giữa chừng chưa xác định được lượt. Có request_id ⇒ lượt đã được nhận: đọc refunded / refund_status hoặc GET /seo/request. Trước khi tạo lệnh mới: xem GET /seo/requests, hoặc gửi lại cùng Idempotency-Key.
  • Quét cả website cùng tên miền với một lượt quét của bạn đang chạy, hoặc vừa xong chưa quá 30 phút ⇒ hệ thống giao lại đúng lượt ấy: reused: true, amount: 0, không trừ tiền (mục Lượt chạy nền).
refund_statusNghĩa
refundedTiền của lượt đã hoàn về ví (ở lượt này, hoặc từ trước — vd hệ thống đã tự hoàn lượt bị ngắt giữa chừng) — refunded: true.
refund_pendingLần hoàn chưa xong — hệ thống tự hoàn lại trong ít phút; đừng tra lại bằng cùng khoá, theo dõi bằng GET /seo/request.
checkingChưa rõ lượt đã chốt hay chưa — hệ thống đang đối soát và tự hoàn nếu cần; đừng gửi lại.
not_chargedLượt này không thu tiền nên không có gì để hoàn.

Các món & giá

Giá như nhau với mọi tài khoản (không chiết khấu đại lý), đọc lúc tải trang. Số chính xác của một lệnh: POST /seo/quote (cùng bộ kiểm với lệnh thật — sai đầu vào, món tạm ngừng, chạm giới hạn ⇒ đúng lỗi của lệnh ấy) hoặc GET /seo/products.

MónLệnhTra mớiXem lại bản lưu
Phân tích domain — miễn phíPOST /seo/lookup tier: free0 đ — 30 lượt / ngày / tài khoản—
Phân tích domain — ThườngPOST /seo/lookup tier: normal9.000đ2.000đ
Phân tích domain — Chuyên sâuPOST /seo/lookup tier: premium31.000đ5.000đ
Nghiên cứu từ khoá — ThườngPOST /seo/keyword7.000đ2.000đ
Nghiên cứu từ khoá — Chuyên sâuPOST /seo/keyword tier: premium10.000đ3.000đ
Kiểm tra on-pagePOST /seo/audit2.000đ1.000đ
So đối thủ (hai đợt)POST /seo/audit-compete11.000đ4.000đ
Local SEO / Google MapsPOST /seo/local3.000đ1.000đ
Local Pro — dò doanh nghiệpPOST /seo/local-pro/find1.000đ (thu cả khi 0 kết quả)—
Local Pro — bản đồ nhiệtPOST /seo/local-pro/grid3x3 12.000đ · 5x5 15.000đ · 7x7 19.000đ · 9x9 25.000đ · 11x11 32.000đ5.000đ
BacklinkPOST /seo/backlink17.000đ5.000đ
Link GapPOST /seo/backlink mode: gap13.000đ4.000đ
Soi công nghệ websitePOST /seo/tech2.000đ— (không lưu bản)
Quét cả websitePOST /seo/crawl20đ / trang (× 5 khi js_render), tối thiểu 5.000đ, tối đa 10.000 trang— (báo cáo qua crawl/status)
  • POST /seo/speed — đo tốc độ trang (Google PageSpeed) miễn phí, dùng chung hạn mức lượt miễn phí với tra domain tier: free.
  • Bản đồ nhiệt tính giá theo cỡ lưới (số điểm quét), không theo bán kính; từ 7×7 chạy nền. Dò doanh nghiệp (bước 1) thu phí kể cả khi không tìm thấy ai, chỉ hoàn khi hệ thống lỗi.
  • Theo dõi thứ hạng là thuê bao tháng — giá ở mục Theo dõi thứ hạng.

Lượt chạy nền

  • Quét cả website (luôn chạy nền) và bản đồ nhiệt từ 7×7 trả HTTP 202 — tiền đã trừ, request_id có ngay, state là crawling (quét) hoặc running (bản đồ nhiệt). Lưới 3×3 và 5×5 trả kết quả ngay (HTTP 200).
  • Hỏi tiến độ mỗi 5–10 giây: GET /seo/crawl/status?request_id=… — crawling ⇒ done (báo cáo đầy đủ) · blocked (website chặn trình quét — kèm status_code, da_hoan khi có) · failed (kèm msg); GET /seo/local-pro/grid/status?request_id=… — running ⇒ done (bản đồ đầy đủ + lookup_id) · failed. blocked / failed = không giao được kết quả: lượt quét không chạy được thì hệ thống hoàn tiền — trạng thái tiền đọc bằng GET /seo/request (refunded · refund_pending …). Riêng bản đồ nhiệt đã quét xong mà bản lưu không còn (hiếm) cũng báo failed trong khi lượt đã thu (status: done) — liên hệ hỗ trợ kèm request_id.
  • Mỗi tài khoản tối đa 3 lượt chạy nền chưa xong ⇒ 429 BUSY (data.reason background_limit).
  • Gửi lại lệnh quét cùng tên miền trong lúc lượt cũ còn chạy, hoặc trong 30 phút sau khi nó xong ⇒ trả lại đúng lượt ấy (reused: true, 0 đồng, số trang của lượt cũ) — muốn quét lại với số trang khác thì đợi qua 30 phút. Lịch sử: GET /seo/crawl/history.

Bản lưu & xem lại

  • Món có bản lưu trả lookup_id: domain (Thường · Chuyên sâu) · từ khoá · kiểm tra on-page · so đối thủ · Local SEO · bản đồ nhiệt · backlink · link gap. Domain miễn phí, dò doanh nghiệp, soi công nghệ và quét cả website không có bản lưu (lookup_id: null).
  • GET /seo/result?id=<lookup_id>: bản do chính bạn tạo trong 30 ngày gần nhất ⇒ miễn phí (free: true, khoá Chỉ đọc gọi được); còn lại tính giá xem lại của món (cột cuối bảng giá) — giá lớn hơn 0 ⇒ cần khoá Toàn quyền (khoá Chỉ đọc ⇒ 403) và bắt buộc Idempotency-Key (thiếu ⇒ 400 IDEMPOTENCY_KEY_REQUIRED) để gửi lại không bị trừ lần nữa; giá xem lại bằng 0 ⇒ khoá Chỉ đọc xem được, free: false. Xem bản không miễn phí nghe công tắc bán của món; chủ xem lại miễn phí thì không.
  • GET /seo/versions: các bản gần nhất của một chủ đề (siêu dữ liệu; is_free: 1 = bạn xem lại miễn phí được) — domain · từ khoá · kiểm tra on-page thường · Local SEO thường · backlink / link gap. Bản so đối thủ và bản đồ nhiệt không có trong danh sách này — xem bằng /seo/result với lookup_id của lượt.
  • Kết quả tra là dữ liệu về đối tượng (tên miền, từ khoá, trang, khu vực), không mang thông tin tài khoản của bạn — tài khoản khác tra cùng chủ đề có thể mở bản lưu ấy bằng giá xem lại.

Tra lại một lượt — request_id

Lệnh tra có thu tiền trả request_id — cả khi lỗi sau lúc đã trừ, trừ vài lỗi hệ thống hiếm (tra domain tier: free và /seo/speed thì không có). GET /seo/request?request_id=… đọc một lượt của bạn; GET /seo/requests liệt kê lượt mới nhất trước (lọc tool · status; limit 1–100 + offset) — gồm cả lượt bạn tra trên web (channel: "web"). Mất phản hồi giữa chừng ⇒ gửi lại cùng Idempotency-Key, hoặc tìm lượt ở danh sách này.

statusNghĩa
processingĐang chạy (lượt chạy nền: chờ báo cáo — hỏi tiến độ).
doneXong, đã thu tiền — lookup_id (nếu món có bản lưu) hoặc job_id (lượt chạy nền).
refundedKhông có kết quả, tiền đã hoàn — refund_reason: no_data · target_unreachable (đầu vào của bạn — tính vào giới hạn lượt được hoàn) · service_error (lỗi phía hệ thống — không tính).
refund_pendingLần hoàn trước chưa xong — hệ thống tự hoàn lại; refund_reason như dòng trên.
checkingHệ thống đang đối soát lượt (hiếm) — tự xử lý, tự hoàn nếu cần.

Lượt của người khác hoặc mã không có ⇒ 404.

Giới hạn

Mỗi tài khoản — đếm chung lượt trên web và qua API:

  • Tối đa 2 lượt tra đang xử lý trong lượt gọi cùng lúc ⇒ 429 BUSY (data.reason request_in_progress), cộng tối đa 3 lượt chạy nền chưa xong (background_limit) — lượt đã chuyển sang chạy nền không tính vào trần thứ nhất.
  • Tối đa 20 lượt đã thu rồi được hoàn vì đầu vào (NO_DATA · TARGET_UNREACHABLE) trong 24 giờ gần nhất ⇒ lệnh tra có thu tiền kế tiếp bị chối trước khi trừ tiền: 429 RATE_LIMITED, data.reason daily_refund_limit, Retry-After = số giây tới lúc có lại một chỗ. Gói miễn phí (dòng dưới) có hạn mức riêng.
  • Gói miễn phí: 30 lượt / ngày (theo giờ Việt Nam, mở lại lúc 0 giờ) dùng chung cho tra domain tier: free và /seo/speed ⇒ 429 RATE_LIMITED, data.reason free_daily_limit. Đo tốc độ lỗi ⇒ 503, lượt ấy không tính.
  • Hệ thống phân tích hoặc nguồn dữ liệu đang bận ⇒ 503 UNAVAILABLE, chối trước khi nhận lượt (không kèm request_id, chưa trừ tiền) — thử lại sau ít phút.
  • Giới hạn tần suất theo khoá (mục Giới hạn tần suất ở Tổng quan) vẫn áp như mọi endpoint.

Theo dõi thứ hạng (thuê bao tháng)

Mỗi dự án theo dõi là một đơn có order_code: một tên miền + tối đa 50 từ khoá, hệ thống đo hạng trên Google theo tần suất bạn chọn.

  • Phí tháng = max(10.000đ, làm tròn lên 1.000 của số từ × số lượt kiểm / tháng × 300đ mỗi lượt kiểm một từ) — 1day = 30 lượt / tháng · 3day = 10 lượt / tháng · 7day = 4 lượt / tháng; tần suất mặc định 7day. Trừ ngay khi tạo (POST /seo/rank/create — báo giá: quote với tool: rank_create).
  • Tạo xong hệ thống thử đo ngay tối đa 10 từ đầu (checked_now = số từ trong nhóm đo ngay · checked = số đã cập nhật được); các từ còn lại được đo dần ở các lượt kiểm tự động mỗi giờ. Tự gia hạn bật sẵn.
  • Gia hạn (POST /seo/rank/renew) +1 tháng (30 ngày), trừ price_renew lúc gọi — giá cao hơn giữa giá đã chốt và giá hiện hành theo số từ (phản hồi: data.price = số vừa trừ); hạn mới = max(bây giờ, hạn cũ) + 30 ngày. Mỗi dự án một lượt gia hạn mỗi ngày, tính cả ngày tạo (429 COOLDOWN, Retry-After tới 0 giờ). Gửi max_amount (số đã thấy ở báo giá) ⇒ giá thật cao hơn thì 409 PRICE_CHANGED, chưa trừ.
  • Tự gia hạn (POST /seo/rank/auto-renew với enabled — lệnh ĐẶT giá trị): từ 2 ngày trước hạn, mỗi giờ hệ thống thử trừ ví gia hạn một tháng, cùng giá với lệnh gia hạn.
  • Quá hạn mà chưa gia hạn (tắt tự gia hạn hoặc ví thiếu) ⇒ status: suspended — ngừng đo, dữ liệu giữ nguyên; gia hạn là chạy lại. Xoá (POST /seo/rank/delete, confirm = đúng order_code) ⇒ expired — kết thúc, không hoàn tiền tháng đang dùng, không khôi phục được.
  • Thêm từ khoá (POST /seo/rank/add-keywords): chỉ phần vượt số từ đã trả của kỳ (paid_keywords) mới thu — phí = (giá tháng theo số từ sau khi thêm − giá tháng theo paid_keywords) × số ngày còn lại tới hạn (làm tròn lên ngày) / 30, rồi làm tròn lên 1.000 đồng (gia hạn sớm thì số ngày còn lại có thể quá 30). Từ vừa bớt trong kỳ thêm lại là khôi phục (giữ lịch sử và hạng cũ) — vẫn tính vào số từ: vượt paid_keywords thì thu chênh như từ mới, nên added: 0 (chỉ đếm từ mới) vẫn có thể mất phí — đọc restored và charged. Không có từ mới lẫn từ khôi phục, hoặc đã đủ trần ⇒ thành công 0 đồng. Thêm xong hệ thống thử đo ngay tối đa 10 từ mới. Bớt từ (remove-keyword) không hoàn tiền; số từ đã trả của kỳ giữ nguyên.
  • Kiểm hạng ngay (POST /seo/rank/check) không trừ tiền — dự án đang chạy và còn hạn; một lần mỗi 60 phút mỗi dự án (429 COOLDOWN). Lệnh đo trong ngân sách thời gian của lượt gọi nên có thể chỉ cập nhật một phần (đọc checked / total); dự án còn từ mà chưa cập nhật được từ nào ⇒ 503 và lượt kiểm tay được trả lại; dự án không còn từ nào ⇒ thành công checked = total = 0 (vẫn tính lượt kiểm tay).
  • allowed_actions (ở list · info) — lệnh GHI mà trạng thái và hạn của dự án cho phép: renew · auto_renew · alerts · note · add_keywords · remove_keyword · check · delete. Dự án tạm dừng hoặc đã quá hạn: không có add_keywords và check (409 RENEW_REQUIRED); đã xoá: rỗng (409 ORDER_EXPIRED). Danh sách không xét nhịp (gia hạn trong ngày, kiểm tay vừa xong), số dư hay công tắc bán — lệnh vẫn kiểm các điều ấy khi gọi.
  • Dự án tạo qua API không tính hoa hồng giới thiệu ở mọi kỳ gia hạn về sau.

Tạm ngừng bán & bảo trì

  • Bảo trì hoặc tạm tắt cả mảng: lệnh tra mới, báo giá mua mới, tạo dự án theo dõi, thêm từ khoá và xem bản lưu không miễn phí ⇒ 503 SERVICE_DISABLED. Danh mục: khi bảo trì GET /seo/products trả 503 (và GET /services/status báo seo: false); khi tạm tắt, /seo/products vẫn 200 với enabled: false. Bảng giá khuôn cũ /seo/pricing luôn 200, ghi enabled: false ở từng món.
  • Ngừng bán một món hoặc một gói (danh mục ghi enabled: false) ⇒ lệnh của món ấy 404 PRODUCT_DISABLED, chưa trừ tiền. Món phụ thuộc đi theo: ngừng kiểm tra on-page thì so đối thủ và quét cả website cũng ngừng; ngừng Local SEO thì dò doanh nghiệp và bản đồ nhiệt cũng ngừng. Món không phụ thuộc vẫn bán.
  • Vẫn chạy trong cả hai trường hợp: chủ xem lại bản lưu miễn phí · đợt 2 của so đối thủ (audit-compete/speed — đã trả ở đợt 1) · hỏi tiến độ · tra lại lượt · các lệnh trên dự án theo dõi đang có (gia hạn, tự gia hạn, kiểm ngay, bớt từ, ghi chú, cảnh báo, xoá).

Chạy thử

  • Thêm X-Sandbox: 1 vào lệnh tra: máy chủ chạy đúng bộ kiểm của lệnh thật (đầu vào, món đang bán, giới hạn, số dư — ví thiếu vẫn 402) rồi trả kết quả mẫu cùng hình dạng phản hồi thật: 0 đồng, không gọi nguồn dữ liệu, không lưu bản (lookup_id mẫu = 0). amount là đúng số lệnh thật sẽ trừ lúc ấy.
  • request_id mẫu dạng SANDBOX… (tra domain tier: free mẫu: null). Lượt chạy nền mẫu trả 202; hỏi tiến độ hoặc /seo/request với mã ấy (vẫn kèm X-Sandbox: 1) ⇒ 30 giây đầu đang chạy rồi xong. X-Sandbox-Scenario: ngoài các mã lỗi ghi ở dòng Chạy thử của từng endpoint, quét cả website nhận thêm BLOCKED · FAILED, bản đồ nhiệt nhận FAILED ⇒ sau 30 giây lượt mẫu kết thúc blocked / failed (như đã hoàn); mã endpoint không nhận ⇒ 400.
  • Theo dõi thứ hạng: rank/create chạy thử trả order_code SANDBOX… mang số từ + tần suất của lệnh — các lệnh khác trên mã ấy chạy thử được. Với order_code / lookup_id thật, lệnh chạy thử kiểm trên chính đối tượng ấy rồi trả mô phỏng — không đổi gì.

Luật riêng

  • Số liệu (lượng tìm kiếm, lưu lượng truy cập, điểm uy tín, độ khó…) là ước tính từ nguồn dữ liệu — dùng để so sánh và định hướng, không phải số đo chính xác của Google.
  • Tên miền được chuẩn hoá về tên miền đăng ký theo danh sách hậu tố công khai (https://www.abc.com.vn/x ⇒ abc.com.vn); quét cả website giữ nguyên tên miền con bạn gửi. Từ khoá có dấu và không dấu là hai đối tượng khác nhau.
  • Giao dịch qua API (lượt tra, xem lại có phí, dự án theo dõi) không tính hoa hồng giới thiệu.
  • Không làm qua API: Bác sĩ Content (chấm / viết lại bài viết) — dùng trên web.

Mã lỗi riêng

Ngoài các mã lỗi chung của mọi endpoint, trang này còn có các mã dưới đây. Hãy rẽ nhánh theo code.

HTTPcodeÝ nghĩaNên làm gì
404 PRODUCT_DISABLED Món / gói SEO đang tạm ngừng bán (danh mục ghi enabled: false) — lệnh CHƯA trừ tiền. Đọc /seo/products, chọn món khác hoặc thử lại sau.
422 NO_DATA Chưa có dữ liệu cho đối tượng tra (tên miền / từ khoá / khu vực). Lượt đã thu ⇒ hệ thống hoàn tiền (data.refunded · refund_status) — hoàn xong thì lượt ấy tính vào giới hạn lượt được hoàn / 24 giờ; đối tượng vừa được xác định là không có dữ liệu ⇒ chối ngay ở bước kiểm, KHÔNG thu (data.reason no_data_recent, không có request_id). Thử đối tượng khác; tra lại ngay cùng đối tượng thường vẫn chưa có dữ liệu.
422 TARGET_UNREACHABLE Trang / website đích không truy cập được (chặn trình quét, lỗi máy chủ, sai địa chỉ) — hệ thống hoàn tiền lượt ấy (data.refunded: true = đã về ví; refund_status refund_pending / checking = đang xử lý); hoàn xong thì lượt ấy tính vào giới hạn lượt được hoàn / 24 giờ. Kiểm địa chỉ, mở chặn cho trình quét rồi gửi lại; trạng thái hoàn: /seo/request.
400 NOT_SUPPORTED Dự án theo dõi không làm được thao tác này (hiếm gặp — lệnh dùng đúng tài liệu không gặp). Liên hệ hỗ trợ kèm order_code.
400 CONFIRM_REQUIRED Lệnh xoá dự án theo dõi thiếu trường xác nhận. Gửi confirm bằng đúng order_code — xoá không khôi phục được và KHÔNG hoàn tiền tháng đang dùng.
409 PRICE_CHANGED Số sẽ trừ cao hơn max_amount bạn gửi (giá gia hạn ⇒ data.price · phí thêm từ ⇒ data.charge) — lệnh CHƯA trừ đồng nào. Báo giá lại (/seo/quote) rồi gửi lệnh mới.
409 RENEW_REQUIRED Dự án theo dõi đang tạm dừng / đã quá hạn — thêm từ khoá và kiểm hạng ngay bị chặn tới khi gia hạn. Gia hạn (/seo/rank/renew) rồi thao tác lại.
409 ORDER_EXPIRED Dự án theo dõi đã bị xoá — không thao tác được nữa. Tạo dự án mới (/seo/rank/create).
409 PENDING_CHECK Lệnh tiền vừa gọi trên dự án (tạo · gia hạn · thêm từ) chưa xác định được đã chốt hay chưa — hệ thống đang đối soát. Đừng gửi lại bằng Idempotency-Key MỚI; liên hệ hỗ trợ kèm order_code (hoặc Idempotency-Key nếu chưa nhận được mã dự án).
429 BUSY Bạn đang có lượt tra SEO chưa xong — tối đa 2 lượt đồng thời (data.reason request_in_progress) và 3 lượt chạy nền chưa xong (background_limit). Đợi lượt trước xong (/seo/request) rồi gửi lại.
429 RATE_LIMITED Hết lượt miễn phí hôm nay (data.reason free_daily_limit — mở lại 0 giờ), hoặc đã có quá nhiều lượt được hoàn trong 24 giờ (daily_refund_limit). Chờ Retry-After giây.
429 COOLDOWN Dự án đã gia hạn hôm nay — kể cả ngày tạo (Retry-After tới 0 giờ), hoặc vừa kiểm hạng ngay (nhịp kiểm tay). Chờ Retry-After giây.
429 IN_PROGRESS Dự án đang xử lý một lệnh khác (hai lệnh cùng lúc trên một dự án). Chờ Retry-After giây rồi gửi lại.
503 UNAVAILABLE Hệ thống phân tích / nguồn dữ liệu đang bận hoặc lỗi, món (hoặc giá gia hạn dự án) đang cập nhật giá, hoặc lượt tra hết thời gian. Không có data.request_id ⇒ thường là chối trước khi nhận lượt, chưa trừ tiền (hiếm khi là lỗi hệ thống giữa chừng — xem /seo/requests trước khi tạo lệnh mới); có data.request_id ⇒ lượt đã được nhận — đọc refunded / refund_status (hệ thống hoàn tiền lượt hỏng sau khi thu). Thử lại sau ít phút; trạng thái lượt: /seo/request — chưa chắc thì gửi lại CÙNG Idempotency-Key.
GET

/seo/products

Chỉ đọc

Danh mục món SEO: mỗi mục tool · endpoint · enabled · giá theo VNĐ (giá FLAT — như nhau với mọi tài khoản, không chiết khấu đại lý). domain có tiers free · normal · premium (free: amount 0 + per_day = lượt miễn phí / ngày / tài khoản — dùng chung với /seo/speed); keyword có tiers normal · premium. local_grid: grids = giá theo cỡ lưới (background: true = chạy nền). crawl: per_page · js_multiplier (hệ số khi render JS) · min_price · max_pages. rank (theo dõi thứ hạng — thuê bao tháng): per_check · min_price · max_keywords · frequencies. amount null = món đang cập nhật giá (lệnh tra bị chối) · enabled false = món / gói tạm ngừng bán. Bảo trì cả mảng ⇒ 503 SERVICE_DISABLED.

GET https://cloudmoon.net/api/v1/seo/products

Không có tham số — chỉ cần header X-API-Key.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/products' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/products",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/products", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/products');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "enabled": true,
        "tools": [
            {
                "tool": "domain",
                "endpoint": "/seo/lookup",
                "enabled": true,
                "tiers": {
                    "free": {
                        "enabled": true,
                        "amount": 0,
                        "per_day": 30
                    },
                    "normal": {
                        "enabled": true,
                        "amount": 7000
                    },
                    "premium": {
                        "enabled": true,
                        "amount": 29000
                    }
                }
            }
        ]
    }
}
GET

/seo/pricing

Chỉ đọc

Bảng giá khuôn CŨ của web con (danh mục kiểu mới: /seo/products) — cùng một nguồn giá. free_ratelimit_per_day = lượt tra miễn phí / ngày / tài khoản.

GET https://cloudmoon.net/api/v1/seo/pricing

Không có tham số — chỉ cần header X-API-Key.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/pricing' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/pricing",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/pricing", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/pricing');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "enabled": true,
        "free_ratelimit_per_day": 30,
        "tools": {
            "domain": {
                "enabled": true,
                "endpoint": "/seo/lookup",
                "tiers": {
                    "free": 0,
                    "free_enabled": true,
                    "normal_enabled": true,
                    "premium_enabled": true
                },
                "price": {
                    "normal": {
                        "fresh": 7000,
                        "cache": 2000
                    },
                    "premium": {
                        "fresh": 29000,
                        "cache": 5000
                    }
                }
            },
            "keyword": {
                "enabled": true,
                "endpoint": "/seo/keyword",
                "price": {
                    "normal": {
                        "fresh": 7000,
                        "cache": 2000
                    },
                    "premium": {
                        "fresh": 9000,
                        "cache": 3000
                    }
                }
            },
            "audit": {
                "enabled": true,
                "endpoint": "/seo/audit",
                "price": {
                    "fresh": 2000,
                    "cache": 1000
                }
            },
            "audit_compete": {
                "enabled": true,
                "endpoint": "/seo/audit-compete",
                "price": {
                    "fresh": 10000,
                    "cache": 4000
                }
            },
            "crawl": {
                "enabled": true,
                "endpoint": "/seo/crawl",
                "per_page": 20,
                "js_multiplier": 5,
                "min_price": 5000,
                "max_pages": 10000,
                "note": "Giá = max(min_price, làm tròn lên 1.000 của số trang × per_page [× js_multiplier khi js_re…"
            },
            "local": {
                "enabled": true,
                "endpoint": "/seo/local",
                "price": {
                    "fresh": 3000,
                    "cache": 1000
                }
            },
            "local_pro": {
                "enabled": true,
                "endpoint": "/seo/local-pro/grid",
                "find_endpoint": "/seo/local-pro/find",
                "find_fee": 1000,
                "grid": {
                    "3x3": 12000,
                    "5x5": 15000,
                    "7x7": 19000,
                    "9x9": 25000,
                    "11x11": 32000
                },
                "price": {
                    "cache": 5000
                }
            },
            "backlink": {
                "enabled": true,
                "endpoint": "/seo/backlink",
                "mode": "explorer",
                "price": {
                    "fresh": 15000,
                    "cache": 5000
                }
            },
            "linkgap": {
                "enabled": true,
                "endpoint": "/seo/backlink",
                "mode": "gap",
                "price": {
                    "fresh": 12000,
                    "cache": 4000
                }
            },
            "tech": {
                "enabled": true,
                "endpoint": "/seo/tech",
                "price": {
                    "fresh": 2000
                }
            },
            "rank": {
                "enabled": true,
                "endpoint": "/seo/rank/create",
                "per_check": 300,
                "min_price": 10000,
                "max_keywords": 50,
                "frequencies": {
                    "1day": {
                        "label": "1 ngày",
                        "checks_per_month": 30
                    },
                    "3day": {
                        "label": "3 ngày",
                        "checks_per_month": 10
                    },
                    "7day": {
                        "label": "7 ngày",
                        "checks_per_month": 4
                    }
                },
                "note": "Phí tháng = max(min_price, làm tròn lên 1.000 của số từ khoá × lượt kiểm / tháng × per_che…"
            }
        },
        "note": "Giá flat (KHÔNG chiết khấu đại lý). free = 0đ (giới hạn lượt / ngày / tài khoản)."
    }
}
POST

/seo/quote

Chỉ đọc

BÁO GIÁ — không trừ tiền, không ghi gì, khoá chỉ đọc gọi được. Lệnh tra: {tool, …tham số y như lệnh thật} — tool = domain · keyword · audit · audit_compete · local · local_find · local_grid · backlink · linkgap (= /seo/backlink mode gap) · tech · crawl ⇒ amount (số sẽ trừ lúc này) · enough (ví đủ) · background (lệnh chạy nền ⇒ 202) · reused (quét cả web trùng lượt vừa mua — giao lại kết quả, 0 đồng). CÙNG bộ kiểm với lệnh thật: sai đầu vào · món tạm ngừng · chạm giới hạn ⇒ đúng lỗi lệnh ấy. Theo dõi thứ hạng: {tool: rank_create, domain, keywords, frequency?} ⇒ phí tháng · {tool: rank_renew, order_code} ⇒ giá gia hạn (đã gia hạn hôm nay ⇒ 429 COOLDOWN) · {tool: rank_add_keywords, order_code, keywords} ⇒ phí thêm từ (chỉ phần vượt số từ đã trả của kỳ) + added · restored · price · paid_keywords. Báo giá mua mới nghe bảo trì; báo giá gia hạn thì không.

POST https://cloudmoon.net/api/v1/seo/quote
Tham sốVị tríBắt buộcMô tả
tool body có món — xem mô tả
… body không tham số y như lệnh thật của món (domain · tier · keyword · url · …)
order_code body không rank_renew · rank_add_keywords

Chạy thử Lệnh đọc — gửi kèm X-Sandbox: 1 vẫn chạy như thường (không đổi gì). Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/quote' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"tool":"domain","domain":"example.com","tier":"normal"}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/quote",
    headers={"X-API-Key": "ak_..."},
    json={"tool": "domain", "domain": "example.com", "tier": "normal"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/quote", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ tool: "domain", domain: "example.com", tier: "normal" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/quote', ['tool' => 'domain', 'domain' => 'example.com', 'tier' => 'normal']);
print_r($kq);
Thân yêu cầu
{
    "tool": "domain",
    "domain": "example.com",
    "tier": "normal"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "tool": "domain",
        "tier": "normal",
        "subject": "example.com",
        "amount": 7000,
        "enough": true,
        "reused": false,
        "background": false,
        "balance": 500000
    }
}
POST

/seo/lookup

Toàn quyền

TRA DOMAIN. tier free: 0 đồng — điểm on-page + chỉ số uy tín (onpage · authority), giới hạn lượt / ngày / tài khoản dùng chung với /seo/speed (hết lượt ⇒ 429 RATE_LIMITED, reason free_daily_limit), không có request_id. tier normal / premium: phân tích traffic · từ khoá (vị trí, lên / xuống / mới / mất) · trang top · đối thủ · khoảng trống từ khoá; premium thêm hồ sơ backlink + lịch sử traffic. Kết quả được LƯU (lookup_id — xem lại: /seo/result, chủ bản xem lại miễn phí trong hạn). domain: tên miền hoặc URL — chuẩn hoá về tên miền đăng ký (https://www.abc.com.vn/x ⇒ abc.com.vn). Tên miền chưa có dữ liệu ⇒ 422 NO_DATA: lượt đã thu được hoàn; đối tượng vừa được xác định là không có dữ liệu ⇒ chối ngay, KHÔNG thu (reason no_data_recent). Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/lookup
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
domain body có tên miền / URL
tier body có free · normal · premium

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · NO_DATA (422).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/lookup' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com","tier":"normal"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/lookup",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"domain": "example.com", "tier": "normal"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/lookup", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ domain: "example.com", tier: "normal" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/lookup', ['domain' => 'example.com', 'tier' => 'normal'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "domain": "example.com",
    "tier": "normal"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "domain",
        "tier": "normal",
        "subject": "example.com",
        "amount": 7000,
        "charged": true,
        "lookup_id": 4321,
        "domain": "example.com",
        "created_at": "2026-10-23 12:55:24",
        "fresh": true,
        "result": {
            "pos": {
                "top1": 160,
                "top2_3": 986,
                "top4_10": 8347,
                "top11_20": 18488,
                "top21_50": 25645,
                "top51_100": 3500
            },
            "kind": "overview",
            "kw_up": 11262,
            "domain": "example.com",
            "gap_vs": "example.com",
            "kw_new": 27505,
            "kw_down": 15339,
            "kw_lost": 22321,
            "top_pages": [
                {
                    "url": "https://example.com/trang",
                    "traffic": 18526,
                    "keywords": 126
                }
            ],
            "rank_score": null,
            "competitors": [
                {
                    "common": 11107,
                    "domain": "example.com",
                    "traffic": 232151
                }
            ],
            "csv_enabled": true,
            "keyword_gap": [
                {
                    "my_pos": 31,
                    "volume": 13600000,
                    "keyword": "mẫu",
                    "comp_pos": 20
                }
            ],
            "paid_traffic": 0,
            "top_keywords": [
                {
                    "cpc": 0.18,
                    "url": "https://example.com/trang",
                    "volume": 450000,
                    "keyword": "mẫu",
                    "traffic": 136800,
                    "position": 2
                }
            ],
            "paid_keywords": 0,
            "traffic_value": 221293,
            "organic_traffic": 1064991,
            "organic_keywords": 57126
        }
    }
}
POST

/seo/keyword

Toàn quyền

NGHIÊN CỨU TỪ KHOÁ: lượng tìm · độ khó · ý định · CPC · xu hướng · từ liên quan / gợi ý / câu hỏi thường gặp · SERP top + đối thủ · AI Overview (has_ai_overview). tier normal (mặc định) / premium (dữ liệu sâu hơn). Lưu bản (lookup_id). Từ khoá chưa có dữ liệu ⇒ 422 NO_DATA: lượt đã thu được hoàn; đối tượng vừa được xác định là không có dữ liệu ⇒ chối ngay, KHÔNG thu (reason no_data_recent). Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/keyword
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
keyword body có từ khoá (có dấu được)
tier body không normal (mặc định) · premium

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · NO_DATA (422).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/keyword' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"mua hosting","tier":"normal"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/keyword",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"keyword": "mua hosting", "tier": "normal"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/keyword", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ keyword: "mua hosting", tier: "normal" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/keyword', ['keyword' => 'mua hosting', 'tier' => 'normal'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "keyword": "mua hosting",
    "tier": "normal"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "keyword",
        "tier": "normal",
        "subject": "mua hosting",
        "amount": 7000,
        "charged": true,
        "lookup_id": 4322,
        "kind": "keyword",
        "keyword": "mua hosting",
        "created_at": "2026-10-23 12:55:27",
        "fresh": true,
        "result": {
            "paa": [],
            "kind": "keyword",
            "serp": [
                {
                    "kw": 2600,
                    "etv": 228433,
                    "url": "https://example.com/trang",
                    "title": "mẫu",
                    "domain": "example.com",
                    "position": 2
                }
            ],
            "tier": "normal",
            "ideas": [],
            "keyword": "mẫu",
            "overview": {
                "cpc": 1.57,
                "trend": [
                    {
                        "ym": "10/2025",
                        "volume": 880
                    }
                ],
                "intent": "commercial",
                "source": "labs",
                "volume": 590,
                "keyword": "mẫu",
                "trend_yoy": -45,
                "difficulty": 34,
                "competition": 0.68,
                "competition_level": "mẫu"
            },
            "competitors": [],
            "suggestions": [
                {
                    "cpc": 1.57,
                    "volume": 590,
                    "keyword": "mẫu",
                    "difficulty": 34,
                    "competition_level": "mẫu"
                }
            ],
            "demographics": null,
            "also_rank_for": [],
            "has_ai_overview": true,
            "related_searches": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "also_rank_for_domain": ""
        }
    }
}
POST

/seo/audit

Toàn quyền

KIỂM TRA ON-PAGE một URL: điểm on-page · issues (mức độ + cách sửa) · điểm tốt (goods) · thẻ tiêu đề / mô tả / heading · ảnh · link · sitemap · robots · tốc độ (psi — PageSpeed, có thể null khi đo tốc độ tạm lỗi). Lưu bản (lookup_id). Trang không truy cập được ⇒ 422 TARGET_UNREACHABLE + hoàn tiền (hoàn xong thì tính vào giới hạn lượt hoàn / ngày). Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/audit
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
url body có URL trang (http / https)

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · TARGET_UNREACHABLE (422).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/audit' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/audit",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"url": "https://example.com/"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/audit", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ url: "https://example.com/" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/audit', ['url' => 'https://example.com/'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "url": "https://example.com/"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "audit",
        "tier": null,
        "subject": "https://example.com/",
        "amount": 2000,
        "charged": true,
        "lookup_id": 4323,
        "kind": "audit",
        "url": "https://example.com/",
        "created_at": "2026-10-23 12:55:29",
        "fresh": true,
        "result": {
            "h1": 1,
            "h2": 9,
            "h3": 10,
            "psi": {
                "si": "mẫu",
                "cls": "0",
                "fcp": "mẫu",
                "lcp": "mẫu",
                "tbt": "mẫu",
                "cls_n": 0,
                "fcp_s": 3.1,
                "lcp_s": 4.1,
                "score": 68,
                "strategy": "mobile",
                "bp_issues": [],
                "seo_score": 100,
                "accessibility": 100,
                "best_practices": 100
            },
            "url": "https://example.com/trang",
            "kind": "audit",
            "goods": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "title": "mẫu",
            "has_og": true,
            "images": 6,
            "issues": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "server": "cloudflare",
            "charset": "65001",
            "favicon": true,
            "css_size": 0,
            "is_https": true,
            "canonical": false,
            "css_count": 0,
            "dom_bytes": 78798,
            "page_size": 78798,
            "server_ms": 30,
            "ai_bots_ok": true,
            "has_schema": false,
            "word_count": 552,
            "click_depth": 0,
            "description": "mẫu",
            "diagnostics": [
                {
                    "fix": "mẫu",
                    "sev": "high",
                    "why": "mẫu",
                    "title": "mẫu"
                }
            ],
            "images_size": 0,
            "readability": 74,
            "status_code": 200,
            "broken_links": 0,
            "content_rate": 3.7,
            "onpage_score": 97.4,
            "scripts_size": 0,
            "title_length": 46,
            "cache_control": "0",
            "canonical_url": "https://example.com/trang",
            "images_no_alt": 0,
            "inbound_links": 0,
            "robots_exists": true,
            "scripts_count": 6,
            "sitemap_count": 277,
            "external_links": 3,
            "internal_links": 38,
            "sitemap_exists": true,
            "ai_bots_blocked": [],
            "content_encoding": "br",
            "desc_consistency": 90,
            "seo_friendly_url": false,
            "sitemap_is_index": false,
            "title_consistency": 100,
            "description_length": 151,
            "render_blocking_js": 0,
            "render_blocking_css": 5
        }
    }
}
POST

/seo/audit-compete

Toàn quyền

SO ĐỐI THỦ — ĐỢT 1: kiểm tra on-page trang của bạn + trang đối thủ (mode top1 = tự chọn đối thủ: trang tự nhiên đầu tiên phù hợp cho keyword — bỏ trang của bạn, tên miền cùng chuỗi với bạn và các cổng lớn · mode domain = tên miền đối thủ bạn nhập) ⇒ result.compete (verdict · bảng so sánh) chưa có tốc độ (speed_pending: true). ĐỢT 2: POST /seo/audit-compete/speed {lookup_id} — KHÔNG trừ thêm. Trang không truy cập được ⇒ 422 TARGET_UNREACHABLE + hoàn tiền. Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/audit-compete
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
url body có URL trang của bạn
mode body không top1 (mặc định) · domain
keyword body không mode top1: từ khoá mục tiêu
competitor body không mode domain: tên miền đối thủ

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · TARGET_UNREACHABLE (422).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/audit-compete' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/","mode":"domain","competitor":"example.org"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/audit-compete",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"url": "https://example.com/", "mode": "domain", "competitor": "example.org"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/audit-compete", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ url: "https://example.com/", mode: "domain", competitor: "example.org" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/audit-compete', ['url' => 'https://example.com/', 'mode' => 'domain', 'competitor' => 'example.org'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "url": "https://example.com/",
    "mode": "domain",
    "competitor": "example.org"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "audit_compete",
        "tier": null,
        "subject": "https://example.com/ vs https://example.org",
        "amount": 10000,
        "charged": true,
        "lookup_id": 4324,
        "kind": "audit",
        "url": "https://example.com/",
        "created_at": "2026-10-23 12:55:30",
        "fresh": true,
        "result": {
            "h1": 1,
            "h2": 9,
            "h3": 10,
            "psi": {
                "si": "mẫu",
                "cls": "0",
                "fcp": "mẫu",
                "lcp": "mẫu",
                "tbt": "mẫu",
                "cls_n": 0,
                "fcp_s": 3.1,
                "lcp_s": 4,
                "score": 81,
                "strategy": "mobile",
                "bp_issues": [],
                "seo_score": 100,
                "accessibility": 100,
                "best_practices": 100
            },
            "url": "https://example.com/trang",
            "kind": "audit",
            "goods": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "title": "mẫu",
            "has_og": true,
            "images": 6,
            "issues": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "server": "cloudflare",
            "charset": "65001",
            "compete": {
                "own": {
                    "h1": 1,
                    "h2": 9,
                    "h3": 10,
                    "has_og": true,
                    "images": 6,
                    "psi_lcp": "mẫu",
                    "psi_lcp_s": 4,
                    "psi_score": 81,
                    "has_schema": false,
                    "word_count": 552,
                    "readability": 74,
                    "onpage_score": 97,
                    "title_length": 46,
                    "internal_links": 38
                },
                "comp": {
                    "h1": 1,
                    "h2": 19,
                    "h3": 70,
                    "has_og": true,
                    "images": 29,
                    "psi_lcp": "mẫu",
                    "psi_lcp_s": 3.2,
                    "psi_score": 90,
                    "has_schema": false,
                    "word_count": 5747,
                    "readability": 90,
                    "onpage_score": 100,
                    "title_length": 57,
                    "internal_links": 72
                },
                "mode": "domain",
                "keyword": "",
                "own_etv": 291,
                "comp_etv": 141641,
                "comparison": {
                    "rows": [
                        {
                            "own": 552,
                            "comp": 5747,
                            "unit": "mẫu",
                            "label": "mẫu",
                            "verdict": "lose"
                        }
                    ],
                    "own_win": 0,
                    "summary": "mẫu",
                    "verdict": "behind",
                    "comp_win": 4,
                    "warnings": [],
                    "authority_ratio": 486.7,
                    "recommendations": [
                        "mẫu",
                        "mẫu",
                        "mẫu"
                    ]
                },
                "own_domain": "example.com",
                "speed_pending": false,
                "competitor_url": "https://example.com/trang",
                "competitor_domain": "example.com"
            },
            "favicon": true,
            "css_size": 0,
            "is_https": true,
            "canonical": true,
            "css_count": 0,
            "dom_bytes": 78690,
            "page_size": 78690,
            "server_ms": 18,
            "ai_bots_ok": true,
            "has_schema": false,
            "word_count": 552,
            "click_depth": 0,
            "description": "mẫu",
            "diagnostics": [
                {
                    "fix": "mẫu",
                    "sev": "medium",
                    "why": "mẫu",
                    "title": "mẫu"
                }
            ],
            "images_size": 0,
            "readability": 74,
            "status_code": 200,
            "broken_links": 0,
            "content_rate": 3.7,
            "onpage_score": 97.1,
            "scripts_size": 0,
            "title_length": 46,
            "cache_control": "0",
            "canonical_url": "https://example.com/trang",
            "images_no_alt": 1,
            "inbound_links": 0,
            "robots_exists": true,
            "scripts_count": 6,
            "sitemap_count": 277,
            "external_links": 3,
            "internal_links": 38,
            "sitemap_exists": true,
            "ai_bots_blocked": [],
            "content_encoding": "br",
            "desc_consistency": 90,
            "seo_friendly_url": true,
            "sitemap_is_index": false,
            "title_consistency": 100,
            "description_length": 151,
            "render_blocking_js": 0,
            "render_blocking_css": 5
        }
    }
}
POST

/seo/audit-compete/speed

Toàn quyền

SO ĐỐI THỦ — ĐỢT 2: đo tốc độ (Core Web Vitals) hai trang của bản so đối thủ lookup_id ⇒ bảng so sánh có tốc độ (speed_pending: false) — phía nào chưa đo được tốc độ thì thiếu chỉ số của phía ấy. KHÔNG trừ tiền (đã trả ở đợt 1) — việc đã trả không bị tạm ngừng bán chặn. Chỉ bản của chính bạn (khác ⇒ 404).

POST https://cloudmoon.net/api/v1/seo/audit-compete/speed
Tham sốVị tríBắt buộcMô tả
lookup_id body có từ /seo/audit-compete

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/audit-compete/speed' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"lookup_id":4324}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/audit-compete/speed",
    headers={"X-API-Key": "ak_..."},
    json={"lookup_id": 4324},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/audit-compete/speed", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ lookup_id: 4324 }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/audit-compete/speed', ['lookup_id' => 4324]);
print_r($kq);
Thân yêu cầu
{
    "lookup_id": 4324
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "lookup_id": 4324,
        "speed_pending": false,
        "result": {
            "h1": 1,
            "h2": 9,
            "h3": 10,
            "psi": {
                "si": "mẫu",
                "cls": "0",
                "fcp": "mẫu",
                "lcp": "mẫu",
                "tbt": "mẫu",
                "cls_n": 0,
                "fcp_s": 3.1,
                "lcp_s": 4,
                "score": 81,
                "strategy": "mobile",
                "bp_issues": [],
                "seo_score": 100,
                "accessibility": 100,
                "best_practices": 100
            },
            "url": "https://example.com/trang",
            "kind": "audit",
            "goods": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "title": "mẫu",
            "has_og": true,
            "images": 6,
            "issues": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "server": "cloudflare",
            "charset": "65001",
            "compete": {
                "own": {
                    "h1": 1,
                    "h2": 9,
                    "h3": 10,
                    "has_og": true,
                    "images": 6,
                    "psi_lcp": "mẫu",
                    "psi_lcp_s": 4,
                    "psi_score": 81,
                    "has_schema": false,
                    "word_count": 552,
                    "readability": 74,
                    "onpage_score": 97,
                    "title_length": 46,
                    "internal_links": 38
                },
                "comp": {
                    "h1": 1,
                    "h2": 19,
                    "h3": 70,
                    "has_og": true,
                    "images": 29,
                    "psi_lcp": "mẫu",
                    "psi_lcp_s": 3.2,
                    "psi_score": 90,
                    "has_schema": false,
                    "word_count": 5747,
                    "readability": 90,
                    "onpage_score": 100,
                    "title_length": 57,
                    "internal_links": 72
                },
                "mode": "domain",
                "keyword": "",
                "own_etv": 291,
                "comp_etv": 141641,
                "comparison": {
                    "rows": [
                        {
                            "own": 552,
                            "comp": 5747,
                            "unit": "mẫu",
                            "label": "mẫu",
                            "verdict": "lose"
                        }
                    ],
                    "own_win": 0,
                    "summary": "mẫu",
                    "verdict": "behind",
                    "comp_win": 4,
                    "warnings": [],
                    "authority_ratio": 486.7,
                    "recommendations": [
                        "mẫu",
                        "mẫu",
                        "mẫu"
                    ]
                },
                "own_domain": "example.com",
                "speed_pending": false,
                "competitor_url": "https://example.com/trang",
                "competitor_domain": "example.com"
            },
            "favicon": true,
            "css_size": 0,
            "is_https": true,
            "canonical": true,
            "css_count": 0,
            "dom_bytes": 78690,
            "page_size": 78690,
            "server_ms": 18,
            "ai_bots_ok": true,
            "has_schema": false,
            "word_count": 552,
            "click_depth": 0,
            "description": "mẫu",
            "diagnostics": [
                {
                    "fix": "mẫu",
                    "sev": "medium",
                    "why": "mẫu",
                    "title": "mẫu"
                }
            ],
            "images_size": 0,
            "readability": 74,
            "status_code": 200,
            "broken_links": 0,
            "content_rate": 3.7,
            "onpage_score": 97.1,
            "scripts_size": 0,
            "title_length": 46,
            "cache_control": "0",
            "canonical_url": "https://example.com/trang",
            "images_no_alt": 1,
            "inbound_links": 0,
            "robots_exists": true,
            "scripts_count": 6,
            "sitemap_count": 277,
            "external_links": 3,
            "internal_links": 38,
            "sitemap_exists": true,
            "ai_bots_blocked": [],
            "content_encoding": "br",
            "desc_consistency": 90,
            "seo_friendly_url": true,
            "sitemap_is_index": false,
            "title_consistency": 100,
            "description_length": 151,
            "render_blocking_js": 0,
            "render_blocking_css": 5
        }
    }
}
POST

/seo/speed

Toàn quyền

TỐC ĐỘ TRANG (Google PageSpeed, MIỄN PHÍ): điểm + LCP · CLS · FCP · TBT · Speed Index (bản mobile). Dùng CHUNG hạn mức lượt miễn phí / ngày / tài khoản với /seo/lookup tier free (hết ⇒ 429 RATE_LIMITED). Đo tốc độ lỗi ⇒ 503, lượt ấy không tính vào hạn mức.

POST https://cloudmoon.net/api/v1/seo/speed
Tham sốVị tríBắt buộcMô tả
domain body có tên miền / URL

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): RATE_LIMITED (429) · BUSY (429) · SERVICE_DISABLED (503) · PRODUCT_DISABLED (404) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/speed' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com"}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/speed",
    headers={"X-API-Key": "ak_..."},
    json={"domain": "example.com"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/speed", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ domain: "example.com" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/speed', ['domain' => 'example.com']);
print_r($kq);
Thân yêu cầu
{
    "domain": "example.com"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "domain": "example.com",
        "score": 88,
        "strategy": "mobile",
        "lcp": "2,1 giây",
        "cls": "0,02",
        "fcp": "1,3 giây",
        "tbt": "120 mili giây",
        "si": "2,4 giây"
    }
}
POST

/seo/local

Toàn quyền

LOCAL SEO / Google Maps: top doanh nghiệp cho một từ khoá dịch vụ tại MỘT điểm (lãnh thổ Việt Nam) — hạng · đánh giá · số review · đã xác minh · thống kê khu vực. Lưu bản. Không có kết quả ⇒ 422 NO_DATA + hoàn tiền. Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/local
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
keyword body có từ khoá dịch vụ (≥ 2 ký tự, vd nha khoa)
lat body có vĩ độ (8–24)
lng body có kinh độ (102–110)
city_label body không nhãn khu vực (≤ 80 ký tự)

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · NO_DATA (422).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/local' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"nha khoa","lat":10.7769,"lng":106.7009,"city_label":"Quận 1, TP.HCM"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/local",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"keyword": "nha khoa", "lat": 10.7769, "lng": 106.7009, "city_label": "Quận 1, TP.HCM"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/local", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ keyword: "nha khoa", lat: 10.7769, lng: 106.7009, city_label: "Quận 1, TP.HCM" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/local', ['keyword' => 'nha khoa', 'lat' => 10.7769, 'lng' => 106.7009, 'city_label' => 'Quận 1, TP.HCM'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "keyword": "nha khoa",
    "lat": 10.7769,
    "lng": 106.7009,
    "city_label": "Quận 1, TP.HCM"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "local",
        "tier": null,
        "subject": "nha khoa @ Quận 1, TP.HCM",
        "amount": 3000,
        "charged": true,
        "lookup_id": 4325,
        "kind": "local",
        "query": "nha khoa @ Quận 1, TP.HCM",
        "result": {
            "city": "vn",
            "kind": "local",
            "stats": {
                "ads": 0,
                "total": 30,
                "claimed": 30,
                "has_web": 27,
                "avg_rating": 4.8
            },
            "center": {
                "lat": 10.78,
                "lng": 106.7
            },
            "keyword": "mẫu",
            "results": [
                {
                    "lat": 10.76,
                    "lng": 106.66,
                    "url": "https://example.com/trang",
                    "desc": true,
                    "rank": 1,
                    "hours": true,
                    "phone": "+84000000000",
                    "title": "mẫu",
                    "domain": "example.com",
                    "photos": 372,
                    "rating": 4.8,
                    "address": "mẫu",
                    "claimed": true,
                    "reviews": 1179,
                    "category": "mẫu",
                    "place_id": "mẫu",
                    "extra_cats": 3
                }
            ],
            "city_label": "mẫu"
        }
    }
}
POST

/seo/local-pro/find

Toàn quyền

LOCAL PRO — BƯỚC 1: dò doanh nghiệp trên Google Maps quanh một điểm (theo name hoặc keyword) ⇒ candidates (tên · đánh giá · địa chỉ · place_id). Thu phí dò (fee) kể cả khi 0 kết quả; chỉ hoàn khi hệ thống lỗi. Chọn đúng chi nhánh rồi gọi /seo/local-pro/grid kèm place_id. Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/local-pro/find
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
name body không tên doanh nghiệp (ưu tiên) — cần name hoặc keyword
keyword body không từ khoá dịch vụ
lat body có vĩ độ (8–24)
lng body có kinh độ (102–110)

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/local-pro/find' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Nha Khoa ABC","keyword":"nha khoa","lat":10.7769,"lng":106.7009}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/local-pro/find",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"name": "Nha Khoa ABC", "keyword": "nha khoa", "lat": 10.7769, "lng": 106.7009},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/local-pro/find", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ name: "Nha Khoa ABC", keyword: "nha khoa", lat: 10.7769, lng: 106.7009 }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/local-pro/find', ['name' => 'Nha Khoa ABC', 'keyword' => 'nha khoa', 'lat' => 10.7769, 'lng' => 106.7009], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "name": "Nha Khoa ABC",
    "keyword": "nha khoa",
    "lat": 10.7769,
    "lng": 106.7009
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "local_find",
        "tier": null,
        "subject": "Nha Khoa ABC",
        "amount": 1000,
        "charged": true,
        "lookup_id": null,
        "candidates": [
            {
                "title": "mẫu",
                "rating": 4.8,
                "reviews": 120,
                "address": "mẫu",
                "category": "mẫu",
                "place_id": "mẫu"
            }
        ],
        "fee": 1000
    }
}
POST

/seo/local-pro/grid

Toàn quyền

LOCAL PRO — BƯỚC 2: BẢN ĐỒ NHIỆT thứ hạng của doanh nghiệp tại N×N điểm quanh tâm (bán kính radius km). Giá theo cỡ lưới (/seo/products → grids). Lưới 3×3 · 5×5 trả kết quả ngay (HTTP 200, result.cells). Lưới 7×7 trở lên chạy NỀN: HTTP 202 state running + request_id ⇒ hỏi GET /seo/local-pro/grid/status (lượt nền không giao được ⇒ state failed — trạng thái tiền của lượt: GET /seo/request). place_id (từ bước 1) giúp khớp đúng chi nhánh. Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/local-pro/grid
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
keyword body có từ khoá dịch vụ
biz body có tên doanh nghiệp của bạn
place_id body không từ /seo/local-pro/find
lat body có vĩ độ tâm
lng body có kinh độ tâm
grid_n body không 3 · 5 (mặc định) · 7 · 9 · 11
radius body không 2 · 5 (mặc định) · 10 · 15 · 20 (km)
city_label body không nhãn khu vực

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · FAILED (lệnh vẫn nhận, info về sau báo failed).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/local-pro/grid' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"nha khoa","biz":"Nha Khoa ABC","place_id":"ChIJ0T2NLikpdTERKxE8d61aX_E","lat":10.7769,"lng":106.7009,"grid_n":5,"radius":5}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/local-pro/grid",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"keyword": "nha khoa", "biz": "Nha Khoa ABC", "place_id": "ChIJ0T2NLikpdTERKxE8d61aX_E", "lat": 10.7769, "lng": 106.7009, "grid_n": 5, "radius": 5},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/local-pro/grid", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ keyword: "nha khoa", biz: "Nha Khoa ABC", place_id: "ChIJ0T2NLikpdTERKxE8d61aX_E", lat: 10.7769, lng: 106.7009, grid_n: 5, radius: 5 }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/local-pro/grid', ['keyword' => 'nha khoa', 'biz' => 'Nha Khoa ABC', 'place_id' => 'ChIJ0T2NLikpdTERKxE8d61aX_E', 'lat' => 10.7769, 'lng' => 106.7009, 'grid_n' => 5, 'radius' => 5], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "keyword": "nha khoa",
    "biz": "Nha Khoa ABC",
    "place_id": "ChIJ0T2NLikpdTERKxE8d61aX_E",
    "lat": 10.7769,
    "lng": 106.7009,
    "grid_n": 5,
    "radius": 5
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "local_grid",
        "tier": null,
        "subject": "Nha Khoa ABC · nha khoa (heatmap 5x5)",
        "amount": 15000,
        "charged": true,
        "lookup_id": 4326,
        "kind": "local",
        "mode": "grid",
        "query": "Nha Khoa ABC · nha khoa (heatmap 5x5)",
        "result": {
            "biz": "mẫu",
            "kind": "local",
            "mode": "grid",
            "cells": [
                {
                    "col": 0,
                    "lat": 10.79,
                    "lng": 106.68,
                    "row": 0,
                    "rank": 0,
                    "top1": "mẫu"
                }
            ],
            "stats": {
                "top3": 1,
                "found": 2,
                "top10": 1,
                "total": 49,
                "avg_rank": 7,
                "pct_top3": 2,
                "pct_found": 4,
                "pct_top10": 2
            },
            "center": {
                "lat": 10.78,
                "lng": 106.7
            },
            "grid_n": 7,
            "keyword": "mẫu",
            "place_id": "",
            "radius_km": 2,
            "city_label": "",
            "local_stats": {
                "ads": 0,
                "total": 20,
                "claimed": 16,
                "has_web": 14,
                "avg_rating": 4.5
            },
            "local_results": [
                {
                    "lat": 10.78,
                    "lng": 106.7,
                    "url": "https://example.com/trang",
                    "desc": true,
                    "rank": 1,
                    "hours": true,
                    "phone": "+84000000000",
                    "title": "mẫu",
                    "domain": "example.com",
                    "photos": 2,
                    "rating": 0,
                    "address": "mẫu",
                    "claimed": true,
                    "reviews": 0,
                    "category": "mẫu",
                    "place_id": "mẫu",
                    "extra_cats": 0
                }
            ]
        }
    }
}
GET

/seo/local-pro/grid/status

Chỉ đọc

Tiến độ lượt bản đồ nhiệt CHẠY NỀN (7×7 trở lên): state running (msg tiến độ) · done (bản đồ đầy đủ như lưới đồng bộ, lookup_id) · failed (không trả được bản đồ — msg nói rõ; trạng thái tiền của lượt: GET /seo/request). Chỉ đọc — hỏi mỗi 5–10 giây. request_id của người khác / không có ⇒ 404.

GET https://cloudmoon.net/api/v1/seo/local-pro/grid/status
Tham sốVị tríBắt buộcMô tả
request_id query có từ /seo/local-pro/grid (HTTP 202)
Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/local-pro/grid/status?request_id=SL261023105235a1b2c3d4' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/local-pro/grid/status",
    headers={"X-API-Key": "ak_..."},
    params={"request_id": "SL261023105235a1b2c3d4"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/local-pro/grid/status?request_id=SL261023105235a1b2c3d4", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/local-pro/grid/status?request_id=SL261023105235a1b2c3d4');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "local_grid",
        "job_id": 184510,
        "state": "done",
        "kind": "local",
        "mode": "grid",
        "query": "mẫu",
        "lookup_id": 4327,
        "result": {
            "biz": "mẫu",
            "kind": "local",
            "mode": "grid",
            "cells": [
                {
                    "col": 0,
                    "lat": 10.79,
                    "lng": 106.68,
                    "row": 0,
                    "rank": 0,
                    "top1": "mẫu"
                }
            ],
            "stats": {
                "top3": 1,
                "found": 2,
                "top10": 1,
                "total": 49,
                "avg_rank": 7,
                "pct_top3": 2,
                "pct_found": 4,
                "pct_top10": 2
            },
            "center": {
                "lat": 10.78,
                "lng": 106.7
            },
            "grid_n": 7,
            "keyword": "mẫu",
            "place_id": "",
            "radius_km": 2,
            "city_label": "",
            "local_stats": {
                "ads": 0,
                "total": 20,
                "claimed": 16,
                "has_web": 14,
                "avg_rating": 4.5
            },
            "local_results": [
                {
                    "lat": 10.78,
                    "lng": 106.7,
                    "url": "https://example.com/trang",
                    "desc": true,
                    "rank": 1,
                    "hours": true,
                    "phone": "+84000000000",
                    "title": "mẫu",
                    "domain": "example.com",
                    "photos": 2,
                    "rating": 0,
                    "address": "mẫu",
                    "claimed": true,
                    "reviews": 0,
                    "category": "mẫu",
                    "place_id": "mẫu",
                    "extra_cats": 0
                }
            ],
            "lookup_id": 4327,
            "fresh": true
        }
    }
}
POST

/seo/backlink

Toàn quyền

BACKLINK. mode explorer (mặc định): hồ sơ backlink của tên miền — điểm uy tín · số backlink / tên miền trỏ về · dofollow / nofollow · anchor · trang được trỏ nhiều · backlink top · link gãy · điểm spam · lịch sử. mode gap (LINK GAP — giá + công tắc riêng, tool linkgap): tên miền đang link tới 1–3 đối thủ mà CHƯA link tới bạn. Lưu bản. Explorer chưa có dữ liệu ⇒ 422 NO_DATA (lượt đã thu ⇒ hoàn; tên miền vừa xác định không có dữ liệu ⇒ chối ngay, không thu). Link Gap không có cơ hội nào vẫn là kết quả hợp lệ (tính phí, lưu bản). Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/backlink
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
domain body có tên miền của bạn
mode body không explorer (mặc định) · gap
competitors body không mode gap: 1–3 tên miền đối thủ (danh sách)

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · NO_DATA (422).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/backlink' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com","mode":"gap","competitors":["example.org","example.net"]}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/backlink",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"domain": "example.com", "mode": "gap", "competitors": ["example.org", "example.net"]},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/backlink", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ domain: "example.com", mode: "gap", competitors: ["example.org", "example.net"] }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/backlink', ['domain' => 'example.com', 'mode' => 'gap', 'competitors' => ['example.org', 'example.net']], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "domain": "example.com",
    "mode": "gap",
    "competitors": [
        "example.org",
        "example.net"
    ]
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "linkgap",
        "tier": "premium",
        "subject": "example.com vs example.org, example.net",
        "amount": 12000,
        "charged": true,
        "lookup_id": 4328,
        "kind": "backlink",
        "query": "example.com vs example.org, example.net",
        "result": {
            "me": "example.com",
            "gaps": [
                {
                    "rank": 263,
                    "spam": 0,
                    "count": 1,
                    "links": 2030,
                    "which": [
                        1
                    ],
                    "domain": "example.com"
                }
            ],
            "kind": "backlink",
            "mode": "gap",
            "me_dr": 468,
            "total": 4518,
            "fetched_at": "2026-10-23",
            "competitors": [
                {
                    "dr": 342,
                    "domain": "example.com"
                }
            ]
        }
    }
}
POST

/seo/tech

Toàn quyền

SOI CÔNG NGHỆ WEBSITE: nền tảng (CMS / thương mại điện tử / tự viết) · mức tự sửa được · CDN / bảo mật · công cụ đo lường (summary diễn giải dễ hiểu + groups theo nhóm). Không lưu bản. Không nhận diện được ⇒ 422 NO_DATA + hoàn tiền. Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/tech
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
domain body có tên miền

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · NO_DATA (422).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/tech' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/tech",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"domain": "example.com"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/tech", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ domain: "example.com" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/tech', ['domain' => 'example.com'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "domain": "example.com"
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "tech",
        "tier": null,
        "subject": "example.com",
        "amount": 2000,
        "charged": true,
        "lookup_id": null,
        "domain": "example.com",
        "summary": {
            "platform": "mẫu",
            "platform_kind": "ecom",
            "frameworks": [],
            "blind": false,
            "edit_level": "easy",
            "edit_text": "mẫu",
            "cloudflare": true,
            "ga": true,
            "pixel": false,
            "cross": "platform"
        },
        "groups": {
            "cms": [
                "mẫu"
            ],
            "analytics": [
                "mẫu"
            ],
            "cdn": [
                "mẫu"
            ],
            "ecommerce": [
                "mẫu"
            ]
        },
        "price": 2000
    }
}
POST

/seo/crawl

Toàn quyền

QUÉT CẢ WEBSITE (bất đồng bộ): HTTP 202 state crawling + request_id ⇒ hỏi GET /seo/crawl/status tới done (báo cáo: điểm · nhóm lỗi theo mức + trang dính · top 3 việc nên làm trước) · blocked (website chặn trình quét) · failed — không giao được báo cáo, hệ thống hoàn tiền (blocked kèm da_hoan; trạng thái tiền chắc chắn: GET /seo/request). Giá = max(min_price, làm tròn lên 1.000 của số trang × per_page [× js_multiplier khi js_render]) — /seo/products. Cùng tên miền đang quét, hoặc vừa quét xong có báo cáo chưa quá 30 phút ⇒ trả lại ĐÚNG lượt ấy (reused: true, 0 đồng — max_pages của lượt cũ); muốn quét lại với số trang khác thì đợi qua 30 phút. Trừ ví giá FLAT NGAY (lệnh đồng bộ lấy dữ liệu ngay trong lượt gọi — đặt timeout phía bạn ≥ 100 giây; lệnh chạy nền trả HTTP 202 + request_id, theo dõi tiến độ); lượt không chốt được kết quả sau khi đã trừ ⇒ lỗi thường kèm data {request_id, charged, refunded, refund_status} — hệ thống hoàn tiền (refunded: true = đã về ví · refund_status refund_pending / checking = đang xử lý, theo dõi GET /seo/request); ngoại lệ hiếm: lõi đã nhận lượt (đã chốt kết quả, hoặc lượt nền đã giao cho bộ chạy nền) mà lỗi lúc dựng phản hồi ⇒ 503 chỉ kèm request_id, không hoàn vì lỗi ấy — theo dõi GET /seo/request hoặc gửi lại cùng Idempotency-Key (lượt còn chạy ⇒ 409 IDEMPOTENCY_PENDING). Phong bì chung của lệnh tra có thu tiền: request_id · tool · tier · subject · amount · charged · lookup_id.

POST https://cloudmoon.net/api/v1/seo/crawl
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá ⇒ phát lại phản hồi đã lưu, không trừ lần hai (lượt đang chạy ⇒ 409 IDEMPOTENCY_PENDING; phản hồi lần đầu chưa kịp lưu ⇒ dựng lại từ dữ liệu còn giữ, có thể result_unavailable: true). Bản phát lại giữ trạng thái hoàn lúc lưu — trạng thái mới nhất: GET /seo/request
url body có URL gốc website
pages body không số trang tối đa (1 – max_pages, mặc định 50)
js_render body không true = website dựng bằng JavaScript (SPA) — giá × js_multiplier

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · BUSY (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400) · BLOCKED (lệnh vẫn nhận, info về sau báo failed) · FAILED (lệnh vẫn nhận, info về sau báo failed).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/crawl' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","pages":50}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/crawl",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"url": "https://example.com", "pages": 50},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/crawl", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ url: "https://example.com", pages: 50 }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/crawl', ['url' => 'https://example.com', 'pages' => 50], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "url": "https://example.com",
    "pages": 50
}
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "crawl",
        "tier": null,
        "subject": "example.com (50 trang)",
        "amount": 5000,
        "charged": true,
        "lookup_id": null,
        "job_id": 184511,
        "state": "crawling",
        "domain": "example.com",
        "max_pages": 50
    }
}
GET

/seo/crawl/status

Chỉ đọc

Tiến độ lượt quét cả web: state crawling (pages_crawled · in_queue · max_pages) · done (result = báo cáo đầy đủ) · blocked (status_code của website, da_hoan khi có) · failed (msg — trạng thái tiền: GET /seo/request). Chỉ đọc — hỏi mỗi 5–10 giây. Đường web con cũ nhận ?job_id=.

GET https://cloudmoon.net/api/v1/seo/crawl/status
Tham sốVị tríBắt buộcMô tả
request_id query có từ /seo/crawl (HTTP 202)
Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/crawl/status?request_id=SL261023105235a1b2c3d4' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/crawl/status",
    headers={"X-API-Key": "ak_..."},
    params={"request_id": "SL261023105235a1b2c3d4"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/crawl/status?request_id=SL261023105235a1b2c3d4", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/crawl/status?request_id=SL261023105235a1b2c3d4');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "crawl",
        "job_id": 184511,
        "state": "done",
        "domain": "example.com",
        "result": {
            "top3": [
                {
                    "fix": "mẫu",
                    "sev": "medium",
                    "ease": 3,
                    "count": 1,
                    "title": "mẫu"
                }
            ],
            "goods": [
                "mẫu",
                "mẫu",
                "mẫu"
            ],
            "score": 44,
            "state": "done",
            "counts": {
                "low": 1,
                "high": 0,
                "medium": 2
            },
            "domain": "example.com",
            "groups": {
                "low": [
                    {
                        "fix": "mẫu",
                        "sev": "low",
                        "ease": 3,
                        "count": 1,
                        "pages": [
                            "https://example.com/trang"
                        ],
                        "title": "mẫu",
                        "priority": 6.6,
                        "pages_total": 1
                    }
                ],
                "high": [],
                "medium": [
                    {
                        "fix": "mẫu",
                        "sev": "medium",
                        "ease": 3,
                        "count": 1,
                        "pages": [
                            "https://example.com/trang"
                        ],
                        "title": "mẫu",
                        "priority": 8.6,
                        "pages_total": 1
                    }
                ]
            },
            "hit_limit": false,
            "max_pages": 10,
            "pages_doc": 1,
            "bao_cao_du": true,
            "thieu_link": false,
            "thieu_trang": false,
            "target_score": 92,
            "total_issues": 3,
            "pages_crawled": 1
        }
    }
}
GET

/seo/crawl/history

Chỉ đọc

Các lượt quét cả web của bạn (mới nhất trước): request_id · job_id · domain · max_pages · status (crawling · done · failed) · pages_crawled · created_at · finished_at. Báo cáo đầy đủ: /seo/crawl/status?request_id=.

GET https://cloudmoon.net/api/v1/seo/crawl/history
Tham sốVị tríBắt buộcMô tả
limit query không 1–100, mặc định 20
Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/crawl/history' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/crawl/history",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/crawl/history", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/crawl/history');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "crawls": [
            {
                "request_id": "SL261023105235a1b2c3d4",
                "job_id": 184511,
                "domain": "example.com",
                "max_pages": 50,
                "status": "done",
                "pages_crawled": 48,
                "created_at": "2026-10-23T10:52:40+07:00",
                "finished_at": "2026-10-23T10:54:02+07:00"
            }
        ],
        "total": 1
    }
}
GET

/seo/request

Chỉ đọc

MỘT lượt tra của bạn theo request_id (lệnh tra có thu tiền trả mã này — cả khi lỗi sau lúc đã trừ, trừ vài lỗi hệ thống hiếm; tra domain free và /seo/speed không có): status processing (đang chạy / chạy nền) · done · refunded · refund_pending (lần hoàn trước chưa xong — hệ thống tự thử lại) · checking (đang đối soát) + amount + refund_reason (lượt refunded / refund_pending: no_data · target_unreachable — đầu vào của bạn, lượt đã hoàn xong (refunded) mới tính vào giới hạn lượt hoàn / ngày · service_error — lỗi phía hệ thống, không tính) + lookup_id (xem lại: /seo/result) / job_id. Lượt người khác / không có ⇒ 404.

GET https://cloudmoon.net/api/v1/seo/request
Tham sốVị tríBắt buộcMô tả
request_id query có —
Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/request?request_id=SL261023105235a1b2c3d4' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/request",
    headers={"X-API-Key": "ak_..."},
    params={"request_id": "SL261023105235a1b2c3d4"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/request?request_id=SL261023105235a1b2c3d4", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/request?request_id=SL261023105235a1b2c3d4');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "request_id": "SL261023105235a1b2c3d4",
        "tool": "domain",
        "tier": "normal",
        "subject": "example.com",
        "amount": 7000,
        "status": "done",
        "refund_reason": null,
        "lookup_id": 4321,
        "job_id": null,
        "channel": "api",
        "created_at": "2026-10-23T12:55:24+07:00",
        "updated_at": "2026-10-23T12:55:47+07:00"
    }
}
GET

/seo/requests

Chỉ đọc

Các lượt tra của bạn, MỚI nhất trước — mỗi mục như /seo/request. channel = web · api (lượt trên trang web cũng hiện).

GET https://cloudmoon.net/api/v1/seo/requests
Tham sốVị tríBắt buộcMô tả
tool query không domain · keyword · audit · audit_compete · local · local_find · local_grid · backlink · linkgap · tech · crawl
status query không processing · done · refunded · refund_pending · checking
limit query không 1–100, mặc định 20
offset query không —
Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/requests' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/requests",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/requests", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/requests');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "requests": [
            {
                "request_id": "SL261023105235a1b2c3d4",
                "tool": "domain",
                "tier": "normal",
                "subject": "example.com",
                "amount": 7000,
                "status": "done",
                "refund_reason": null,
                "lookup_id": 4321,
                "job_id": null,
                "channel": "api",
                "created_at": "2026-10-23T12:55:24+07:00",
                "updated_at": "2026-10-23T12:55:47+07:00"
            }
        ],
        "total": 1,
        "limit": 20,
        "offset": 0
    }
}
GET

/seo/result

Chỉ đọc

XEM LẠI một bản lưu (lookup_id): chủ bản trong hạn xem lại miễn phí ⇒ 0 đồng (free: true, khoá chỉ đọc gọi được) · còn lại tính giá xem lại của món (giá > 0 ⇒ khoá TOÀN QUYỀN — nên kèm Idempotency-Key để gửi lại không bị trừ lần nữa; khoá chỉ đọc ⇒ 403; giá xem lại 0 ⇒ khoá chỉ đọc xem được, free: false). kind = domain · keyword · audit · local · backlink. Bản nội dung riêng tư chỉ chủ xem được. Xem bản có phí nghe công tắc bán của món; chủ xem lại miễn phí thì không.

GET https://cloudmoon.net/api/v1/seo/result
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header không BẮT BUỘC khi lượt xem CÓ PHÍ (thiếu ⇒ 400 IDEMPOTENCY_KEY_REQUIRED; chủ xem lại trong hạn miễn phí thì khỏi gửi): cùng khoá + cùng lệnh ⇒ phát lại phản hồi đã lưu, không trừ lần hai; lệnh đang chạy hoặc bị ngắt trước khi lưu phản hồi ⇒ 409 IDEMPOTENCY_PENDING (không dựng lại, không tra được bằng /seo/request) — 409 kéo dài thì liên hệ hỗ trợ kèm Idempotency-Key
id query có lookup_id

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · FORBIDDEN (403) · NOT_FOUND (404) · PRODUCT_DISABLED (404) · IDEMPOTENCY_PENDING (409) · SERVICE_DISABLED (503) · UNAVAILABLE (503).

Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/result?id=4322' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab'
Yêu cầu
import uuid
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/result",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    params={"id": "4322"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/result?id=4322", {
  headers: { "X-API-Key": "ak_...", "Idempotency-Key": randomUUID() },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/result?id=4322', [], bin2hex(random_bytes(16)));
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "kind": "domain",
        "tier": "normal",
        "domain": "example.com",
        "lookup_id": 4322,
        "created_at": "2026-10-23 10:52:35",
        "fresh": false,
        "free": true,
        "result": {
            "pos": {
                "top1": 160,
                "top2_3": 986,
                "top4_10": 8347,
                "top11_20": 18488,
                "top21_50": 25645,
                "top51_100": 3500
            },
            "kind": "overview",
            "kw_up": 11262,
            "domain": "example.com",
            "gap_vs": "example.com",
            "kw_new": 27505,
            "kw_down": 15339,
            "kw_lost": 22321,
            "top_pages": [
                {
                    "url": "https://example.com/trang",
                    "traffic": 18526,
                    "keywords": 126
                }
            ],
            "rank_score": null,
            "competitors": [
                {
                    "common": 11107,
                    "domain": "example.com",
                    "traffic": 232151
                }
            ],
            "csv_enabled": true,
            "keyword_gap": [
                {
                    "my_pos": 31,
                    "volume": 13600000,
                    "keyword": "mẫu",
                    "comp_pos": 20
                }
            ],
            "paid_traffic": 0,
            "top_keywords": [
                {
                    "cpc": 0.18,
                    "url": "https://example.com/trang",
                    "volume": 450000,
                    "keyword": "mẫu",
                    "traffic": 136800,
                    "position": 2
                }
            ],
            "paid_keywords": 0,
            "traffic_value": 221293,
            "organic_traffic": 1064991,
            "organic_keywords": 57126
        },
        "amount": 0,
        "charged": false
    }
}
GET

/seo/versions

Chỉ đọc

Các BẢN LƯU gần nhất của một chủ đề (siêu dữ liệu — nội dung: /seo/result?id=lookup_id): kind domain (mặc định) · keyword · audit (kiểm tra on-page thường) · local (Local SEO thường) · backlink (gồm link gap). Bản so đối thủ và bản đồ nhiệt không có trong danh sách này — xem bằng /seo/result khi có lookup_id. is_free = 1 khi chính bạn tạo và còn trong hạn xem lại miễn phí.

GET https://cloudmoon.net/api/v1/seo/versions
Tham sốVị tríBắt buộcMô tả
kind query không domain (mặc định) · keyword · audit · local · backlink
domain query không kind domain
keyword query không kind keyword · local
url query không kind audit
subject query không kind backlink (hoặc thay cho trường chủ đề bất kỳ)
tier query không domain · keyword · backlink: normal (mặc định) · premium
city query không kind local: mã khu vực (mặc định vn)
city_label query không kind local: nhãn khu vực ĐÃ gửi lúc tra (/seo/local city_label) — chủ đề bản lưu là "từ khoá @ nhãn"
Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/versions?domain=example.com' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/versions",
    headers={"X-API-Key": "ak_..."},
    params={"domain": "example.com"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/versions?domain=example.com", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/versions?domain=example.com');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "kind": "domain",
        "domain": "example.com",
        "subject": "example.com",
        "tier": "normal",
        "versions": [
            {
                "lookup_id": 4321,
                "id": 4321,
                "rank_score": null,
                "organic_traffic": 6234667,
                "backlinks": null,
                "created_at": "2026-10-23 10:52:35",
                "is_free": 1
            }
        ],
        "total": 1
    }
}
POST

/seo/rank/create

Toàn quyền

TẠO dự án theo dõi thứ hạng từ khoá (THUÊ BAO THÁNG) — trừ phí tháng NGAY: max(min_price, làm tròn lên 1.000 của số từ × lượt kiểm / tháng × per_check) (báo giá: /seo/quote tool rank_create). frequency: 1day (hằng ngày) · 3day · 7day (mặc định). Thử đo ngay tối đa 10 từ đầu (checked_now = số từ trong nhóm đo ngay · checked = số đã cập nhật được), phần còn lại được đo dần ở các lượt kiểm tự động mỗi giờ. Tối đa max_keywords từ / dự án. Tự gia hạn BẬT sẵn (tắt: /seo/rank/auto-renew). Dự án theo dõi = đơn có order_code (khuôn chung: price_renew · paid_keywords · allowed_actions — renew · auto_renew · alerts · note · add_keywords · remove_keyword · check · delete).

POST https://cloudmoon.net/api/v1/seo/rank/create
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá + cùng thân ⇒ phát lại phản hồi đã lưu, không trừ lần hai; lệnh đang chạy hoặc chưa lưu được phản hồi ⇒ 409 IDEMPOTENCY_PENDING (không dựng lại) — xem dự án bằng /seo/rank/info · /seo/rank/list, đừng đổi khoá để thử lại
domain body có tên miền theo dõi
keywords body có danh sách chuỗi, hoặc chuỗi mỗi dòng một từ
frequency body không 1day · 3day · 7day (mặc định)
location_code body không 2704 = Việt Nam (mặc định)
name body không tên dự án (≤ 120 ký tự)

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · FORBIDDEN (403) · PRODUCT_DISABLED (404) · IDEMPOTENCY_PENDING (409) · SERVICE_DISABLED (503) · UNAVAILABLE (503) · BAD_REQUEST (400).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/create' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com","keywords":["thuê vps","mua hosting"],"frequency":"7day"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/create",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"domain": "example.com", "keywords": ["thuê vps", "mua hosting"], "frequency": "7day"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/create", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ domain: "example.com", keywords: ["thuê vps", "mua hosting"], frequency: "7day" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/create', ['domain' => 'example.com', 'keywords' => ['thuê vps', 'mua hosting'], 'frequency' => '7day'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "domain": "example.com",
    "keywords": [
        "thuê vps",
        "mua hosting"
    ],
    "frequency": "7day"
}
Phản hồi
{
    "status": "success",
    "msg": "Đã tạo dự án theo dõi",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "active",
        "renew_auto": "on",
        "auto_renew": true,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ],
        "price": 10000,
        "checked": 2,
        "checked_now": 2
    }
}
GET

/seo/rank/list

Chỉ đọc

Các dự án theo dõi của bạn (mới nhất trước; không gồm dự án đã xoá) — mỗi mục như /seo/rank/info (không kèm từ khoá) + stats (top3 · top10 · ranked).

GET https://cloudmoon.net/api/v1/seo/rank/list
Tham sốVị tríBắt buộcMô tả
status query không active · suspended
Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/rank/list' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/rank/list",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/list", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/rank/list');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "projects": [
            {
                "id": 57,
                "project_id": 57,
                "order_code": "231026RANKA1B2C3D4E5F6",
                "domain": "example.com",
                "name": "example.com",
                "note": "",
                "user_note": "",
                "location_code": 2704,
                "location_label": "Việt Nam",
                "frequency": "7day",
                "checks_per_month": 4,
                "keyword_count": 2,
                "paid_keywords": 2,
                "status": "active",
                "renew_auto": "on",
                "auto_renew": true,
                "alert_email": "on",
                "alerts": true,
                "price_buy": 10000,
                "price_renew": 10000,
                "time_buy": "2026-10-23 10:52:58",
                "time_renewal": "2026-10-23 10:52:58",
                "time_expire": "2026-11-22 10:52:58",
                "allowed_actions": [
                    "renew"
                ],
                "stats": {
                    "top3": 1,
                    "top10": 2,
                    "ranked": 2
                }
            }
        ],
        "total": 1
    }
}
GET

/seo/rank/info

Chỉ đọc

MỘT dự án: thông tin + price_renew (giá lần gia hạn kế — cùng hàm với lệnh gia hạn) + paid_keywords (số từ đã trả của kỳ — thêm / đổi / khôi phục trong phạm vi này 0 đồng) + allowed_actions + keywords (keyword_id · hạng hiện tại / trước / tốt nhất (0 = ngoài top) · URL đứng hạng · lượt tìm · AI Overview · đối thủ). status: active · suspended (quá hạn, tự gia hạn tắt / thiếu tiền — ngừng đo; gia hạn là chạy lại) · expired (đã xoá — kết thúc).

GET https://cloudmoon.net/api/v1/seo/rank/info
Tham sốVị tríBắt buộcMô tả
order_code query có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list

Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/rank/info?order_code=231026RANKA1B2C3D4E5F6' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/rank/info",
    headers={"X-API-Key": "ak_..."},
    params={"order_code": "231026RANKA1B2C3D4E5F6"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/info?order_code=231026RANKA1B2C3D4E5F6", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/rank/info?order_code=231026RANKA1B2C3D4E5F6');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "active",
        "renew_auto": "on",
        "auto_renew": true,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ],
        "keywords": [
            {
                "keyword_id": 1,
                "id": 57,
                "keyword": "từ khoá mẫu 1",
                "current_rank": 3,
                "prev_rank": 4,
                "best_rank": 3,
                "url": "https://example.com/trang-1",
                "current_url": "https://example.com/trang-1",
                "search_volume": 950,
                "has_ai_overview": false,
                "competitors": [
                    {
                        "d": "example.net",
                        "r": 1
                    }
                ],
                "last_checked_at": "2026-10-23 12:55:52"
            }
        ]
    }
}
GET

/seo/rank/detail

Chỉ đọc

Khuôn CŨ của web con {project, keywords} (nội dung như /seo/rank/info) + diagnose — Bác sĩ thứ hạng: từ sát top 10 · đang tụt · có AI Overview · một từ có nhiều URL cùng website tranh nhau ở các vị trí gần nhau. Nhận order_code (hoặc project_id ở đường cũ).

GET https://cloudmoon.net/api/v1/seo/rank/detail
Tham sốVị tríBắt buộcMô tả
order_code query có hoặc project_id (đường web con cũ)

Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/rank/detail?order_code=231026RANKA1B2C3D4E5F6' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/rank/detail",
    headers={"X-API-Key": "ak_..."},
    params={"order_code": "231026RANKA1B2C3D4E5F6"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/detail?order_code=231026RANKA1B2C3D4E5F6", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/rank/detail?order_code=231026RANKA1B2C3D4E5F6');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "project": {
            "id": 57,
            "project_id": 57,
            "order_code": "231026RANKA1B2C3D4E5F6",
            "domain": "example.com",
            "name": "example.com",
            "note": "",
            "user_note": "",
            "location_code": 2704,
            "location_label": "Việt Nam",
            "frequency": "7day",
            "checks_per_month": 4,
            "keyword_count": 2,
            "paid_keywords": 2,
            "status": "active",
            "renew_auto": "on",
            "auto_renew": true,
            "alert_email": "on",
            "alerts": true,
            "price_buy": 10000,
            "price_renew": 10000,
            "time_buy": "2026-10-23 10:52:58",
            "time_renewal": "2026-10-23 10:52:58",
            "time_expire": "2026-11-22 10:52:58",
            "allowed_actions": [
                "renew"
            ]
        },
        "keywords": [
            {
                "keyword_id": 1,
                "id": 57,
                "keyword": "từ khoá mẫu 1",
                "current_rank": 3,
                "prev_rank": 4,
                "best_rank": 3,
                "url": "https://example.com/trang-1",
                "current_url": "https://example.com/trang-1",
                "search_volume": 950,
                "has_ai_overview": false,
                "competitors": [
                    {
                        "d": "example.net",
                        "r": 1
                    }
                ],
                "last_checked_at": "2026-10-23 12:55:52"
            }
        ],
        "diagnose": {
            "strike": [],
            "dropping": [],
            "aiover": [],
            "potential": [
                {
                    "keyword": "từ khoá mẫu 2",
                    "volume": 900,
                    "cur": 30,
                    "t3": 99,
                    "gain": 69,
                    "rank": 8,
                    "ai": false
                }
            ],
            "cannibal": [],
            "pushed": [],
            "top10": 2,
            "lost": 0
        }
    }
}
GET

/seo/rank/history

Chỉ đọc

Hạng TRUNG BÌNH của dự án theo ngày (tối đa 120 ngày có bản ghi gần nhất, cũ → mới — vẽ biểu đồ): d · avg_rank · top10 · total.

GET https://cloudmoon.net/api/v1/seo/rank/history
Tham sốVị tríBắt buộcMô tả
order_code query có hoặc project_id

Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/rank/history?order_code=231026RANKA1B2C3D4E5F6' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/rank/history",
    headers={"X-API-Key": "ak_..."},
    params={"order_code": "231026RANKA1B2C3D4E5F6"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/history?order_code=231026RANKA1B2C3D4E5F6", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/rank/history?order_code=231026RANKA1B2C3D4E5F6');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "history": [
            {
                "d": "2026-10-23",
                "avg_rank": 9.5,
                "top10": 1,
                "total": 2
            }
        ]
    }
}
GET

/seo/rank/keyword-history

Chỉ đọc

Lịch sử hạng của MỘT từ khoá (60 lần kiểm gần nhất, cũ → mới; rank 0 = ngoài top). keyword_id lấy từ /seo/rank/info.

GET https://cloudmoon.net/api/v1/seo/rank/keyword-history
Tham sốVị tríBắt buộcMô tả
order_code query có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
keyword_id query có —

Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/seo/rank/keyword-history?order_code=231026RANKA1B2C3D4E5F6&keyword_id=1' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/seo/rank/keyword-history",
    headers={"X-API-Key": "ak_..."},
    params={"order_code": "231026RANKA1B2C3D4E5F6", "keyword_id": "1"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/keyword-history?order_code=231026RANKA1B2C3D4E5F6&keyword_id=1", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/rank/keyword-history?order_code=231026RANKA1B2C3D4E5F6&keyword_id=1');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "order_code": "231026RANKA1B2C3D4E5F6",
        "keyword_id": 1,
        "history": [
            {
                "rank": 9,
                "checked_at": "2026-10-23 12:55:52"
            }
        ]
    }
}
POST

/seo/rank/add-keywords

Toàn quyền

THÊM từ khoá: chỉ phần VƯỢT số từ đã trả của kỳ (paid_keywords) mới thu — phí = (giá tháng theo số từ sau khi thêm − giá tháng theo paid_keywords) × số ngày còn lại tới hạn (làm tròn lên ngày) / 30, rồi làm tròn lên 1.000; từ vừa bớt trong kỳ ⇒ KHÔI PHỤC (giữ lịch sử + hạng cũ, restored) — vẫn tính vào số từ: vượt paid_keywords thì thu chênh như từ mới. Thêm xong hệ thống thử đo ngay tối đa 10 từ MỚI. max_amount = số đã thấy ở báo giá (/seo/quote tool rank_add_keywords) — cao hơn ⇒ 409 PRICE_CHANGED, 0 đồng. added chỉ đếm từ mới (added 0 vẫn có thể mất phí khi khôi phục vượt paid_keywords — đọc restored · charged). Không có từ mới lẫn từ khôi phục / đủ trần ⇒ thành công 0 đồng. Dự án tạm dừng ⇒ 409 RENEW_REQUIRED.

POST https://cloudmoon.net/api/v1/seo/rank/add-keywords
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá + cùng thân ⇒ phát lại phản hồi đã lưu, không trừ lần hai; lệnh đang chạy hoặc chưa lưu được phản hồi ⇒ 409 IDEMPOTENCY_PENDING (không dựng lại) — xem dự án bằng /seo/rank/info · /seo/rank/list, đừng đổi khoá để thử lại
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
keywords body có danh sách chuỗi, hoặc chuỗi mỗi dòng một từ
max_amount body không số tiền tối đa chấp nhận

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · PRICE_CHANGED (409) · RENEW_REQUIRED (409) · ORDER_EXPIRED (409) · IDEMPOTENCY_PENDING (409) · IN_PROGRESS (429) · PRODUCT_DISABLED (404) · SERVICE_DISABLED (503) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/add-keywords' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6","keywords":["thuê server"]}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/add-keywords",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"order_code": "231026RANKA1B2C3D4E5F6", "keywords": ["thuê server"]},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/add-keywords", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6", keywords: ["thuê server"] }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/add-keywords', ['order_code' => '231026RANKA1B2C3D4E5F6', 'keywords' => ['thuê server']], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6",
    "keywords": [
        "thuê server"
    ]
}
Phản hồi
{
    "status": "success",
    "msg": "Đã thêm 1 từ khóa — đã trừ 2.000đ (phần còn lại của kỳ)",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 3,
        "paid_keywords": 3,
        "status": "active",
        "renew_auto": "on",
        "auto_renew": true,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ],
        "added": 1,
        "restored": 0,
        "charged": 0,
        "price": 10000,
        "checked": 0
    }
}
POST

/seo/rank/remove-keyword

Toàn quyền

BỚT một từ khoá — xoá MỀM (lịch sử giữ; thêm lại trong kỳ là khôi phục), KHÔNG hoàn tiền tháng đang dùng; số từ đã trả của kỳ giữ nguyên.

POST https://cloudmoon.net/api/v1/seo/rank/remove-keyword
Tham sốVị tríBắt buộcMô tả
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
keyword_id body có từ /seo/rank/info

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · ORDER_EXPIRED (409) · IN_PROGRESS (429) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/remove-keyword' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6","keyword_id":1}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/remove-keyword",
    headers={"X-API-Key": "ak_..."},
    json={"order_code": "231026RANKA1B2C3D4E5F6", "keyword_id": 1},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/remove-keyword", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6", keyword_id: 1 }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/remove-keyword', ['order_code' => '231026RANKA1B2C3D4E5F6', 'keyword_id' => 1]);
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6",
    "keyword_id": 1
}
Phản hồi
{
    "status": "success",
    "msg": "Đã xóa từ khóa",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 1,
        "paid_keywords": 1,
        "status": "active",
        "renew_auto": "on",
        "auto_renew": true,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ],
        "keyword_id": 1
    }
}
POST

/seo/rank/auto-renew

Toàn quyền

ĐẶT tự gia hạn (không lật — gửi lại cùng giá trị vẫn đúng). Bật ⇒ từ 2 ngày trước hạn, mỗi giờ hệ thống thử tự trừ ví gia hạn +1 tháng (cùng giá với /seo/rank/renew). Không gia hạn được (tắt tự gia hạn · thiếu tiền) ⇒ quá hạn thì dự án tạm dừng (suspended — ngừng đo) — gia hạn tay để chạy lại.

POST https://cloudmoon.net/api/v1/seo/rank/auto-renew
Tham sốVị tríBắt buộcMô tả
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
enabled body có true | false

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · ORDER_EXPIRED (409) · IN_PROGRESS (429) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/auto-renew' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6","enabled":false}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/auto-renew",
    headers={"X-API-Key": "ak_..."},
    json={"order_code": "231026RANKA1B2C3D4E5F6", "enabled": False},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/auto-renew", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6", enabled: false }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/auto-renew', ['order_code' => '231026RANKA1B2C3D4E5F6', 'enabled' => false]);
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6",
    "enabled": false
}
Phản hồi
{
    "status": "success",
    "msg": "Đã TẮT tự gia hạn",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "active",
        "renew_auto": "off",
        "auto_renew": false,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ]
    }
}
POST

/seo/rank/toggle-renew

Toàn quyền

Khuôn CŨ của web con: gửi enabled ⇒ ĐẶT; vắng ⇒ LẬT trạng thái tự gia hạn. Dùng mới: /seo/rank/auto-renew.

POST https://cloudmoon.net/api/v1/seo/rank/toggle-renew
Tham sốVị tríBắt buộcMô tả
order_code body có hoặc project_id (đường web con cũ)
enabled body không true | false — vắng ⇒ lật

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · ORDER_EXPIRED (409) · IN_PROGRESS (429) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/toggle-renew' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6"}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/toggle-renew",
    headers={"X-API-Key": "ak_..."},
    json={"order_code": "231026RANKA1B2C3D4E5F6"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/toggle-renew", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/toggle-renew', ['order_code' => '231026RANKA1B2C3D4E5F6']);
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6"
}
Phản hồi
{
    "status": "success",
    "msg": "Đã TẮT tự gia hạn",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "active",
        "renew_auto": "off",
        "auto_renew": false,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ]
    }
}
POST

/seo/rank/alerts

Toàn quyền

ĐẶT nhận cảnh báo biến động thứ hạng (gửi theo kênh trong cài đặt thông báo của tài khoản).

POST https://cloudmoon.net/api/v1/seo/rank/alerts
Tham sốVị tríBắt buộcMô tả
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
enabled body có true | false

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · ORDER_EXPIRED (409) · IN_PROGRESS (429) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/alerts' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6","enabled":true}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/alerts",
    headers={"X-API-Key": "ak_..."},
    json={"order_code": "231026RANKA1B2C3D4E5F6", "enabled": True},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/alerts", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6", enabled: true }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/alerts', ['order_code' => '231026RANKA1B2C3D4E5F6', 'enabled' => true]);
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6",
    "enabled": true
}
Phản hồi
{
    "status": "success",
    "msg": "Đã BẬT nhận email cảnh báo",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "active",
        "renew_auto": "on",
        "auto_renew": true,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ]
    }
}
POST

/seo/rank/note

Toàn quyền

Ghi chú riêng của bạn cho dự án (≤ 255 ký tự; rỗng = xoá).

POST https://cloudmoon.net/api/v1/seo/rank/note
Tham sốVị tríBắt buộcMô tả
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
note body có —

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · ORDER_EXPIRED (409) · IN_PROGRESS (429) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/note' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6","note":"Dự án SEO chính"}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/note",
    headers={"X-API-Key": "ak_..."},
    json={"order_code": "231026RANKA1B2C3D4E5F6", "note": "Dự án SEO chính"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/note", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6", note: "Dự án SEO chính" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/note', ['order_code' => '231026RANKA1B2C3D4E5F6', 'note' => 'Dự án SEO chính']);
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6",
    "note": "Dự án SEO chính"
}
Phản hồi
{
    "status": "success",
    "msg": "Đã lưu ghi chú",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "Dự án SEO chính",
        "user_note": "Dự án SEO chính",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "active",
        "renew_auto": "on",
        "auto_renew": true,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ]
    }
}
POST

/seo/rank/renew

Toàn quyền

GIA HẠN +1 tháng — trừ ví NGAY theo price_renew lúc gọi (giá cao hơn giữa giá đã chốt và giá hiện hành theo số từ); phản hồi data.price = số vừa trừ. Hạn mới = max(bây giờ, hạn cũ) + 30 ngày. Mỗi dự án một lượt gia hạn mỗi ngày, tính cả ngày tạo (429 COOLDOWN tới 0 giờ). Dự án tạm dừng ⇒ gia hạn là chạy lại · đã xoá ⇒ 409 ORDER_EXPIRED. max_amount = số đã thấy ở báo giá — cao hơn ⇒ 409 PRICE_CHANGED, 0 đồng. Bảo trì không chặn gia hạn.

POST https://cloudmoon.net/api/v1/seo/rank/renew
Tham sốVị tríBắt buộcMô tả
Idempotency-Key header có chống trừ tiền hai lần khi gửi lại — cùng khoá + cùng thân ⇒ phát lại phản hồi đã lưu, không trừ lần hai; lệnh đang chạy hoặc chưa lưu được phản hồi ⇒ 409 IDEMPOTENCY_PENDING (không dựng lại) — xem dự án bằng /seo/rank/info · /seo/rank/list, đừng đổi khoá để thử lại
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
max_amount body không số tiền tối đa chấp nhận

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · PRICE_CHANGED (409) · ORDER_EXPIRED (409) · IDEMPOTENCY_PENDING (409) · COOLDOWN (429) · IN_PROGRESS (429) · UNAVAILABLE (503) · NOT_SUPPORTED (400).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/renew' \
  -H 'X-API-Key: ak_...' \
  -H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6"}'
Yêu cầu
import uuid
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/renew",
    headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
    json={"order_code": "231026RANKA1B2C3D4E5F6"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/renew", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/renew', ['order_code' => '231026RANKA1B2C3D4E5F6'], bin2hex(random_bytes(16)));
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6"
}
Phản hồi
{
    "status": "success",
    "msg": "Đã gia hạn +1 tháng",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "active",
        "renew_auto": "on",
        "auto_renew": true,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": [
            "renew"
        ],
        "price": 10000
    }
}
POST

/seo/rank/check

Toàn quyền

KIỂM HẠNG NGAY các từ của dự án trong ngân sách thời gian của lượt gọi (KHÔNG trừ tiền — nằm trong thuê bao): dự án đang chạy, còn hạn; một lần mỗi nhịp kiểm tay (429 COOLDOWN). Có thể chỉ cập nhật một phần — đọc checked / total (cập nhật được ≥ 1 từ là đã dùng lượt kiểm tay); dự án còn từ mà chưa lấy được từ nào ⇒ 503, lượt kiểm tay được trả lại; dự án không còn từ ⇒ thành công checked = total = 0.

POST https://cloudmoon.net/api/v1/seo/rank/check
Tham sốVị tríBắt buộcMô tả
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · RENEW_REQUIRED (409) · ORDER_EXPIRED (409) · COOLDOWN (429) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/check' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6"}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/check",
    headers={"X-API-Key": "ak_..."},
    json={"order_code": "231026RANKA1B2C3D4E5F6"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/check", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/check', ['order_code' => '231026RANKA1B2C3D4E5F6']);
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6"
}
Phản hồi
{
    "status": "success",
    "msg": "Đã cập nhật 2/2 từ khóa",
    "data": {
        "order_code": "231026RANKA1B2C3D4E5F6",
        "checked": 2,
        "total": 2
    }
}
POST

/seo/rank/delete

Toàn quyền

XOÁ dự án — KHÔNG hoàn tiền tháng đang dùng, không khôi phục được (confirm = đúng order_code): ngừng đo, status expired. Đường web con cũ không đòi confirm.

POST https://cloudmoon.net/api/v1/seo/rank/delete
Tham sốVị tríBắt buộcMô tả
order_code body có Mã đơn (order_code) — lấy từ lệnh mua hoặc /list
confirm body có gõ lại đúng order_code

Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_FOUND (404) · ORDER_EXPIRED (409) · IN_PROGRESS (429) · UNAVAILABLE (503).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/seo/rank/delete' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"231026RANKA1B2C3D4E5F6","confirm":"231026RANKA1B2C3D4E5F6"}'
Yêu cầu
import requests

r = requests.post(
    "https://cloudmoon.net/api/v1/seo/rank/delete",
    headers={"X-API-Key": "ak_..."},
    json={"order_code": "231026RANKA1B2C3D4E5F6", "confirm": "231026RANKA1B2C3D4E5F6"},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/seo/rank/delete", {
  method: "POST",
  headers: {
    "X-API-Key": "ak_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ order_code: "231026RANKA1B2C3D4E5F6", confirm: "231026RANKA1B2C3D4E5F6" }),
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/seo/rank/delete', ['order_code' => '231026RANKA1B2C3D4E5F6', 'confirm' => '231026RANKA1B2C3D4E5F6']);
print_r($kq);
Thân yêu cầu
{
    "order_code": "231026RANKA1B2C3D4E5F6",
    "confirm": "231026RANKA1B2C3D4E5F6"
}
Phản hồi
{
    "status": "success",
    "msg": "Đã xóa dự án (KHÔNG hoàn tiền tháng đang dùng)",
    "data": {
        "id": 57,
        "project_id": 57,
        "order_code": "231026RANKA1B2C3D4E5F6",
        "domain": "example.com",
        "name": "example.com",
        "note": "",
        "user_note": "",
        "location_code": 2704,
        "location_label": "Việt Nam",
        "frequency": "7day",
        "checks_per_month": 4,
        "keyword_count": 2,
        "paid_keywords": 2,
        "status": "expired",
        "renew_auto": "off",
        "auto_renew": false,
        "alert_email": "on",
        "alerts": true,
        "price_buy": 10000,
        "price_renew": 10000,
        "time_buy": "2026-10-23 10:52:58",
        "time_renewal": "2026-10-23 10:52:58",
        "time_expire": "2026-11-22 10:52:58",
        "allowed_actions": []
    }
}
Zalo