POST
/v1/call/douyin.marketing_calendar预览抖音星图营销活动日历接口
抖音独有的接口。
抖音星图营销活动日历 API（数据接口）按起止时间取星图营销日历上的活动：平台大事件、电商节点、情绪节点、创意营销、行业活动，每个带名称、介绍、类型、进行到哪一步、招商期和活动期。一次给全，不翻页。每次调用 3 积分（约 $0.006–$0.01），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。
3 积分每次调用
最多 200 条只返回第一页
2026-10-17最近实测
995 B示例返回的体积（1 条）
最近更新：
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。
请求与返回
curl https://api.socialtoai.com/v1/call/douyin.marketing_calendar \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "since": "2026-10-01T00:00:00Z", "until": "2026-12-31T23:59:59Z" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/call/douyin.marketing_calendar", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "since": "2026-10-01T00:00:00Z", "until": "2026-12-31T23:59:59Z", },)print(response.json())# 已经通过 MCP 接好了？直接用大白话问。用“抖音星图营销活动日历”接口（douyin.marketing_calendar），参数是 since: 2026-10-01T00:00:00Z，until: 2026-12-31T23:59:59Z。# 你的 AI 会调用 call 工具，参数是：{ "since": "2026-10-01T00:00:00Z", "until": "2026-12-31T23:59:59Z"}200 OK995 B3 积分
{ "op": "douyin.marketing_calendar", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "…", "ref": null, "approx": [], "type": "entry", "entry_type": "xingtu_campaign", "title": "…", "url": null, "rank": null, "heat": null, "fields": { "description": "…", "category": "ecommerce", "stage": "open", "signup_starts_at": "2026-09-29T02:29:20.000Z", "signup_ends_at": "2026-10-31T02:29:20.000Z", "starts_at": "2026-10-10T02:29:04.000Z", "ends_at": "2026-11-20T02:29:04.000Z", "image_url": "https://example.com/…" } } ], "unavailable": [], "page": { "has_more": false }, "cost_credits": 3}- entry_type
- xingtu_campaign
- description
- …
- category
- ecommerce
- stage
- open
- signup_starts_at
- 2026-09-29T02:29:20.000Z
- signup_ends_at
- 2026-10-31T02:29:20.000Z
- starts_at
- 2026-10-10T02:29:04.000Z
示例里的名称和正文已去掉，数字是录制时的真实值。
示例数据录制的 43 条里的 1 条
2 个参数。
全部必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里，不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| since | datetime | 必填 | — | 时间段的开始：取和这段时间有交集的活动 |
| until | datetime | 必填 | — | 时间段的结束 |
只返回第一页：最多 200 条，没有 cursor 参数，也不能往后翻。
items 里每一条的字段。
抖音给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接；平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次，从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.description | string | 活动介绍。 |
| items[].fields.category | string | 活动类型：平台大事件、电商节点、情绪节点、创意营销或行业活动。 |
| items[].fields.stage | string | 活动进行到哪一步：筹备中、招商中、已上线或已结束。 |
| items[].fields.signup_starts_at | string | 招商开始时间。 |
| items[].fields.signup_ends_at | string | 招商结束时间。 |
| items[].fields.starts_at | string | 活动开始时间。 |
| items[].fields.ends_at | string | 活动结束时间。 |
| items[].fields.image_url | string | 活动主图。 |
null抖音给不了的字段这个调用的字段抖音都给得出；单条内容缺某个值时，那个字段是 null。
每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。 返回格式
会发生什么。
一次调用只返回第一页，最多 200 条，没有 cursor，3 积分。
正常执行但没有结果，算一次成功的调用：status 为 "empty"，items 为空，扣 3 积分。
每把 Key 每秒 1 次，购买后 5 次；超出不扣费。 频率限制
失败的调用 0 积分，不会自动重试。 错误码
接好 MCP 后，这样问就会用到它。
按起止时间取星图营销日历上的活动（since：2026-10-01T00:00:00Z，until：2026-12-31T23:59:59Z）
3 积分call {"op":"douyin.marketing_calendar","since":"2026-10-01T00:00:00Z","until":"2026-12-31T23:59:59Z"}
常见问题。
简短回答。
抖音的全部接口需要抖音账号，或者申请抖音官方的 API 吗？
不需要，只要一把 SocialToAI 的 Key。返回的是抖音上公开可见的内容和账号信息，你不用登录抖音，也不用在那边申请任何东西。
能翻到下一页吗？
不能。抖音的这个接口只给第一页（最多 200 条），返回里没有 cursor，page.has_more 始终是 false。
“预览”是什么意思？
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。