Authentication
Two ways, pick one: (1) Direct (recommended) — send `Authorization: Bearer
Authorization: Bearer <token>— direct (recommended)X-Api-Token: <token>— direct (alias)POST /api/dev/gateway+signature— gateway with HMAC (replay-safe)
Examples
curl -s "https://kuajingyinqing.shop/api/market/live?kw=phone%20case&platforms=amazon&limit=5" \ -H "Authorization: Bearer $TOKEN"
# Python
import requests
r = requests.get("https://kuajingyinqing.shop/api/market/live",
params={"kw": "phone case", "platforms": "amazon", "limit": 5},
headers={"Authorization": "Bearer " + TOKEN}, timeout=180)
print(r.json())
Create keys under War Room → System → API Access. Usage is metered per key.
Endpoints
| Method | Path | Description | Min plan |
|---|---|---|---|
| Shops | |||
| GET | /api/shop/caps | Capability matrix for 107 sales platforms (api / rpa / packet / crawl + channel routing) | Standard |
| GET | /api/shop/skus | Listable SKU inventory (content-factory output + sourcing ledger + own product table) | Standard |
| POST | /api/shop/packet | Build a platform-importable listing package (JSON + CSV, converted to the target marketplace currency, missing images auto-filled) | Standard |
| POST | /api/shop/publish | One-click publishing: route by capability official API -> RPA -> data package; never ends on a fake success | Standard |
| POST | /api/shop/crawl | Read/write crawl config (channel / target / frequency / timeout / item limit / proxy / UA) | Standard |
| GET | /api/shop/packets | List generated listing packages | Standard |
| GET | /api/shop/packet/dump | Read listing package contents (CSV / JSON, for download and preview) | Standard |
| Risk | |||
| GET | /api/risk/meta | Risk dictionary: queryable countries/regions, platforms and official sources | Free |
| GET | /api/risk/sources | Official sources and coverage (source count / region count / category counts); no login required | Free |
| GET | /api/risk/query | Look up bans / recalls / customs controls by product x region x platform (concurrent live fetch; anything unavailable is stated as-is) | Standard |
| GET | /api/risk/selftest | Self-test that really calls each of the 16 official sources (availability / latency / sample count / failure reason) | Premium |
| Intel | |||
| GET | /api/trade/categories | Trade categories and flow list (export / import) | Free |
| GET | /api/intel/export/src/sale | Export side, sourcing perspective, on-sale intel (directional) | Standard |
| GET | /api/intel/import/src/sale | Import side, sourcing perspective, on-sale intel (directional) | Standard |
| GET | /api/sourcing/intel/meta | Sourcing intel metadata (premium) | Premium |
| Sourcing | |||
| GET | /api/platform/sourcing | Platform sourcing capability list | Free |
| Platforms | |||
| GET | /api/sourcing/platforms | Bound / bindable sourcing platforms | Free |
| GEO Growth | |||
| POST | /api/geo/audit | 8-dimension GEO audit (evidence per item + fix order) | Free |
| POST | /api/geo/snapshot | Visibility snapshot (title / description / heading structure / indexability) | Free |
| POST | /api/geo/crawler | AI crawler reachability (one real request per each of 9 UAs) | Free |
| POST | /api/geo/schema | JSON-LD structured data extraction | Free |
| POST | /api/geo/llms | llms.txt validation (existence / structure / pointers) | Free |
| POST | /api/geo/fix | Generate fixes (schema / llms.txt / robots / FAQ) | Standard |
| Ledger | |||
| GET | /api/ledger/scoreboard | Forecast hit-rate board (by category; scored records only) | Free |
| GET | /api/ledger/predictions | List forecast records | Free |
| Moat | |||
| POST | /api/v1/cbam | CBAM carbon cost estimate (with basis; not a compliance filing) | Free |
| POST | /api/v1/margin | True net margin (after commission / shipping / returns) | Free |
| POST | /api/moat/matrix | Country x HS6 x channel compliance requirement matrix (versioned; admin only) | Standard |
| POST | /api/v1/missing | Missing-document list (against the compliance matrix) | Free |
| POST | /api/v1/origin | Reverse-derive the best origin path | Free |
| POST | /api/v1/content | Content structure compliance check (7 signals) | Free |
| POST | /api/v1/gate | LLM hallucination gate (numeric cross-check) | Free |
| POST | /api/v1/relevance | Relevance gate (off-topic detection) | Free |
| POST | /api/v1/localize | Localization quality gate (terminology / language mixing) | Free |
| POST | /api/v1/forecast | Rolling backtest on a demand series (MAPE) | Free |
| POST | /api/v1/scheduler | Multi-channel collection health and circuit breaking | Free |
| POST | /api/v1/match | Cross-source entity resolution (merge into one product) | Free |
| POST | /api/v1/resolve | Multi-source field conflict arbitration | Free |
| POST | /api/v1/intent | Buyer question intent classification | Free |
| GET | /api/v1/stats | Asset layer overview (status of 12 append-only tables) | Standard |
| GET | /api/v1/coverage | Fact-source coverage (honest accounting) | Standard |
| GET | /api/v1/agents | Traffic attribution (by UA class) | Standard |
| GET | /api/v1/verify | Deliverable fingerprint verification | Standard |
| POST | /api/moat/fact_put | Write a fact (versioned; standard tier) | Standard |
| POST | /api/moat/emit | Emit an outbound event (idempotent + backoff retry) | Standard |
| GET | /api/moat/moat_index | 32-item moat matrix (A/B/C grading + peer public facts + live probes) | Free |
| POST | /api/predict | Prediction-model engine: variable selection (stepwise / regularised / PCA), then modelling (logistic / Cox), then evaluation (AUC and C-index, calibration, decision-curve analysis, NRI/IDI, external validation, competing risks) and missing-value handling. Sixteen methods share one definition set; all of it runs server-side and only the result plus its source chapter comes back. | Standard |
| GET | /api/skill/list | 能力中心技能清单：按板块分组返回技能名与一句话说明；只给目录与介绍，不返回正文、不返回脚本 | Free |
| GET | /api/skill/get | 单个技能详情：对外说明 + 章节目录 + 开头预览；整本正文不返回，响应体有上限 | Free |
| POST | /api/skill/ask | 技能内检索：回命中片段与来源章节，单段限量，用于答疑不用于搬运原文 | Free |
| POST | /api/skill/run | 技能动作执行：预测 / 洞察 / 决策等内核服务端真算，只回结果与耗时；发布类动作默认演练不对外发 | Standard |
| Market | |||
| GET | /api/market/catalog | 105 platforms that can be fetched live (88 sales + 17 overseas sourcing), grouped, each flagged with whether a live path exists | Free |
| GET | /api/market/live | Fetch real live prices across platforms for a keyword (concurrent; platforms that fail are explicitly marked with a reason, never estimated). Metered: free 3/day, standard 40/day, flagship unlimited; cache hits are not charged | Free |
Plans & quotas
| Min plan | Daily quota |
|---|---|
| Free | 50 |
| Standard | 500 |
| Premium | 5000 |
| Flagship | 5000 |
Error codes
401— missing or invalid key403— key cannot access this endpoint: plan too low, or endpoint not in the public catalog429— daily quota exceeded (per key, resets at 00:00)503— upstream unavailable: returned when no live data — never filled with fabricated values
Endpoints evolve per release; changes sync to this page and the OpenAPI JSON.