📣 Bilibili Trending Videos Scraper

Scrape Bilibili trending and ranking lists: video, uploader, views, rank and rank movement. Run it once and you get the current records as a dataset — that is the default. Turn on watch mode and a scheduled run returns only what changed since the last run (see Optional: run it on a schedule).

Output is one trend_record row per result; billing is pay-per-event, the value event being one trend delta (a $0.02 start fee per run, then $0.03 per trend delta plus one $0.10 source check per run that reads the source). Source: api.bilibili.com, search.bilibili.com, www.bilibili.com.

Who buys this

Buyers usually search for Bilibili trending or Bilibili videos.

• B2B sales and account teams using Bilibili trending as a trigger signal.
• PR, comms and market-intelligence teams monitoring Bilibili videos.
• Investors and analysts tracking company events as they are announced.

📊 Sample Output

Real rows from run XUJnfjXlPX5SXu2mv on build 0.1.36 (2026-09-28), the same input as the Quick start below — every value is as the source published it (emails masked, long text shortened):

run_id	bvid	aid	composite_key	title	title_original
XUJnfjXlPX5SXu2mv	BV1MzhD6qEHy	117335268530806	popular|all|BV1MzhD6qEHy	⚡️ 满 级 木 头 人 ⚡️	⚡️ 满 级 木 头 人 ⚡️
XUJnfjXlPX5SXu2mv	BV1nAh261Epy	117331577539324	popular|all|BV1nAh261Epy	《胸型审美类别》	《胸型审美类别》
XUJnfjXlPX5SXu2mv	BV161aa6CERA	117343304813994	popular|all|BV161aa6CERA	【特效向】蔡徐坤vs全明星 第二季	【特效向】蔡徐坤vs全明星 第二季
XUJnfjXlPX5SXu2mv	BV1YGaq6rEUB	117346760922832	popular|all|BV1YGaq6rEUB	当上把坑我的辅助排到了对面	当上把坑我的辅助排到了对面
XUJnfjXlPX5SXu2mv	BV1xnag6HEFj	117329111356487	popular|all|BV1xnag6HEFj	天塌了！中国男乒32年亚运王朝正式终结！	天塌了！中国男乒32年亚运王朝正式终结！
XUJnfjXlPX5SXu2mv	BV1zWab6wEL2	117340956069552	popular|all|BV1zWab6wEL2	从央视背书，到多平台封号，销冠李老板为何被封	从央视背书，到多平台封号，销冠李老板为何被封
XUJnfjXlPX5SXu2mv	BV1hCab6EEEq	117340670859387	popular|all|BV1hCab6EEEq	刚开始遇见都是美好的	刚开始遇见都是美好的
XUJnfjXlPX5SXu2mv	BV14Qah6DEBL	117343824973370	popular|all|BV14Qah6DEBL	三幻魔集结！超越神的力量！【水无月菌】	三幻魔集结！超越神的力量！【水无月菌】

The run finished with the status message: NORMAL: records=100; surfaces_complete=1/1

✅ What you get

One of three record types, discriminated by record_type: trend_record, trend_delta, or source_receipt.

Each row is flat JSON with these fields (from the dataset schema and the sample run; a field the source does not publish for a given row is null):

• record_type (string) — Discriminator.
• run_id (string) — Apify run id that produced this item.
• surface (string/null) — popular | ranking | search.
• query (string/null) — Search keyword for the search surface; null otherwise.
• category_id (integer/null) — Ranking rid for the ranking surface; null otherwise.
• rank (integer/null) — 1-based rank within the surface/query (non-null on trend_record).
• bvid (string/null) — Bilibili source-native video id.
• aid (integer/null) — Bilibili numeric av id.
• composite_key (string/null) — surface|normalized-query-or-category|bvid.
• title (string/null) — Original-script (Chinese) title (non-null on trend_record).
• title_original (string/null) — Original Chinese-script title, retained verbatim.
• title_translated (string/null) — Published translation only; null when none is published. Never machine-translated.
• translation_status (string/null) — source_provided | none_published.
• video_url (string/null) — Public video URL.
• author_name (string/null) — Uploader display name.
• author_mid (string/null) — Uploader member id.
• published_at (string/null) — Video publish time (RFC3339 UTC) when available.
• duration_seconds (integer/null) — Video duration in seconds when available.
• description (string/null) — Public summary when includeDescriptions is set.
• description_truncated — e.g. False
• metrics (object/null) — views, danmaku, replies, favorites, coins, shares, likes (nullable non-negative integers).
• metric_basis (array/null) — Metric keys actually present for this row.
• source_url (string) — Exact public request URL supporting this item.
• observed_at (string) — RFC3339 UTC time after shape validation.
• content_hash (string/null) — SHA-256 over canonical buyer-visible mutable fields.
• delta_type (string/null) — trend_delta only.
• previous_rank (integer/null) — Rank at the prior observation (trend_delta).
• current_rank (integer/null) — Rank at this observation (trend_delta).
• rank_change (integer/null) — current_rank - previous_rank.
• metric_changes (object/null) — Per-metric before/after/absolute/percent on an engagement delta.
• changed_fields (array/null) — Sorted changed field names on a change delta.
• absence_confirmations (integer/null) — Consecutive eligible absences recorded (trend_delta).
• baseline_id (string/null) — Watch baseline id (trend_delta).
• terminal (string/null) — source_receipt only.
• reason_code (string/null) — Stable terminal reason code.
• canary_passed (boolean/null) — Whether the source-shape canary passed for this surface.

