# 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.

# 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

# 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 API account has no API calls for 30 consecutive days, your account will be automatically frozen and API access will be suspended
  • A notification email will be sent before your account is frozen
  • To unfreeze your account, please contact CJ customer support

# Effective Date

  • Starting June 1, 2026, the points-based rate limiting rules will be enforced for all users
  • Until then, existing QPS rate limits and daily call count restrictions remain unchanged

# Contact Us

If you have any questions, please contact us:

  • Email: developer@cjdropshipping.com