Public APIFree Preview Available

China Marketing Calendar API

Integrate China's marketing events, public holidays, and shopping festivals directly into your tools, dashboards, and AI assistants. Free 90-day preview — no API key required.

90-Day Free Preview

No signup required

AI-Friendly

OpenAPI 3.0 spec included

iCal Export

Subscribe in any calendar app

Updated Annually

2026 events ready

Getting Started

The China Marketing Calendar API provides structured data about Chinese marketing events for the current year. It is designed to be simple, RESTful, and AI-friendly — with an OpenAPI 3.0 specification for easy integration with AI assistants and developer tools.

The free tier returns events within the next 90 days with no authentication required. For full-year access, register for a free YIVA Digital account and generate an API key.

Access Tiers

Tier	Scope	Authentication	Rate Limit
Free Preview	Next 90 days	None required	100 req/hour per IP
Full Year	All 2026 events	API Key (free)	1,000 req/hour per key

Quick Start

bash

# Free 90-day preview (no auth required)
curl "https://www.yivadigital.com/api/public/marketing-calendar"

# Filter by month
curl "https://www.yivadigital.com/api/public/marketing-calendar?month=2"

# Filter by event type
curl "https://www.yivadigital.com/api/public/marketing-calendar?type=shopping_festival"

Get Full Year Access — Free

Create a free YIVA Digital account to get an API key with full-year access to all 37 China marketing events, iCal export, and Atom XML feed.

AI Tool Integration

The API includes an OpenAPI 3.0 specification, making it easy to add to ChatGPT Custom GPTs, Claude Projects, or any AI assistant that supports tool/function calling. Simply point your AI tool to the OpenAPI spec URL:

OpenAPI Spec URL

https://www.yivadigital.com/api/public/openapi.json