Douyin Marketing Calendar Scraper avatar

Douyin Marketing Calendar Scraper

Pricing

from $4.00 / 1,000 results

Go to Apify Store
Douyin Marketing Calendar Scraper

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

ToolzerHub

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

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

scraperTypeReturnsNeeds
calendarEvents (default)Campaign events and related topics for a date range
calendarEventDetailFull detail for one eventcalendar_id

Input

FieldUse it for
start_date, end_datecalendarEvents only, as yyyyMMdd. Left empty, the range defaults to today through six months out.
city_codecalendarEvents only. Narrows the calendar to one city.
category_codecalendarEvents only. Narrows the calendar to one category.
calendar_idRequired for calendarEventDetail. From a calendarEvents row's id.
{
"scraperType": "calendarEvents",
"start_date": "20260801",
"end_date": "20261001"
}

Output

FieldModeContents
id, hot_title, start_date, end_date, level_code, category_name, city_name, cover_url, event_status, tags, sentence, related_topics, calendar_listcalendarEventsEach 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_idcalendarEventDetailFull 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.

ActorPurpose
Douyin Trending ScraperCity codes for city_code, plus the reactive trend boards this calendar's planned events sit alongside
Douyin Hot Search ScraperWhat's trending right now, rather than what's scheduled ahead