Trên trang này
- Tổng quan
- Trả theo lượt & hoàn tiền
- Các món & giá
- Lượt chạy nền
- Bản lưu & xem lại
- Tra lại một lượt
- Giới hạn
- Theo dõi thứ hạng
- Tạm ngừng bán & bảo trì
- Chạy thử
- Luật riêng
- Mã lỗi riêng
- GET /seo/products
- GET /seo/pricing
- POST /seo/quote
- POST /seo/lookup
- POST /seo/keyword
- POST /seo/audit
- POST /seo/audit-compete
- POST /seo/audit-compete/speed
- POST /seo/speed
- POST /seo/local
- POST /seo/local-pro/find
- POST /seo/local-pro/grid
- GET /seo/local-pro/grid/status
- POST /seo/backlink
- POST /seo/tech
- POST /seo/crawl
- GET /seo/crawl/status
- GET /seo/crawl/history
- GET /seo/request
- GET /seo/requests
- GET /seo/result
- GET /seo/versions
- POST /seo/rank/create
- GET /seo/rank/list
- GET /seo/rank/info
- GET /seo/rank/detail
- GET /seo/rank/history
- GET /seo/rank/keyword-history
- POST /seo/rank/add-keywords
- POST /seo/rank/remove-keyword
- POST /seo/rank/auto-renew
- POST /seo/rank/toggle-renew
- POST /seo/rank/alerts
- POST /seo/rank/note
- POST /seo/rank/renew
- POST /seo/rank/check
- POST /seo/rank/delete
Tổng quan
Địa chỉ gốc của các endpoint trên trang này:
https://cloudmoon.net/api/v1| Endpoint | Việc | Quyề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á; backlinknormal· link gappremium; món khácnull) ·subject(đối tượng đã chuẩn hoá) ·amount(số đã trừ) ·charged·lookup_id(bản lưu —nullvới món không lưu) — kèm kết quả của món. Tra domaintier: freekhông trừ tiền,request_id: null;/seo/speedcó 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èmdata:request_id·charged·refunded·refund_status(bảng dưới) ·reasonkhi có. Chỉrefunded: truemớ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ằngGET /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 UNAVAILABLEchỉ kèmrequest_id— không hoàn tiền: gửi lại cùngIdempotency-Key; món có bản lưu thì còn đọc được quaGET /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èmrequest_id. Lệnh chạy nền: lỗi khi dựng phản hồi202cũng ⇒503chỉ kèmrequest_id, lượt vẫn chạy tiếp như bình thường — theo dõiGET /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_DATAngay ở bước kiểm, không thu tiền (data.reasonno_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-Keybắt buộc ở mọi lệnh tra (kể cả hạngfree), 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èmdata.request_idkhi 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èmIdempotency-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ằngGET /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 UNAVAILABLEkhông córequest_idthườ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: đọcrefunded/refund_statushoặcGET /seo/request. Trước khi tạo lệnh mới: xemGET /seo/requests, hoặc gửi lại cùngIdempotency-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_status | Nghĩa |
|---|---|
refunded | Tiề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_pending | Lầ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. |
checking | Chư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_charged | Lượ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ón | Lệnh | Tra mới | Xem lại bản lưu |
|---|---|---|---|
| Phân tích domain — miễn phí | POST /seo/lookup tier: free | 0 đ — 30 lượt / ngày / tài khoản | — |
| Phân tích domain — Thường | POST /seo/lookup tier: normal | 9.000đ | 2.000đ |
| Phân tích domain — Chuyên sâu | POST /seo/lookup tier: premium | 31.000đ | 5.000đ |
| Nghiên cứu từ khoá — Thường | POST /seo/keyword | 7.000đ | 2.000đ |
| Nghiên cứu từ khoá — Chuyên sâu | POST /seo/keyword tier: premium | 10.000đ | 3.000đ |
| Kiểm tra on-page | POST /seo/audit | 2.000đ | 1.000đ |
| So đối thủ (hai đợt) | POST /seo/audit-compete | 11.000đ | 4.000đ |
| Local SEO / Google Maps | POST /seo/local | 3.000đ | 1.000đ |
| Local Pro — dò doanh nghiệp | POST /seo/local-pro/find | 1.000đ (thu cả khi 0 kết quả) | — |
| Local Pro — bản đồ nhiệt | POST /seo/local-pro/grid | 3x3 12.000đ · 5x5 15.000đ · 7x7 19.000đ · 9x9 25.000đ · 11x11 32.000đ | 5.000đ |
| Backlink | POST /seo/backlink | 17.000đ | 5.000đ |
| Link Gap | POST /seo/backlink mode: gap | 13.000đ | 4.000đ |
| Soi công nghệ website | POST /seo/tech | 2.000đ | — (không lưu bản) |
| Quét cả website | POST /seo/crawl | 20đ / 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 domaintier: 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_idcó ngay,statelàcrawling(quét) hoặcrunning(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èmstatus_code,da_hoankhi có) ·failed(kèmmsg);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ằngGET /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áofailedtrong khi lượt đã thu (status: done) — liên hệ hỗ trợ kèmrequest_id. - Mỗi tài khoản tối đa 3 lượt chạy nền chưa xong ⇒
429 BUSY(data.reasonbackground_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ộcIdempotency-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/resultvớilookup_idcủ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.
status | Nghĩa |
|---|---|
processing | Đang chạy (lượt chạy nền: chờ báo cáo — hỏi tiến độ). |
done | Xong, đã thu tiền — lookup_id (nếu món có bản lưu) hoặc job_id (lượt chạy nền). |
refunded | Khô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_pending | Lần hoàn trước chưa xong — hệ thống tự hoàn lại; refund_reason như dòng trên. |
checking | Hệ 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.reasonrequest_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.reasondaily_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: freevà/seo/speed⇒429 RATE_LIMITED,data.reasonfree_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èmrequest_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á:quotevớitool: 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_renewlú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-Aftertới 0 giờ). Gửimax_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-renewvớienabled— 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= đúngorder_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 theopaid_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ượtpaid_keywordsthì thu chênh như từ mới, nênadded: 0(chỉ đếm từ mới) vẫn có thể mất phí — đọcrestoredvà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 (đọcchecked/total); dự án còn từ mà chưa cập nhật được từ nào ⇒503và lượt kiểm tay được trả lại; dự án không còn từ nào ⇒ thành côngchecked = 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_keywordsvà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/productstrả503(vàGET /services/statusbáoseo: false); khi tạm tắt,/seo/productsvẫn200vớienabled: false. Bảng giá khuôn cũ/seo/pricingluôn200, ghienabled: 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 ấy404 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: 1và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ẫn402) 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_idmẫu = 0).amountlà đúng số lệnh thật sẽ trừ lúc ấy. request_idmẫu dạngSANDBOX…(tra domaintier: freemẫu:null). Lượt chạy nền mẫu trả 202; hỏi tiến độ hoặc/seo/requestvới mã ấy (vẫn kèmX-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êmBLOCKED·FAILED, bản đồ nhiệt nhậnFAILED⇒ sau 30 giây lượt mẫu kết thúcblocked/failed(như đã hoàn); mã endpoint không nhận ⇒400.- Theo dõi thứ hạng:
rank/createchạy thử trảorder_codeSANDBOX…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ớiorder_code/lookup_idthậ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.
| HTTP | code | Ý nghĩa | Nê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. |
/seo/products
Chỉ đọcDanh 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/productsKhông có tham số — chỉ cần header X-API-Key.
curl 'https://cloudmoon.net/api/v1/seo/products' \
-H 'X-API-Key: ak_...'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())// 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());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/products');
print_r($kq);{
"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
}
}
}
]
}
}/seo/pricing
Chỉ đọcBả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/pricingKhông có tham số — chỉ cần header X-API-Key.
curl 'https://cloudmoon.net/api/v1/seo/pricing' \
-H 'X-API-Key: ak_...'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())// 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());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/pricing');
print_r($kq);{
"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)."
}
}/seo/quote
Chỉ đọcBÁ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ộc | Mô 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.
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"}'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())// 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());// 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);{
"tool": "domain",
"domain": "example.com",
"tier": "normal"
}{
"status": "success",
"msg": "OK",
"data": {
"tool": "domain",
"tier": "normal",
"subject": "example.com",
"amount": 7000,
"enough": true,
"reused": false,
"background": false,
"balance": 500000
}
}/seo/lookup
Toàn quyềnTRA 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ộc | Mô 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).
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"}'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())// 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());// 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);{
"domain": "example.com",
"tier": "normal"
}{
"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
}
}
}/seo/keyword
Toàn quyềnNGHIÊ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ộc | Mô 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).
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"}'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())// 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());// 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);{
"keyword": "mua hosting",
"tier": "normal"
}{
"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": ""
}
}
}/seo/audit
Toàn quyềnKIỂ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ộc | Mô 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).
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/"}'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())// 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());// 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);{
"url": "https://example.com/"
}{
"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
}
}
}/seo/audit-compete
Toàn quyềnSO ĐỐ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ộc | Mô 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).
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"}'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())// 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());// 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);{
"url": "https://example.com/",
"mode": "domain",
"competitor": "example.org"
}{
"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
}
}
}/seo/audit-compete/speed
Toàn quyềnSO ĐỐ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ộc | Mô 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).
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}'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())// 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());// 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);{
"lookup_id": 4324
}{
"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
}
}
}/seo/speed
Toàn quyềnTỐ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ộc | Mô 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).
curl -X POST 'https://cloudmoon.net/api/v1/seo/speed' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"domain":"example.com"}'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())// 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());// 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);{
"domain": "example.com"
}{
"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"
}
}/seo/local
Toàn quyềnLOCAL 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ộc | Mô 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).
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"}'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())// 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());// 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);{
"keyword": "nha khoa",
"lat": 10.7769,
"lng": 106.7009,
"city_label": "Quận 1, TP.HCM"
}{
"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"
}
}
}/seo/local-pro/find
Toàn quyềnLOCAL 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ộc | Mô 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).
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}'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())// 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());// 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);{
"name": "Nha Khoa ABC",
"keyword": "nha khoa",
"lat": 10.7769,
"lng": 106.7009
}{
"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
}
}/seo/local-pro/grid
Toàn quyềnLOCAL 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ộc | Mô 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).
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}'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())// 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());// 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);{
"keyword": "nha khoa",
"biz": "Nha Khoa ABC",
"place_id": "ChIJ0T2NLikpdTERKxE8d61aX_E",
"lat": 10.7769,
"lng": 106.7009,
"grid_n": 5,
"radius": 5
}{
"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
}
]
}
}
}/seo/local-pro/grid/status
Chỉ đọcTiế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ộc | Mô tả |
|---|---|---|---|
request_id |
query | có | từ /seo/local-pro/grid (HTTP 202) |
curl 'https://cloudmoon.net/api/v1/seo/local-pro/grid/status?request_id=SL261023105235a1b2c3d4' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"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
}
}
}/seo/backlink
Toàn quyềnBACKLINK. 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ộc | Mô 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).
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"]}'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())// 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());// 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);{
"domain": "example.com",
"mode": "gap",
"competitors": [
"example.org",
"example.net"
]
}{
"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"
}
]
}
}
}/seo/tech
Toàn quyềnSOI 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ộc | Mô 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).
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"}'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())// 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());// 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);{
"domain": "example.com"
}{
"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
}
}/seo/crawl
Toàn quyềnQUÉ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ộc | Mô 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).
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}'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())// 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());// 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);{
"url": "https://example.com",
"pages": 50
}{
"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
}
}/seo/crawl/status
Chỉ đọcTiế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ộc | Mô tả |
|---|---|---|---|
request_id |
query | có | từ /seo/crawl (HTTP 202) |
curl 'https://cloudmoon.net/api/v1/seo/crawl/status?request_id=SL261023105235a1b2c3d4' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"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
}
}
}/seo/crawl/history
Chỉ đọcCá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ộc | Mô tả |
|---|---|---|---|
limit |
query | không | 1–100, mặc định 20 |
curl 'https://cloudmoon.net/api/v1/seo/crawl/history' \
-H 'X-API-Key: ak_...'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())// 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());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/crawl/history');
print_r($kq);{
"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
}
}/seo/request
Chỉ đọcMỘ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ộc | Mô tả |
|---|---|---|---|
request_id |
query | có | — |
curl 'https://cloudmoon.net/api/v1/seo/request?request_id=SL261023105235a1b2c3d4' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"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"
}
}/seo/requests
Chỉ đọcCá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ộc | Mô 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 | — |
curl 'https://cloudmoon.net/api/v1/seo/requests' \
-H 'X-API-Key: ak_...'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())// 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());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/requests');
print_r($kq);{
"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
}
}/seo/result
Chỉ đọcXEM 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ộc | Mô 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).
curl 'https://cloudmoon.net/api/v1/seo/result?id=4322' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab'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())// 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());// 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);{
"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
}
}/seo/versions
Chỉ đọcCá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ộc | Mô 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" |
curl 'https://cloudmoon.net/api/v1/seo/versions?domain=example.com' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"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
}
}/seo/rank/create
Toàn quyềnTẠ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ộc | Mô 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).
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"}'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())// 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());// 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);{
"domain": "example.com",
"keywords": [
"thuê vps",
"mua hosting"
],
"frequency": "7day"
}{
"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
}
}/seo/rank/list
Chỉ đọcCá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ộc | Mô tả |
|---|---|---|---|
status |
query | không | active · suspended |
curl 'https://cloudmoon.net/api/v1/seo/rank/list' \
-H 'X-API-Key: ak_...'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())// 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());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/seo/rank/list');
print_r($kq);{
"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
}
}/seo/rank/info
Chỉ đọcMỘ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ộc | Mô 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.
curl 'https://cloudmoon.net/api/v1/seo/rank/info?order_code=231026RANKA1B2C3D4E5F6' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"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"
}
]
}
}/seo/rank/detail
Chỉ đọcKhuô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ộc | Mô 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.
curl 'https://cloudmoon.net/api/v1/seo/rank/detail?order_code=231026RANKA1B2C3D4E5F6' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"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
}
}
}/seo/rank/history
Chỉ đọcHạ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ộc | Mô 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.
curl 'https://cloudmoon.net/api/v1/seo/rank/history?order_code=231026RANKA1B2C3D4E5F6' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"status": "success",
"msg": "OK",
"data": {
"project_id": 57,
"order_code": "231026RANKA1B2C3D4E5F6",
"history": [
{
"d": "2026-10-23",
"avg_rank": 9.5,
"top10": 1,
"total": 2
}
]
}
}/seo/rank/keyword-history
Chỉ đọcLị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ộc | Mô 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.
curl 'https://cloudmoon.net/api/v1/seo/rank/keyword-history?order_code=231026RANKA1B2C3D4E5F6&keyword_id=1' \
-H 'X-API-Key: ak_...'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())// 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());// 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);{
"status": "success",
"msg": "OK",
"data": {
"order_code": "231026RANKA1B2C3D4E5F6",
"keyword_id": 1,
"history": [
{
"rank": 9,
"checked_at": "2026-10-23 12:55:52"
}
]
}
}/seo/rank/add-keywords
Toàn quyềnTHÊ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ộc | Mô 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).
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"]}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6",
"keywords": [
"thuê server"
]
}{
"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
}
}/seo/rank/remove-keyword
Toàn quyềnBỚ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ộc | Mô 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).
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}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6",
"keyword_id": 1
}{
"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
}
}/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ộc | Mô 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).
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}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6",
"enabled": false
}{
"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"
]
}
}/seo/rank/toggle-renew
Toàn quyềnKhuô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ộc | Mô 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).
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"}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6"
}{
"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"
]
}
}/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ộc | Mô 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).
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}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6",
"enabled": true
}{
"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"
]
}
}/seo/rank/note
Toàn quyềnGhi 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ộc | Mô 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).
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"}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6",
"note": "Dự án SEO chính"
}{
"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"
]
}
}/seo/rank/renew
Toàn quyềnGIA 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ộc | Mô 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).
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"}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6"
}{
"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
}
}/seo/rank/check
Toàn quyềnKIỂ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ộc | Mô 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).
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"}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6"
}{
"status": "success",
"msg": "Đã cập nhật 2/2 từ khóa",
"data": {
"order_code": "231026RANKA1B2C3D4E5F6",
"checked": 2,
"total": 2
}
}/seo/rank/delete
Toàn quyềnXOÁ 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ộc | Mô 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).
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"}'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())// 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());// 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);{
"order_code": "231026RANKA1B2C3D4E5F6",
"confirm": "231026RANKA1B2C3D4E5F6"
}{
"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": []
}
}