Douyin Marketing Calendar Scraper
Pricing
from $4.00 / 1,000 results
Douyin Marketing Calendar Scraper
Collect Douyin's official marketing-event calendar: seasonal and platform campaign moments for a date range, filtered by city and category, each with its status, tags, and related topics. Get full detail for any single event by its calendar ID. Plan content around Douyin's own campaign calendar.
Pricing
from $4.00 / 1,000 results
Rating
0.0
(0)
Developer
ToolzerHub
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
Collect Douyin's official marketing-event calendar: seasonal and platform campaign moments for a date range, filtered by city and category, each with its status, tags, and related topics. Get full detail for any single event by its calendar ID. Pick a mode with scraperType.
Modes
scraperType | Returns | Needs |
|---|---|---|
calendarEvents (default) | Campaign events and related topics for a date range | — |
calendarEventDetail | Full detail for one event | calendar_id |
Input
| Field | Use it for |
|---|---|
start_date, end_date | calendarEvents only, as yyyyMMdd. Left empty, the range defaults to today through six months out. |
city_code | calendarEvents only. Narrows the calendar to one city. |
category_code | calendarEvents only. Narrows the calendar to one category. |
calendar_id | Required for calendarEventDetail. From a calendarEvents row's id. |
{"scraperType": "calendarEvents","start_date": "20260801","end_date": "20261001"}
Output
| Field | Mode | Contents |
|---|---|---|
id, hot_title, start_date, end_date, level_code, category_name, city_name, cover_url, event_status, tags, sentence, related_topics, calendar_list | calendarEvents | Each campaign event or related topic |
id, hot_title, start_date, end_date, level_code, category_name, city_name, cover_url, event_status, publish_cnt, tags, related_topics, source_calendar_id | calendarEventDetail | Full detail for one event |
{"id": "7449281002319847","hot_title": "国庆黄金周","start_date": "20261001","end_date": "20261007","event_status": "upcoming","calendar_list": "event"}
Questions
Why do I see rows that aren't campaign events?
calendarEvents returns two lists in one request: the main event list, and a smaller list of related topics Douyin attaches alongside it. Both come back together rather than as separate modes; calendar_list tags each row event or topic so you can tell which list it came from.
What happens if I leave start_date and end_date empty?
The range defaults to today through six months out. Leaving the upstream endpoint's own dates blank causes it to fail server-side, so this Actor always fills a default rather than passing nothing through.
Do dates need to be Unix timestamps?
No — always yyyyMMdd, the same format every other board in this domain uses. Douyin's own calendar endpoint actually wants Unix seconds; the Actor converts internally so the input format stays consistent regardless of what the endpoint underneath expects.
Where do I get a calendar_id for calendarEventDetail?
From the id field on a row calendarEvents already returned.
Related Actors
| Actor | Purpose |
|---|---|
| Douyin Trending Scraper | City codes for city_code, plus the reactive trend boards this calendar's planned events sit alongside |
| Douyin Hot Search Scraper | What's trending right now, rather than what's scheduled ahead |