Free access and usage
No subscription is required. REST API data operations allow 10 calls per account per day; MCP has no daily call cap.
Free access and usage#
No subscription is required. REST API data operations allow 10 calls per account per day; MCP has no daily call cap.
All operations cost 0 credits. There is no monthly credit grant or commercial credit deduction.
Complete REST API credit table#
All operations cost 0 credits. There is no monthly credit grant or commercial credit deduction.
All API keys on an account share 10 daily REST data calls. The allowance resets at 00:00 Asia/Shanghai. The website has its own separate allowance of 10 searches per day. MCP uses neither allowance.
| Method | API | Purpose | Billing rule | Minimum | Maximum |
|---|---|---|---|---|---|
GET | /v1/auth/verify | Verify API key | 0 | 0 | 0 |
GET | /v1/credits | Read credit balance | 0 | 0 | 0 |
GET | /v1/credits/costs | Read billing catalog | 0 | 0 | 0 |
GET | /v1/rankings/chinese-low-subscriber-long-videos | Chinese low-subscriber long-video ranking | 0 | 0 | 0 |
GET | /v1/rankings/hot-today | Hot-today ranking | 0 | 0 | 0 |
POST | /v1/videos/outliers/search | Outlier video search | 0 | 0 | 0 |
GET | /v1/videos/{video_id} | Video detail | 0 | 0 | 0 |
MCP tool credit table#
All five MCP tools are free with no daily call cap. A valid key and the mcp:read scope are required. Rate limits, concurrency limits, and account restrictions still apply.
| MCP tool | Operation | Cost |
|---|---|---|
get_chinese_low_subscriber_long_videos | Chinese low-subscriber long-video ranking | 0 |
get_hot_today | Hot-today ranking | 0 |
search_outlier_videos | Outlier search | 0 |
analyze_video_url | Video detail | 0 |
get_credit_balance | Credit balance | 0 |
Rate limits and concurrency#
All API keys on an account share 10 daily REST data calls. The allowance resets at 00:00 Asia/Shanghai. The website has its own separate allowance of 10 searches per day. MCP uses neither allowance.
Each successful REST data request counts once, including empty results and server cache hits. Reusing the same Idempotency-Key and parameters replays the original result without another daily call. Failed requests and 304 responses do not consume the daily allowance.
API_DAILY_LIMIT_REACHED returns HTTP 429 after 10 REST data calls. Wait until 00:00 Asia/Shanghai; creating or rotating a key does not reset the account allowance.
GET /v1/auth/verify, GET /v1/credits, GET /v1/credits/costs, health checks, and key management do not consume the 10 daily data calls. Keys still require authentication and ownership checks.
Headers#
credits.cost is 0, credits.remaining and credits.period_ends_at are null, and credits.unlimited is true. X-Credits-Cost is 0; the remaining header is unlimited and the period-end header is omitted. Unlimited credits do not remove the REST daily limit. The API Console reports REST usage separately.