✅ What you get

✅ What you get

✅ What you get

3. Output

Three record types: trend_record (normalized ranked video with bilingual titles, metrics, and content_hash), trend_delta (entered / rank_changed / engagement_changed / exited / reentered with rank_change, metric_changes, changed_fields), and source_receipt (per surface/query terminal: NORMAL / GENUINE_EMPTY / PARTIAL / BLOCKED). Every item carries record_type, schema_version, run_id, exact source_url, and observed_at.

Every run also writes a RUN_RECEIPT record to its key-value store with the source checks it made and the counts it charged — diagnostics never land in the paid dataset.

⚙️ Sample inputs

1. Quick start — the Store example (this is what the sample above came from)

{
  "watchMode": false,
  "surfaces": [
    "popular"
  ],
  "topN": 10,
  "pageCount": 2,
  "maxItems": 10
}

The sample run charged exactly: 1 × $0.02 actor-start + 100 × $0.02 trend-record + 0 × $0.03 trend-delta + 0 × $0.10 source-check = $2.02 on the Free tier — every delivered row was billed.

2. A smaller, narrowed run

{
  "watchMode": false,
  "surfaces": [
    "popular"
  ],
  "topN": 10,
  "pageCount": 2,
  "maxItems": 5
}

Caps the run at 5 rows — about $0.27 on the Free tier ($0.02 start + $0.10 source check + 5 × $0.03).

3. Optional watch mode (changes only, for a schedule)

{
  "watchMode": true,
  "surfaces": [
    "popular"
  ],
  "topN": 10,
  "pageCount": 2,
  "maxItems": 10
}

The first run seeds a private baseline and emits zero deltas; every later run emits one row per change, billed at $0.03 each plus the $0.10 source check.

🧾 JSON sample record

One real record from run XUJnfjXlPX5SXu2mv, exactly as it lands in the dataset (emails masked, long text shortened):

{
  "record_type": "trend_record",
  "schema_version": "1.0",
  "run_id": "XUJnfjXlPX5SXu2mv",
  "surface": "popular",
  "query": null,
  "category_id": null,
  "rank": 1,
  "bvid": "BV1MzhD6qEHy",
  "aid": 117335268530806,
  "composite_key": "popular|all|BV1MzhD6qEHy",
  "title": "⚡️ 满 级 木 头 人 ⚡️",
  "title_original": "⚡️ 满 级 木 头 人 ⚡️",
  "title_translated": null,
  "translation_status": "none_published",
  "video_url": "https://b23.tv/BV1MzhD6qEHy",
  "author_name": "兔总裁s",
  "author_mid": "15385187",
  "published_at": "2026-09-26T04:25:00Z",
  "duration_seconds": 62,
  "description": null,
  "description_truncated": false,
  "metrics": {
    "views": 2449809,
    "danmaku": 3970,
    "replies": 2355,
    "favorites": 17525,
    "coins": 14532,
    "shares": 2850,
    "likes": 75090
  },
  "metric_basis": [
    "coins",
    "danmaku",
    "favorites",
    "likes",
    "replies",
    "shares",
    "views"
  ],
  "source_url": "https://api.bilibili.com/x/web-interface/popular?pn=1&ps=50",
  "observed_at": "2026-09-28T16:17:05Z",
  "content_hash": "49523ba6837922048542406535cfad6976b453424b362b9298be1bf0198a5ce4"
}

🔧 How it works

