ZHEJIANG · TOURISM DATA
API文档
v1 草案 · REST接口尚未开放查询标准关键词、热度、舆情、审美、原文证据和人群画像的接口定义、请求参数与响应示例。
接口列表
规划前缀:/api/tourism/v1。响应示例取自当前数据,但这些路径尚未实现;文档不提供在线试调用。
GET/meta数据版本与覆盖尚未上线
获取当前数据版本、监测范围、各平台缺失项及可用日期。
无查询参数。
规划请求(尚不能调用)
GET /api/tourism/v1/meta
计划响应示例(取自当前数据快照)
{
"data": {
"component": "zhejiang-tourism-index",
"schema_version": "1.0-snapshot",
"analysis_date": "2026-10-08",
"data_as_of": "2026-10-07",
"data_url": "/components/travel-index/data-20261008-4ffc17c02dd3.json",
"data_sha256": "304be1fb1a2074571066ccb900c69ab7419e9e6485742613e7bfe6cc5beff1f0",
"api_status": "planned",
"api_documentation_url": "/travel-index-api.html",
"coverage": {
"keywords": 39,
"expressions": 85,
"posts": 667,
"comments": 5018,
"official_daily_keywords": 38,
"audience_source": "douyin",
"audience_keywords": 15
},
"industry_period": {
"start": "2026-09-26",
"end": "2026-10-04",
"available_days": 9
},
"source_validation_sha256": "8e90b52c9ca43dec968b66370eee5ca1a9679800a34ff5c64898cfdef963eddf",
"source_analysis_version": "2.0 category semantic agents"
},
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
}
}GET/keywords标准关键词列表尚未上线
列出39个标准关键词及85种表达的映射,可按品类筛选。
| 参数 | 位置 / 必填 | 类型 | 说明 |
|---|---|---|---|
| category | query / 否 | string | 文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街 |
| q | query / 否 | string | 搜索标准词或别名 |
| cursor | query / 否 | string | 上一页返回的不透明游标;首屏省略 |
| limit | query / 否 | integer | 分页条数,默认50,最多100 |
规划请求(尚不能调用)
GET /api/tourism/v1/keywords
计划响应示例(取自当前数据快照)
{
"data": [
{
"id": "o01",
"name": "千岛湖鱼头",
"category": "美食",
"aliases": [
"千岛湖鱼头",
"千岛湖鱼头汤"
],
"heat_snapshot": 46.866691779740826,
"heat_mask": "douyin+wechat+weibo+xiaohongshu",
"sentiment_score": 88.53244697689142,
"aesthetic_score": 100,
"post_n": 48,
"comment_n": 238
}
],
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
},
"pagination": {
"next_cursor": null,
"has_more": false
}
}GET/keywords/{keyword_id}关键词明细尚未上线
查询一个标准对象的热度快照、舆情、审美、文本样本量和平台覆盖。
| 参数 | 位置 / 必填 | 类型 | 说明 |
|---|---|---|---|
| keyword_id | path / 是 | string | 标准对象ID,例如o01 |
规划请求(尚不能调用)
GET /api/tourism/v1/keywords/{keyword_id}计划响应示例(取自当前数据快照)
{
"data": {
"id": "o01",
"name": "千岛湖鱼头",
"category": "美食",
"aliases": [
"千岛湖鱼头",
"千岛湖鱼头汤"
],
"heat_snapshot": 46.866691779740826,
"heat_mask": "douyin+wechat+weibo+xiaohongshu",
"sentiment_score": 88.53244697689142,
"aesthetic_score": 100,
"post_n": 48,
"comment_n": 238,
"sentiment": {
"score": 88.53244697689142,
"components": {
"douyin:post": {
"score": 95.83333333333333,
"post_n": 12,
"text_n": 12
},
"xiaohongshu:post": {
"score": 80,
"post_n": 10,
"text_n": 10
},
"weibo:post": {
"score": 84.61538461538461,
"post_n": 26,
"text_n": 26
},
"douyin:comment": {
"score": 91.66666666666667,
"post_n": 6,
"text_n": 9
},
"xiaohongshu:comment": {
"score": 93.76543209876543,
"post_n": 9,
"text_n": 66
},
"weibo:comment": {
"score": 82.37179487179488,
"post_n": 6,
"text_n": 32
}
},
"type_scores": {
"post": 86.81623931623932,
"comment": 89.26796454574233
},
"complete_types": true,
"sample_text_n": 155,
"sample_post_n": 48,
"low_sample": false,
"provisional": true
},
"aesthetic": {
"score": 100,
"components": {
"douyin:post": {
"score": 100,
"post_n": 2,
"text_n": 2
},
"xiaohongshu:post": {
"score": 100,
"post_n": 2,
"text_n": 2
},
"weibo:post": {
"score": 100,
"post_n": 4,
"text_n": 4
},
"douyin:comment": {
"score": 100,
"post_n": 1,
"text_n": 1
},
"xiaohongshu:comment": {
"score": 100,
"post_n": 2,
"text_n": 2
},
"weibo:comment": {
"score": 100,
"post_n": 2,
"text_n": 12
}
},
"type_scores": {
"post": 100,
"comment": 100
},
"complete_types": true,
"sample_text_n": 23,
"sample_post_n": 13,
"low_sample": false,
"provisional": true
}
},
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
}
}GET/heat/daily每日热度尚未上线
按总体、品类或关键词获取日值。计算标尺固定;Y轴缩放属于显示设置。
| 参数 | 位置 / 必填 | 类型 | 说明 |
|---|---|---|---|
| scope | query / 否 | string | 查询层级;可选:overall, category, keyword |
| keyword_ids | query / 否 | string | scope=keyword时提供,以逗号分隔,例如o01,o03 |
| category | query / 否 | string | 文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街 |
| platform | query / 否 | string | 综合日度或官方平台;微博当前暂缺;可选:combined, wechat, douyin, weibo |
| start_date | query / 否 | string | 开始日期,YYYY-MM-DD |
| end_date | query / 否 | string | 结束日期,YYYY-MM-DD |
规划请求(尚不能调用)
GET /api/tourism/v1/heat/daily
计划响应示例(取自当前数据快照)
{
"data": {
"scope": "overall",
"platform": "combined",
"points": [
{
"date": "2026-09-26",
"score": 45.03470104146567,
"rebased": 100
},
{
"date": "2026-09-27",
"score": 44.46850667604801,
"rebased": 98.74275980005655
},
{
"date": "2026-09-28",
"score": 43.76704852684506,
"rebased": 97.18516502762299
},
{
"date": "2026-09-29",
"score": 43.96950382842549,
"rebased": 97.6347190313101
},
{
"date": "2026-09-30",
"score": 44.67346908393533,
"rebased": 99.19788085814596
},
{
"date": "2026-10-01",
"score": 46.12099634270028,
"rebased": 102.4121294826281
},
{
"date": "2026-10-02",
"score": 46.5650193780763,
"rebased": 103.3980870333781
},
{
"date": "2026-10-03",
"score": 46.317896906134486,
"rebased": 102.84934913520868
},
{
"date": "2026-10-04",
"score": 45.79813762902637,
"rebased": 101.69521850907319
}
]
},
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
}
}GET/opinions/summary舆情与审美汇总尚未上线
返回一个关键词已计算的综合得分、分项、标签计数与少样本标记。综合分同时考虑正文与评论;label_counts另按label_counts_scope说明计数范围。
| 参数 | 位置 / 必填 | 类型 | 说明 |
|---|---|---|---|
| keyword_id | query / 是 | string | 标准关键词ID,例如o01;同义表达通过关键词列表映射 |
| metric | query / 否 | string | 选择舆情或审美;可选:sentiment, aesthetic |
规划请求(尚不能调用)
GET /api/tourism/v1/opinions/summary
计划响应示例(取自当前数据快照)
{
"data": {
"keyword_id": "o01",
"metric": "sentiment",
"score": 88.53244697689142,
"components": {
"douyin:post": {
"score": 95.83333333333333,
"post_n": 12,
"text_n": 12
},
"xiaohongshu:post": {
"score": 80,
"post_n": 10,
"text_n": 10
},
"weibo:post": {
"score": 84.61538461538461,
"post_n": 26,
"text_n": 26
},
"douyin:comment": {
"score": 91.66666666666667,
"post_n": 6,
"text_n": 9
},
"xiaohongshu:comment": {
"score": 93.76543209876543,
"post_n": 9,
"text_n": 66
},
"weibo:comment": {
"score": 82.37179487179488,
"post_n": 6,
"text_n": 32
}
},
"type_scores": {
"post": 86.81623931623932,
"comment": 89.26796454574233
},
"complete_types": true,
"sample_text_n": 155,
"sample_post_n": 48,
"low_sample": false,
"provisional": true,
"label_counts": {
"excluded": 55,
"positive": 84,
"unknown": 76,
"neutral": 18,
"negative": 3,
"mixed": 2
},
"label_counts_scope": "comment"
},
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
}
}GET/aspects品类维度与方面情感尚未上线
返回该品类发现的完整维度字典;若提供keyword_id,同时返回对应关键词的方面统计。
| 参数 | 位置 / 必填 | 类型 | 说明 |
|---|---|---|---|
| category | query / 是 | string | 文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街 |
| keyword_id | query / 否 | string | 标准关键词ID,例如o01;同义表达通过关键词列表映射 |
| aesthetic_only | query / 否 | boolean | 仅返回审美维度 |
规划请求(尚不能调用)
GET /api/tourism/v1/aspects
计划响应示例(取自当前数据快照)
{
"data": {
"category": "美食",
"keyword_id": "o01",
"dimensions": [
{
"dimension_id": "f01",
"category": "美食",
"name": "味道与调味",
"definition": "标准食物的鲜香、甜咸辣酸、腥味、油腻感、汤汁风味及总体好吃程度;不包含别道菜的评价。",
"aesthetic": false,
"mentioned_text_n": 97,
"polarity_counts": {
"positive": 90,
"negative": 3,
"neutral": 3,
"mixed": 1
},
"score": 94.84536082474227
},
{
"dimension_id": "f02",
"category": "美食",
"name": "口感与质地",
"definition": "食物软糯、脆酥、嫩滑、肥瘦、皮馅厚薄和嚼感等入口质地。",
"aesthetic": false,
"mentioned_text_n": 22,
"polarity_counts": {
"positive": 22,
"negative": 0,
"neutral": 0,
"mixed": 0
},
"score": 100
},
{
"dimension_id": "f03",
"category": "美食",
"name": "食材新鲜与品质",
"definition": "原料鲜活、选材、肉膏饱满、有机/品质主张及加工后品质;只记录原文主张,不核实来源事实。",
"aesthetic": false,
"mentioned_text_n": 11,
"polarity_counts": {
"positive": 11,
"negative": 0,
"neutral": 0,
"mixed": 0
},
"score": 100
},
{
"dimension_id": "f04",
"category": "美食",
"name": "正宗传承与家乡记忆",
"definition": "地域风味是否正宗、手工传统与工业化差异、童年家乡味和节俗关联。",
"aesthetic": false,
"mentioned_text_n": 2,
"polarity_counts": {
"positive": 1,
"negative": 0,
"neutral": 1,
"mixed": 0
},
"score": 75
},
{
"dimension_id": "f05",
"category": "美食",
"name": "价格与性价比",
"definition": "标准食物售价、优惠、贵便宜与价值感;不将整座城市物价直接归给食物。",
"aesthetic": false,
"mentioned_text_n": 7,
"polarity_counts": {
"positive": 5,
"negative": 1,
"neutral": 1,
"mixed": 0
},
"score": 78.57142857142857
},
{
"dimension_id": "f06",
"category": "美食",
"name": "份量与规格",
"definition": "标准食物个头、数量、肉量、分量及是否足够吃;只谈大小不自动正负。",
"aesthetic": false,
"mentioned_text_n": 10,
"polarity_counts": {
"positive": 10,
"negative": 0,
"neutral": 0,
"mixed": 0
},
"score": 100
},
{
"dimension_id": "f07",
"category": "美食",
"name": "制作方法与便利性",
"definition": "烹饪、手工包制、调料处理、速食加热、制作难易和食用方法;厨师人物赞美不算食物评价。",
"aesthetic": false,
"mentioned_text_n": 1,
"polarity_counts": {
"positive": 0,
"negative": 0,
"neutral": 1,
"mixed": 0
},
"score": 50
},
{
"dimension_id": "f08",
"category": "美食",
"name": "保存运输与鲜活保持",
"definition": "冷藏暂养、死亡损耗、到货状态、包装说明、外送保温等保存运输体验与建议。",
"aesthetic": false,
"mentioned_text_n": 0,
"polarity_counts": {
"positive": 0,
"negative": 0,
"neutral": 0,
"mixed": 0
},
"score": null
},
{
"dimension_id": "f09",
"category": "美食",
"name": "食品安全与健康适配",
"definition": "食用不适、腐败与卫生担忧、添加剂、消化/减脂适配及安全提醒;UGC健康说法未经核实。",
"aesthetic": false,
"mentioned_text_n": 1,
"polarity_counts": {
"positive": 0,
"negative": 1,
"neutral": 0,
"mixed": 0
},
"score": 0
},
{
"dimension_id": "f10",
"category": "美食",
"name": "食物色泽与视觉食欲",
"definition": "食物汤色、色泽搭配与外观引发的食欲;只谈人物、摄影技术或餐厅装修的评价排除。",
"aesthetic": true,
"mentioned_text_n": 30,
"polarity_counts": {
"positive": 22,
"negative": 0,
"neutral": 8,
"mixed": 0
},
"score": 86.66666666666667
},
{
"dimension_id": "f11",
"category": "美食",
"name": "造型摆盘与精致感",
"definition": "食物外形、完整度、褶纹、陈列摆盘及精致观感;不是餐厅建筑或家具审美。",
"aesthetic": true,
"mentioned_text_n": 4,
"polarity_counts": {
"positive": 4,
"negative": 0,
"neutral": 0,
"mixed": 0
},
"score": 100
},
{
"dimension_id": "f12",
"category": "美食",
"name": "食用意愿与接受度",
"definition": "想吃、回购、偏爱或拒绝、不敢尝试、食用心理和伦理接受度;没有明确偏好的未尝过为中性。",
"aesthetic": false,
"mentioned_text_n": 12,
"polarity_counts": {
"positive": 8,
"negative": 0,
"neutral": 4,
"mixed": 0
},
"score": 83.33333333333333
},
{
"dimension_id": "f13",
"category": "美食",
"name": "购买渠道与获得便利",
"definition": "标准食物哪里能买、店名地址、配送、真空包装、供货可得与购买方便性;城市旅游交通排除。",
"aesthetic": false,
"mentioned_text_n": 17,
"polarity_counts": {
"positive": 1,
"negative": 1,
"neutral": 15,
"mixed": 0
},
"score": 50
},
{
"dimension_id": "f14",
"category": "美食",
"name": "宣传与推荐可信度",
"definition": "针对标准食物推荐、排名、广告水军或体验落差的可信度评价;仅骂作者分析或拍摄不算食物评价。",
"aesthetic": false,
"mentioned_text_n": 6,
"polarity_counts": {
"positive": 2,
"negative": 4,
"neutral": 0,
"mixed": 0
},
"score": 33.333333333333336
}
]
},
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
}
}GET/evidence原文与方面证据尚未上线
查询帖子正文及一级评论的方面证据,保留来源和父帖关联;多维度会返回同一文本的多个证据片段。
| 参数 | 位置 / 必填 | 类型 | 说明 |
|---|---|---|---|
| keyword_id | query / 否 | string | 标准关键词ID,例如o01;同义表达通过关键词列表映射 |
| category | query / 否 | string | 文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街 |
| dimension_id | query / 否 | string | 必须结合品类使用该品类维度ID |
| label | query / 否 | string | 方面情感标签;可选:positive, negative, neutral, mixed, unknown, excluded |
| platform | query / 否 | string | 原文平台;可选:douyin, xiaohongshu, weibo |
| cursor | query / 否 | string | 上一页返回的不透明游标;首屏省略 |
| limit | query / 否 | integer | 分页条数,默认50,最多100 |
规划请求(尚不能调用)
GET /api/tourism/v1/evidence
计划响应示例(取自当前数据快照)
{
"data": [
{
"fragment_id": "food:1:0",
"document_id": "douyin:7687905924250354097:post:o06",
"post_key": "douyin:7687905924250354097",
"object": "杭州东坡肉",
"category": "美食",
"platform": "douyin",
"kind": "post",
"dimension_id": "f01",
"aspect": "味道与调味",
"aesthetic": false,
"label": "positive",
"quote": "东坡肉香拽了",
"date_raw": "9月21日",
"url": "https://www.douyin.com/video/7687905924250354097",
"analysis_method": "subagent_semantic",
"reason": "",
"text": "西湖边好吃好玩的创意杭帮菜,酥皮番茄牛腩和东坡肉香拽了!#杭帮菜 #杭州美食 #杭州旅游 #烟火气小店 #东坡肉",
"truncated": false
}
],
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
},
"pagination": {
"next_cursor": null,
"has_more": false
}
}GET/audience人群画像尚未上线
按标准关键词返回各实际查询表达的人群画像。当前仅有抖音画像,不平均或累加别名占比。
| 参数 | 位置 / 必填 | 类型 | 说明 |
|---|---|---|---|
| keyword_id | query / 是 | string | 标准关键词ID,例如o01;同义表达通过关键词列表映射 |
| platform | query / 否 | string | 画像来源;尚无数据的平台返回availability=pending;可选:douyin, wechat, xiaohongshu, weibo |
| query | query / 否 | string | 可选:限定实际查询表达;省略则返回该标准关键词所有画像 |
规划请求(尚不能调用)
GET /api/tourism/v1/audience
计划响应示例(取自当前数据快照)
{
"data": {
"keyword_id": "o01",
"availability": "available",
"profiles": [
{
"platform": "douyin",
"category": "美食",
"object": "千岛湖鱼头",
"query": "千岛湖鱼头",
"returned_keyword": "千岛湖鱼头",
"relationship": "原词",
"period_start": "2026-09-20",
"period_end": "2026-09-29",
"captured_date": "2026-10-01",
"scope_note": "",
"distributions": {
"gender": [
{
"name": "男性",
"share_percent": 58,
"share_raw": "58%",
"tgi": 121,
"tgi_raw": "121",
"order": 1
},
{
"name": "女性",
"share_percent": 42,
"share_raw": "42%",
"tgi": 81,
"tgi_raw": "81",
"order": 2
}
],
"age": [
{
"name": "18-23岁",
"share_percent": 9.81,
"share_raw": "9.81%",
"tgi": 86.82,
"tgi_raw": "86.82",
"order": 1
},
{
"name": "24-30岁",
"share_percent": 16.29,
"share_raw": "16.29%",
"tgi": 126.73,
"tgi_raw": "126.73",
"order": 2
},
{
"name": "31-40岁",
"share_percent": 31.14,
"share_raw": "31.14%",
"tgi": 96.04,
"tgi_raw": "96.04",
"order": 3
},
{
"name": "41-50岁",
"share_percent": 19.81,
"share_raw": "19.81%",
"tgi": 90.5,
"tgi_raw": "90.50",
"order": 4
},
{
"name": "51岁+",
"share_percent": 22.95,
"share_raw": "22.95%",
"tgi": 106.57,
"tgi_raw": "106.57",
"order": 5
}
],
"city": [
{
"name": "杭州",
"share_percent": 23.49,
"share_raw": "23.49%",
"tgi": 1735,
"tgi_raw": "1735.00",
"order": 1
},
{
"name": "上海",
"share_percent": 16.27,
"share_raw": "16.27%",
"tgi": 833,
"tgi_raw": "833.00",
"order": 2
},
{
"name": "金华",
"share_percent": 2.88,
"share_raw": "2.88%",
"tgi": 337,
"tgi_raw": "337.00",
"order": 3
},
{
"name": "苏州",
"share_percent": 2.67,
"share_raw": "2.67%",
"tgi": 163,
"tgi_raw": "163.00",
"order": 4
},
{
"name": "宁波",
"share_percent": 2.55,
"share_raw": "2.55%",
"tgi": 270,
"tgi_raw": "270.00",
"order": 5
}
],
"interest": [
{
"name": "时尚",
"share_percent": 17.62,
"share_raw": "17.62%",
"tgi": 127.17,
"tgi_raw": "127.17",
"order": 1
},
{
"name": "美食",
"share_percent": 11.87,
"share_raw": "11.87%",
"tgi": 132.07,
"tgi_raw": "132.07",
"order": 2
},
{
"name": "旅行",
"share_percent": 6.16,
"share_raw": "6.16%",
"tgi": 171.47,
"tgi_raw": "171.47",
"order": 3
},
{
"name": "文化教育",
"share_percent": 5.77,
"share_raw": "5.77%",
"tgi": 100.66,
"tgi_raw": "100.66",
"order": 4
},
{
"name": "运动",
"share_percent": 5.73,
"share_raw": "5.73%",
"tgi": 168.23,
"tgi_raw": "168.23",
"order": 5
}
]
}
}
]
},
"meta": {
"schema_version": "1.0-draft",
"data_as_of": "2026-10-07",
"analysis_date": "2026-10-08",
"provisional": true
}
}没有匹配的计划接口
字段结构
以下结构用于上方接口的响应数据。标准关键词使用id关联,方面证据使用dimension_id关联对应品类的维度。
Keyword字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| id | string | 标准对象ID;当前为o01至o39 |
| name | string | 见响应示例 |
| category | string | 美食、住宿、景区、商业街 |
| aliases | array | 见响应示例 |
| heat_snapshot | number / null | 见响应示例 |
| heat_mask | string | 参与快照的平台组合;不同组合不直接排名 |
| sentiment_score | number / null | 见响应示例 |
| aesthetic_score | number / null | 见响应示例 |
| post_n | integer | 见响应示例 |
| comment_n | integer | 见响应示例 |
HeatPoint字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| date | string | 见响应示例 |
| score | number / null | 0—100,暂缺为null |
| rebased | number / null | 首日=100的重设基准值,只用于综合总体走势;数值可超过100 |
| missing_reason | string / null | 见响应示例 |
OpinionSummary字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| score | number / null | 0—100,暂缺为null |
| label_counts | object | 见响应示例 |
| sample_text_n | integer | 见响应示例 |
| sample_post_n | integer | 见响应示例 |
| low_sample | boolean | 见响应示例 |
| complete_types | boolean | 有效正文与评论是否同时覆盖 |
| components | object | 按平台和文本类型保留分值、文本数、帖子数 |
Dimension字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| dimension_id | string | 见响应示例 |
| category | string | 美食、住宿、景区、商业街 |
| name | string | 见响应示例 |
| definition | string | 见响应示例 |
| aesthetic | boolean | 是否为审美维度 |
| mentioned_text_n | integer | 见响应示例 |
| polarity_counts | object | 见响应示例 |
| score | number / null | 0—100,暂缺为null |
Evidence字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| document_id | string | 不透明对象×文本ID,不应自行拆分 |
| post_key | string | 父帖关联键 |
| object | string | 见响应示例 |
| category | string | 美食、住宿、景区、商业街 |
| platform | string | douyin、xiaohongshu、weibo |
| kind | string | post、comment |
| dimension_id | string | 见响应示例 |
| aspect | string | 见响应示例 |
| aesthetic | boolean | 是否为审美维度 |
| quote | string | 原文连续片段 |
| text | string | 采集到的完整可见文本,可能有截断 |
| label | string | positive、negative、neutral、mixed、unknown、excluded |
| date_raw | string / null | 来源显示的原始时间,不保证可解析成日期 |
| url | string / null | 见响应示例 |
| truncated | boolean | 见响应示例 |
AudienceRow字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| name | string | 见响应示例 |
| share_percent | number | 见响应示例 |
| share_raw | string | 含百分号的原报占比,保留显示精度 |
| tgi | number | 平台原报TGI,允许大于100,不是人数 |
| tgi_raw | string | 见响应示例 |
| order | integer | 见响应示例 |
AudienceProfile字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| platform | string | douyin、wechat、xiaohongshu、weibo |
| object | string | 见响应示例 |
| category | string | 美食、住宿、景区、商业街 |
| query | string | 见响应示例 |
| returned_keyword | string | 见响应示例 |
| relationship | string | 见响应示例 |
| period_start | string | 见响应示例 |
| period_end | string | 见响应示例 |
| captured_date | string | 见响应示例 |
| scope_note | string | 见响应示例 |
| distributions | object | 见响应示例 |
ResponseMeta字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| schema_version | string | 见响应示例 |
| data_as_of | string | 见响应示例 |
| analysis_date | string | 见响应示例 |
| provisional | boolean | 见响应示例 |
Pagination字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| next_cursor | string / null | 见响应示例 |
| has_more | boolean | 见响应示例 |
HeatSeries字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| scope | string | overall、category、keyword |
| platform | string | combined、wechat、douyin、weibo |
| keyword_id | string | 见响应示例 |
| category | string | 美食、住宿、景区、商业街 |
| points | array | 见响应示例 |
AspectResponse字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| category | string | 美食、住宿、景区、商业街 |
| keyword_id | string / null | 见响应示例 |
| dimensions | array | 见响应示例 |
AudienceResponse字段结构
| 字段 | 类型 | 含义 |
|---|---|---|
| keyword_id | string | 见响应示例 |
| availability | string | available、pending、no_data |
| profiles | array | 见响应示例 |
指标与文本分析口径
- 不同表达映射到文档中的39个标准关键词。微信、抖音的原始指数经ln(1+x)、冻结基准中位数/IQR与logistic映射到0—100;同一平台内固定别名集合等权归并。
- 关键词日度取固定可用平台平均,品类取固定对象面板平均,总体按平台流量赋权。当前联合总体日度为2026-09-26至2026-10-04,9个真实日期。图表Y轴缩放不会改变接口日值。
- 文本分析同时包含帖子正文和一级评论。先按品类发现评价及审美维度,再由子agent结合父帖语境逐条做语义解析。当前共5690条对象×原文记录,原生ID去重后为667篇帖子、5018条一级评论。
- 关键词综合分使用正文30%与评论70%;评论先在帖子内平均,再在平台内平均,再跨平台平均。缺一种有效文本类型时只使用已有类型,并通过complete_types=false标注。情感分布是原文标签计数,与层级加权分值分别解释。
- 正向100、负向0、中性与混合50;证据不足与无关文本保留但不计分。审美得分只使用明确审美评价,单纯描述不默认得分。审美关注率以有效评论为分母,另包含描述性审美提及。
- 小红书与微博互动代理为累计快照试算,不反推历史每日新增互动。不同平台组合或采集窗口的快照不直接排名。微博官方指数当前暂缺,后续补充。
- 少于20条评价或涉及少于5个帖子标少样本。逐条语义解析尚未经过独立人工准确率验证,provisional=true表示当前试算口径。
人群画像的范围
当前画像实际来自抖音创作者中心,覆盖15个标准关键词、21种查询表达。统计期为2026-09-20至2026-09-29,采集于2026-10-01(日本时间)。微信及其他平台画像待补充。
- 仅展示城市,不含省份或城市级别;城市与兴趣最多前5项。年龄按页面从左到右前5组保留,性别为平台原报两组。
- 占比是区间快照,不拆成每日画像;前5项不重新归一化到100%。TGI允许大于100,不能当作人数。
- 缺少人群基数和跨查询用户去重信息,不平均或相加同义表达画像,不构造品类总体画像。范围较宽、同名地点或机构通过scope_note说明。
缺失、日期与分页
| 约定 | 处理方式 |
|---|---|
| 缺失数值 | 返回null与原因,不用0替代;官方指数未收录与真实零值区分 |
| 缺失日期 | 日度序列仅返回实际观测日期,前端保留断点;当前并非所有平台都有相同窗口 |
| 时间 | 日值以平台统计日标记;date_raw保留原始时间,不能统一可靠解析的评论不生成历史每日曲线 |
| 分页(计划) | cursor是不透明游标,limit默认50、最多100;响应提供next_cursor与has_more |
| 原文多重关联 | 同一文本可映射多个对象并包含多个维度;总体去重样本数不能由对象计数简单相加 |
| 鉴权与限流(计划) | 尚未实现或确定;正式接口上线时发布要求,不在当前页面发放API密钥 |
| 更新状态 | 当前是固定版本的数据快照;后续新采集数据经校验后发布新版本,更新时间以meta为准 |
API文档版本:1.0.0-draft · 分析版本:2.0 category semantic agents · 本页不创建或模拟任何REST接口。