CORE API
Bilibili trending API
trending on Bilibili: 0.2 credits per successful call, with clear inputs, source data and billing.
01 / CORE API
One request
0.2 credits per successful or empty call. Failed calls cost 0.
Replace any PASTE_PUBLIC placeholder with a supported public identifier. This is a request template; it does not run automatically.
curl --request POST 'https://api.socialtoai.com/v1/trending' \
--header "X-API-Key: $SOCIALTOAI_API_KEY" \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
--data '{"platform":"bilibili"}'02 / CORE API
Native support
Result shape: leaderboard. Pagination: not supported.
Categories: B站热搜.
These values describe the reference card. Additional restrictions can apply to user discovery or a content subtype. Inspect applied_params and warnings instead of assuming an unsupported filter was honored.
03 / CORE API
A schema-checked example
Illustrative result with one invented value and an example trial balance. It shows the response shape; it is not a live response or a production availability measurement.
{
"request_id": "example_only_not_a_live_call",
"schema_version": "v1",
"fetched_at": "2026-09-05T00:00:00Z",
"status": "ok",
"applied_params": {},
"warnings": [],
"items": [
{
"kind": "leaderboard",
"rank": 1,
"title": "Illustrative trending topic",
"heat": 982000
}
],
"platform": "bilibili",
"billing": {
"cost": 0.2,
"balance": 1.8,
"unit": "credits",
"pricing": "standard"
}
}04 / CORE API
Platform limitations
Search returns videos. Unsupported popularity sorts fall back to relevance; image and text filters fall back to video, with warnings.
Search reads up to 20 native records per call. The default count=20 can advance directly to the next native page; filtering non-video or duplicate records may return fewer items.
A smaller search count reads the remaining portion of the same source page on continuation. If upstream items or order change, continuation fails with upstream_error and is not charged. Snapshot stability is not guaranteed; the gateway does not automatically retry or increase your count.
Use a BV ID, a standard video URL or a b23.tv share link for items. Use a numeric UID or a space.bilibili.com profile URL for accounts.
Pass returned opaque cursors unchanged for comment pages and reply branches.
Frequently asked questions
What does this call cost?
0.2 credits for a successful or empty lookup. Failed calls cost 0 credits.
Can I paginate?
This action does not support pagination.
Are all platform features covered?
Search returns videos. Unsupported popularity sorts fall back to relevance; image and text filters fall back to video, with warnings. Search reads up to 20 native records per call. The default count=20 can advance directly to the next native page; filtering non-video or duplicate records may return fewer items. A smaller search count reads the remaining portion of the same source page on continuation. If upstream items or order change, continuation fails with upstream_error and is not charged. Snapshot stability is not guaranteed; the gateway does not automatically retry or increase your count. Use a BV ID, a standard video URL or a b23.tv share link for items. Use a numeric UID or a space.bilibili.com profile URL for accounts. Pass returned opaque cursors unchanged for comment pages and reply branches.
YOUR AI. A WIDER VIEW.
Start with one good question.
Get 2 free credits ↗No card. Read-only public data. Explicit limits and transparent credits.