Source. The actor reads api.bilibili.com, search.bilibili.com, www.bilibili.com — endpoints: https://api.bilibili.com/x/web-interface/popular, https://api.bilibili.com/x/web-interface/ranking/v2, https://api.bilibili.com/x/web-interface/search/type, https://search.bilibili.com/all. Public pages and feeds only; nothing behind a login.

Transport. Plain HTTPS from the Apify platform, no proxy.

Watch semantics. Snapshot mode (watchMode: false) returns a preview. Watch mode keys every record on a source-native id, stores a private baseline in a named key-value store, and on each later run emits one delta row per change (new / changed / removed). A blocked fetch is never diffed, so a source outage cannot show up as a mass removal.

Terminal states. A run ends NORMAL, CAPPED (your cap was reached), PARTIAL (something was withheld and the message says what), GENUINE_EMPTY (the source was read and truly had nothing in scope) or BLOCKED (the source refused or changed shape — the run FAILS loud and bills nothing). A zero-row run is never reported as a silent success.

Charging. Each trend delta is charged at the moment it is pushed (trend-delta); a row that fails to charge is not delivered, so the dataset count always equals the charged count. One source-check is charged per run that actually read the source.

🔧 How it works

Transport. Plain HTTPS from the Apify platform, no proxy.

🔧 How it works

Transport. Plain HTTPS from the Apify platform, no proxy.

🔧 How it works

Transport. Plain HTTPS from the Apify platform, no proxy.

1. What it does

The actor records logged-out Bilibili public trend surfaces, establishes a zero-alert first-run baseline, and emits only qualified changes afterward. It is built for media monitoring, market research, agencies, and APAC brand teams needing record-backed recurring collection rather than dashboard screenshots. Snapshot mode returns current records; watch mode seeds a private baseline and returns confirmed later deltas. Receipts separate complete, empty, partial, and blocked checks.

Original Chinese-script titles are always retained (title_original). A title_translated field carries a published translation only and is null otherwise — the actor never machine-translates silently.

5. Watch mode

Named key-value store bilibili-trends-v1-{baselineId} holds the baseline. The first complete run seeds and emits zero deltas. Later scheduled runs emit at most one confirmed delta per video, combining rank and engagement changes. A video is exited only after it is absent from the complete topN for exitConfirmations consecutive eligible runs; partial or blocked surfaces never increment absence. Same video = exact composite key surface|normalized-query-or-category|bvid.

8. Honest limits

Bilibili's web data endpoints are undocumented and volatile; search results may vary; no historical backfill, comments, account-only data, login, CAPTCHA solving, or risk-control bypass. exited means absent from the configured complete topN, not deleted from Bilibili. The actor stops loudly (BLOCKED) when anonymous public access or the required shape cannot be proved.

9. Compliance

Public logged-out GET only; no accounts, cookies, QR login, copied signatures, CAPTCHA solving, or proxy evasion. Comply on objection. Buyers are responsible for lawful use and source terms.

Preview vs Watch mode

Preview (snapshot) mode (watchMode: false) returns the current trend records for the requested surfaces and bills one trend-record per emitted row — use it for a one-off pull or to see the shape of the data before committing to a schedule.

Watch mode (watchMode: true, the default) seeds a private baseline on the first run (zero deltas, no trend-record billing), then on later runs emits only qualified trend-delta rows against that baseline. A zero-delta watch poll over a complete surface charges a single source-check so a listed price stays a charged price; active runs bill via trend-delta and are not double-charged. source_receipt diagnostics are written to the RUN_RECEIPT key-value record and the log — never to the dataset, and never billed.

What is not done. No login, no cookie or CAPTCHA bypass, no private or personal-account data, no browser automation.

⏰ Optional: run it on a schedule

A single run returns the current records. If you also want to be told what changed over time, open the actor in Apify Console → Schedules → Create new, add this actor with input 3 above (watchMode: true) so each run returns only the changes, and pick a cadence:

• Daily — 0 7 * * * (07:00 UTC): catch changes within a day.
• Weekly — 0 7 * * 1: a Monday digest.

Each run is independent; keep the same input on the schedule so the results stay comparable. Schedules can also POST results to a webhook (Console → Integrations).

⏰ Optional: run it on a schedule

A single run returns the current records. If you also want to be told what changed over time, open the actor in Apify Console → Schedules → Create new, add this actor with the watch-mode input above (watchMode: true) so each run returns only the changes, and pick a cadence:

💰 Pricing example

