tiktok-event-center

Search TikTok Watchdog change events via DSL queries with pagination and aggregation.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill tiktok-event-center-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tiktok-event-center
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/tiktok-event-center
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill tiktok-event-center-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers need a fast way to investigate change events recorded in the TikTok Watchdog event center, but manually browsing the web UI is slow and hard to automate. This Skill provides programmatic read-only search over the event repository with time windows, pagination, and aggregate statistics. ## Core Features & Use Cases - DSL-Based Event Search: Query events using the Watchdog event DSL (e.g., operators:laihongquan, source:faas) through the POST /api/v1/events/search endpoint. - Time Windows & Pagination: Specify RFC3339 time ranges or a lookback in days (up to 366), and page through results with cursors. - Aggregation & Stats-Only Mode: Retrieve facet aggregations and totals without fetching individual event rows by enabling stats_only. - Use Case: During an incident review, search all change events by a specific operator over the past 7 days, page through the results, and pull aggregate counts by source to identify what changed. ## Quick Start Search the TikTok Watchdog event center for all events by operator laihongquan over the last 7 days and show the first 30 results.

Frequently Asked Questions about tiktok-event-center

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search TikTok Watchdog events by operator?

Use the search action with a DSL query such as operators:laihongquan. The query syntax matches the Watchdog event explorer page, and results return paginated event records with id, title, action, source, and status fields.

How to paginate through Watchdog event search results?

Pass the end_cursor value from the previous response's data.page_info into the cursor parameter of the next request. The response also indicates has_next_page so you know when more pages exist.

Can I get event statistics without fetching individual records?

Yes, set stats_only to true, which forces page_size to 0 and returns only aggregation data with a default Source facet. You can also customize facets using the facet_keys parameter.

What authentication does the Watchdog event search require?

It requires a ByteCloud JWT for the I18N or corresponding region, consistent with gdpa-cli login. The x-jwt-token header is injected automatically by the tool, so you never paste tokens manually.

What are the limitations of the Watchdog event search API?

The skill is read-only and cannot write events. The lookback window is capped at 366 days, page size is limited to 100 rows, and the base URL is restricted to https://watchdog-i18n.bytedance.net.