Bilibili Public Trends Delta Watch

Watch public Bilibili Popular, rankings, and selected searches for confirmed entry, exit, rank, and engagement changes.

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.

2. Input

surfaces (popular, ranking, search), keywords (required for search), rankingCategories, watchMode, baselineId, pageCount, topN, rankChangeThreshold, metricChangePercent, exitConfirmations, includeDescriptions, maxItems, maxRequests. No arbitrary URLs are accepted; keywords and ranking categories are validated against §1 bounds.

Example input:

{"surfaces":["popular","search"],"keywords":["人工智能","新能源汽车"],"watchMode":true,"pageCount":2,"topN":100,"rankChangeThreshold":5,"metricChangePercent":20,"exitConfirmations":2,"includeDescriptions":false,"maxItems":500,"maxRequests":50}

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.

4. Pricing

Pay-per-event: actor start, trend record, trend delta, and watch source check. Amounts are configured at publish. source_receipt items are always returned and never billed.

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.

6. API, CLI, and MCP

Runs on the Apify platform via API, CLI, schedules, and MCP like any Actor. Watch state persists in the named key-value store; each run is independent and stateless over that store.

7. Use with

China media teams monitoring high-heat videos; agencies watching category movement; brands tracking public topic/search visibility; researchers building time-stamped chart histories.

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.

Pricing

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

Prices are the filed pay-per-event amounts per plan tier (PLATINUM/DIAMOND match GOLD). Blocked and refused runs do not intentionally charge value events.