Event	Free	Bronze	Silver	Gold
Actor start (actor-start)	$0.02	$0.02	$0.02	$0.02
Trend record (trend-record)	$0.02	$0.018	$0.016	$0.0134
Trend delta (trend-delta)	$0.03	$0.027	$0.024	$0.0201
Source check (source-check)	$0.10	$0.09	$0.08	$0.067

Worked at the live Free-tier price (watch mode, one delta per change):

• 8 trend deltas: $0.02 start + $0.10 source check + 8 × $0.03 = $0.36
• 25 trend deltas: $0.02 start + $0.10 source check + 25 × $0.03 = $0.87
• 1000 trend deltas: $0.02 start + $0.10 source check + 1000 × $0.03 = $30.12

A run that delivers zero rows charges the $0.02 start fee plus the $0.10 source check (the source was read and reported empty). A BLOCKED run (source refused) fails loud and charges no value event. The start fee is charged once per GB of run memory; the default run memory is 1024 MB.

Yield on the sample run: NORMAL: records=100; surfaces_complete=1/1. maxItems is a hard ceiling on what is delivered and billed, never a target.

⚖️ Legal & ToS

This actor reads public, logged-out pages and feeds published by api.bilibili.com, search.bilibili.com, www.bilibili.com. It collects only what the source publishes to any visitor, identifies itself, and does not access accounts, private data or anything behind authentication. Use the output in line with the source's terms and your local law; the intended use is B2B research and monitoring.

❓ FAQ

Q: Do I need an API key or a login?
A: No. The source (api.bilibili.com, search.bilibili.com, www.bilibili.com) is read logged-out; the input schema has no key field and the actor carries no secrets.

Q: Why did my run return 0 rows?
A: Read the run's status message. GENUINE_EMPTY means the source was read and had nothing in scope for your input (in watch mode the first run always seeds the baseline and returns zero deltas); BLOCKED means the source refused and the run failed without billing a value event — retry later or narrow the input. A zero-row run bills the start fee plus one source check.

Q: How many rows can one run return?
A: Up to maxItems (default 1000). Raise the cap for a bigger run; you pay per delivered row.

Q: What does watch mode remember between runs?
A: A private baseline of source-native record ids in a named key-value store. Each later run diffs the live source against it and emits only changes.

Q: How fresh is the data?
A: Every run reads the source live at run time; nothing is cached between runs except the watch baseline. Put it on a schedule for a continuous feed.

Q: What formats can I export?
A: The dataset downloads as JSON, CSV, Excel, XML or RSS from the run's Dataset tab or the Apify API, and any run can push to a webhook or integration.

Q: How is this different from the other market announcement scrapers actors?
A: Same output shape and billing model; this one covers api.bilibili.com, search.bilibili.com, www.bilibili.com. The siblings under Related Actors cover the other sources or slices — run several on one schedule for a combined feed.

🆘 Troubleshooting

• Run FAILED with BLOCKED → the source refused the request or changed its page shape → nothing was billed beyond the start fee; retry after a while, and if it persists open an Issue with the run id.
• Status says CAPPED → your cap (maxItems) was reached → raise it for a bigger run.
• Input validation error on start → a field is outside the schema's allowed values → start from the Quick start block and change one field at a time.
• Run TIMED-OUT → a very wide request on a slow day → raise the run timeout in Run options or narrow the input; what was delivered before the timeout is still in the dataset.
• First watch run shows no deltas → expected: it seeds the baseline; changes appear from the second run.

🔗 Related Actors

• ASX Company Announcements Scraper — Scrape ASX company announcements for the tickers you name: headline, type, price-sensitive flag, date and a direct link to the announcement PDF (the…
• GOV.UK Press Releases Scraper — Scrape GOV.UK press releases and announcements: department, title, summary, date and link from the official search API. One record per result. Pay pe…
• Korea DART Corporate Filings Scraper — Scrape Korean corporate filings from DART: company, report type, filing date and link. Every run returns the current records as a dataset. Optional w…
• Company Newsroom Press Releases Scraper — Scrape the press releases a company's own newsroom or investor-relations feed currently lists: publisher, headline, summary, date and link, from as m…
• 🏢 About NexGen Watch — NexGen Watch is a catalog of more than 300 public data actors built on official sources, pay-per-result. Browse the catalog at apify.com/nexgenwatch.

⭐ Found this useful?

If this actor saved you a manual check, a quick review on the Apify Store helps other teams find it. Feature request or a source that changed? Open it from the Issues tab — every one is read.