本文档介绍内容洞察数据点查接口的调用方式
支持客户通过抖音内容ID，获取洞察侧关于该条抖音发文的所有内容字段。字段明细详见数据格式--内容洞察平台-火山引擎
备注：
- 接口调用前置操作，详见：调用指南--内容洞察平台-火山引擎
- 该接口查询会产生计量计费，请谨慎使用。
| 名称 | 内容 |
|---|---|
| 接口地址 | /openapi/item/query_by_id |
| 请求方式 | GET |
| 是否需要鉴权 | 是 |
| QPS限制 | 150 |
Hearder请求参数
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| X-Insight-Biz-Name | string | 是 | 业务名称，见「数据流管理」-API配置-「账号ID」 |
| X-Insight-Access-Token | string | 是 | 访问凭证，获取方式调用指南--内容洞察平台-火山引擎 |
| Content-Type | string | 是 | 'application/json' |
Query请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| origin_id | string | 是 | 抖音原始ID，可在抖音url中获取 |
| 参数 | 类型 | 描述 | |
|---|---|---|---|
| data | object | 发文信息数据，详见： 数据格式--内容洞察平台-火山引擎 | |
| message | string | 错误信息，成功不会返回 | |
| status | int | 状态码 | |
请求示例
REQ: GET /openapi/item/query_by_id?origin_id=<xxx> header: X-Insight-Biz-Name: $biz_name X-Insight-Access-Token: $token Content-Type: 'application/json'
返回示例
{ "data": { "anchor": { "filter_status": false }, "based_location": { "public_location": { "city": "", "city_code": "", "city_geo_id": 0, "district": "", "district_code": "", "district_geo_id": 0, "location": "中华人民共和国北京市", "province": "北京市", "province_code": "11", "province_geo_id": 2038349, "region": "中华人民共和国", "region_code": "CN", "region_geo_id": 1814991, "town": "", "town_code": "", "town_geo_id": 0 } }, "consume_time": "2024-05-21 14:07:48", "create_time": "2024-05-21 13:46:47", "domain": "www.douyin.com", "feature": { "asr": "顾源的沙尘暴，真烦人。顾源的沙尘暴，真烦人。", "event_id": "", "event_name": "", "is_sensitive": false, "kg_entity_link": [ { "block_infos": [ { "block_risk_score": 0.000016570091247558594, "entity_risk_scene": [ "其他" ], "entity_sentiment": 2, "hit_mentions": [ "顾源" ], "text": "顾源的沙尘暴，真烦人。顾源的沙尘暴，真烦人。" } ], "entity_score": 0.9689809679985046, "entity_type": "人物/账号", "hit_entity": "顾源", "hit_fileds": [ "4" ], "hit_mentions": [ "顾源" ], "kg_id": "", "related_score": 0, "risk_binary_score": 0.000016570091247558594, "risk_scene": [ "其他" ], "sentiment": 2 } ], "label_tags": null, "match_count": 1, "match_id": "", "ocr": "", "ocr_details": [], "ocr_high": "", "risk_scene": {}, "sentiment": 2, "tags": [ "owls_snapshot" ] }, "first_public_time": "2024-05-21 13:46:47", "is_ad": 0, "main_domain": "douyin.com", "origin_id": "7371325110785019146", "poi": { "poi_location": { "city": "", "city_code": "", "city_geo_id": 0, "district": "", "district_code": "", "district_geo_id": 0, "location": "", "province": "", "province_code": "", "province_geo_id": 0, "region": "", "region_code": "", "region_geo_id": 0, "town": "", "town_code": "", "town_geo_id": 0 } }, "post_id": "15681942168282736115", "post_type": 10, "publish_time": "2024-05-21 13:46:28", "push_ready_time": "2024-05-21 13:46:54", "status": 1, "update_category": "algorithm_update", "update_time": "2024-05-21 13:46:47", "url": "https://www.douyin.com/share/video/7371325110785019146", "video_info": { "cover_info": { "cover_ocr": "", "cover_ocr_details": [], "online_url": "https://p6-dy-ipv6.byteimg.com/obj/tos-cn-p-0015/ooIAANIZinPgkIiMPdgA1vP1yAiuLB2Nw1Q6T" }, "duration": 8.328 } }, "message": "succeed", "status": 0 }
说明
QPS限制：200
可查询时间范围：近90天内的发文
部分数据无法查询，无法查询的数据类型，及对应的内容提示如下：
输入错的内容ID：origin_id does not exists。即“发文不存在”
发文已删除或非洞察数据源：post is filtered。即“已过滤”
发文发布时间距今超过90天：only support post in 90 days。即无法提供90天以外的发文查询
以上未能提供的数据，点查均不收费
已合作/正在测试中客户，若对此接口有调用需求，请联系洞察同学后台开通接口权限，生效时间约2小时；若是首次对接的新客户，均会默认开通
计量价格：调用一篇发文即计算一篇的费用，价格为合同中的计费项单价
查询不去重：若客户重复点查同一个origin ID并返回内容字段，则重复计费