按数据类型找接口
内容数据接口
3 个平台的 3 个接口，用同一个 Post 对象返回内容数据。单条内容此刻的互动数字：播放或阅读、点赞、评论、分享和收藏，不带正文和图片。每次 $0.002 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。
内容数据 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | 抖音视频播放量 | GET /v1/douyin/videos/metrics | 1 | $0.002/次 |
| 微信公众号 | 公众号文章互动数据 | GET /v1/wechat_mp/articles/metrics | 1 | $0.02/次 |
| 微信视频号 | 视频号作品互动数据 | GET /v1/wechat_channels/videos/metrics | 1 | $0.015/次 |
每次 $0.002 到 $0.02，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: Post
上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。
| 字段 | 类型 | 含义 |
|---|---|---|
id | string | 内容在平台上的 ID。 |
url | string | 内容链接。 |
type | string | 内容类型。 |
title | string | null | 标题（视频、笔记、文章才有）。 |
text | string | 文案、正文或简介，纯文本；文章为 Markdown。 |
lang | string | null | 语言代码，平台给出或检测得到。 |
published_at | string | null | 发布时间，ISO 8601，UTC；只有数据源不给时间时为 null（wechat_mp.articles.metrics、wechat_channels.videos.metrics、youtube.channels.videos.list 取 Shorts 时），并列在 meta.unavailable 里。 |
author | AccountRef | 发布者。 |
metrics | Metrics | 抓取时的数据；平台不公开的为 null。 |
images | string[] | null | 图文内容的图片地址。 |
hashtags | string[] | null | 话题标签，不带 #。 |
ext | object | 平台特有字段，只在 view=full 时返回。 |
两个平台上的同一个调用
参数一样、翻页方式一样、返回结构一样，只换路径。
# 抖音
curl -G "https://api.okdata.online/v1/douyin/videos/metrics" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=7706732036270132480'
# 微信公众号
curl -G "https://api.okdata.online/v1/wechat_mp/articles/metrics" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'url=https://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==&mid=2667044935&idx=1&sn=05212d520417484f4402bdad73f527ec'常见用途
- 投放结束后复查合作内容的数据。
- 跟踪一条内容发布后 48 小时内的增长速度。
- 把互动数字接进看板，不用存整条内容。
常见问题
- 内容详情接口不是已经带数据了吗？
- 是的。内容详情接口会在每条内容里带上抓取时的 metrics。上表里没有内容数据接口的平台，就用内容详情；这些平台拿不到单独的数据接口。
- 为什么要把数据单独拿？
- 有些平台的互动数字和内容本身不是同一个请求给的；而且只要数字的时候，返回越小越方便存储和对比。
- 数字是实时的吗？
- 是调用那一刻平台展示的数字。想画增长曲线，就把每次读到的数字连同时间存下来。