CJ Docs

# API Points Resource Rules

Starting June 1, 2026, CJ API access control will transition from a "daily call count" model to a "points-based consumption" model. Each API call will consume a certain number of points, and calls will be rejected when points are exhausted.

Notice

For users who register on or after June 1st, it takes effect on June 1st; for users who registered before June 1st, it takes effect on July 1st.

# Daily Available Points

Each user's daily available points are composed of the following sources:

Total Points = Base Points + Order Conversion

Source Description Reset Cycle
Base Points All users receive 50,000 points/day Resets daily at 00:00 (UTC)
Order Conversion Recent transaction amount converted at 100 points per $1 USD Recalculated daily

# Order Amount Conversion Rules

  • Conversion rate: $1 USD = 100 points
  • Formula: MAX of the last 3 months' transaction amounts × 100
  • Recalculated daily

# API Endpoint Point Costs

Each call to the following endpoints will deduct the corresponding number of points. Endpoints not listed below do not consume points.

Endpoint Points Per Call
/product/listV2 50
/product/list 50
/product/query 10
/product/variant/query 10
/product/variant/queryByVid 10
/product/stock/queryByVid 10
/product/stock/queryBySku 10
/product/stock/privateInventory/querySpuPage 10
/product/stock/privateInventory/querySkuListByProductId 10
/product/stock/privateInventory/querySkuDetailPage 10
/product/stock/privateInventory/querySkuDetailListBySku 10
/product/stock/privateInventory/querySkuFlowByCondition 10
/storehouseCenterWeb/syncStorehouseVideoRequests 10
/product/stock/getInventoryByPid 10
/logistic/freightCalculate 10
/logistic/freightCalculateTip 10
/logistic/partnerFreightCalculate 10
/logistic/getSupplierLogisticsTemplate 10
/webhook/product/subscribe 10
/webhook/product/unsubscribe 10
/product/queryProductsByImage 1000

# Deduction Priority

When an API call consumes points, the system deducts in the following order:

  1. Base Points — deducted first
  2. Order Conversion Points

# Insufficient Points

When your daily available points are insufficient for the current API call, the system will return an HTTP 429 error:

{
  "code": 429,
  "result": false,
  "message": "Insufficient API points. Used today: 50000, Remaining: 0, Required: 10",
  "pointsInfo": {
    "usedToday": 50000,
    "remaining": 0,
    "total": 50000
  }
}

# Points Information

Every API response will include a pointsInfo field showing your daily usage and remaining points:

{
  "code": 200,
  "data": { ... },
  "pointsInfo": {
    "usedToday": 1250,
    "remaining": 48750,
    "total": 50000
  }
}

# Account Freeze Policy

To maintain platform stability and security, the following inactivity policy applies:

  • If your account has zero transaction amount on CJ for 30 consecutive days, your API call permission will be revoked and API access will be suspended
  • If your account has zero transaction amount on CJ for more than 7 days, a corresponding reminder email will be sent

# Effective Date

  • For users who register on or after June 1, 2026, the points-based rate limiting rules take effect on June 1, 2026
  • For users who registered before June 1, 2026, the points-based rate limiting rules take effect on July 1, 2026
  • Until the effective date for your account, existing QPS rate limits and daily call count restrictions remain unchanged

← MCP Integration →