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种表达的映射,可按品类筛选。

参数位置 / 必填类型说明
categoryquery / 否string文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街
qquery / 否string搜索标准词或别名
cursorquery / 否string上一页返回的不透明游标;首屏省略
limitquery / 否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_idpath / 是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轴缩放属于显示设置。

参数位置 / 必填类型说明
scopequery / 否string查询层级;可选:overall, category, keyword
keyword_idsquery / 否stringscope=keyword时提供,以逗号分隔,例如o01,o03
categoryquery / 否string文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街
platformquery / 否string综合日度或官方平台;微博当前暂缺;可选:combined, wechat, douyin, weibo
start_datequery / 否string开始日期,YYYY-MM-DD
end_datequery / 否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_idquery / 是string标准关键词ID,例如o01;同义表达通过关键词列表映射
metricquery / 否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,同时返回对应关键词的方面统计。

参数位置 / 必填类型说明
categoryquery / 是string文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街
keyword_idquery / 否string标准关键词ID,例如o01;同义表达通过关键词列表映射
aesthetic_onlyquery / 否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_idquery / 否string标准关键词ID,例如o01;同义表达通过关键词列表映射
categoryquery / 否string文档中的四类产品之一;可选:美食, 住宿, 景区, 商业街
dimension_idquery / 否string必须结合品类使用该品类维度ID
labelquery / 否string方面情感标签;可选:positive, negative, neutral, mixed, unknown, excluded
platformquery / 否string原文平台;可选:douyin, xiaohongshu, weibo
cursorquery / 否string上一页返回的不透明游标;首屏省略
limitquery / 否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_idquery / 是string标准关键词ID,例如o01;同义表达通过关键词列表映射
platformquery / 否string画像来源;尚无数据的平台返回availability=pending;可选:douyin, wechat, xiaohongshu, weibo
queryquery / 否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字段结构
字段类型含义
idstring标准对象ID;当前为o01至o39
namestring见响应示例
categorystring美食、住宿、景区、商业街
aliasesarray见响应示例
heat_snapshotnumber / null见响应示例
heat_maskstring参与快照的平台组合;不同组合不直接排名
sentiment_scorenumber / null见响应示例
aesthetic_scorenumber / null见响应示例
post_ninteger见响应示例
comment_ninteger见响应示例
HeatPoint字段结构
字段类型含义
datestring见响应示例
scorenumber / null0—100,暂缺为null
rebasednumber / null首日=100的重设基准值,只用于综合总体走势;数值可超过100
missing_reasonstring / null见响应示例
OpinionSummary字段结构
字段类型含义
scorenumber / null0—100,暂缺为null
label_countsobject见响应示例
sample_text_ninteger见响应示例
sample_post_ninteger见响应示例
low_sampleboolean见响应示例
complete_typesboolean有效正文与评论是否同时覆盖
componentsobject按平台和文本类型保留分值、文本数、帖子数
Dimension字段结构
字段类型含义
dimension_idstring见响应示例
categorystring美食、住宿、景区、商业街
namestring见响应示例
definitionstring见响应示例
aestheticboolean是否为审美维度
mentioned_text_ninteger见响应示例
polarity_countsobject见响应示例
scorenumber / null0—100,暂缺为null
Evidence字段结构
字段类型含义
document_idstring不透明对象×文本ID,不应自行拆分
post_keystring父帖关联键
objectstring见响应示例
categorystring美食、住宿、景区、商业街
platformstringdouyin、xiaohongshu、weibo
kindstringpost、comment
dimension_idstring见响应示例
aspectstring见响应示例
aestheticboolean是否为审美维度
quotestring原文连续片段
textstring采集到的完整可见文本,可能有截断
labelstringpositive、negative、neutral、mixed、unknown、excluded
date_rawstring / null来源显示的原始时间,不保证可解析成日期
urlstring / null见响应示例
truncatedboolean见响应示例
AudienceRow字段结构
字段类型含义
namestring见响应示例
share_percentnumber见响应示例
share_rawstring含百分号的原报占比,保留显示精度
tginumber平台原报TGI,允许大于100,不是人数
tgi_rawstring见响应示例
orderinteger见响应示例
AudienceProfile字段结构
字段类型含义
platformstringdouyin、wechat、xiaohongshu、weibo
objectstring见响应示例
categorystring美食、住宿、景区、商业街
querystring见响应示例
returned_keywordstring见响应示例
relationshipstring见响应示例
period_startstring见响应示例
period_endstring见响应示例
captured_datestring见响应示例
scope_notestring见响应示例
distributionsobject见响应示例
ResponseMeta字段结构
字段类型含义
schema_versionstring见响应示例
data_as_ofstring见响应示例
analysis_datestring见响应示例
provisionalboolean见响应示例
Pagination字段结构
字段类型含义
next_cursorstring / null见响应示例
has_moreboolean见响应示例
HeatSeries字段结构
字段类型含义
scopestringoverall、category、keyword
platformstringcombined、wechat、douyin、weibo
keyword_idstring见响应示例
categorystring美食、住宿、景区、商业街
pointsarray见响应示例
AspectResponse字段结构
字段类型含义
categorystring美食、住宿、景区、商业街
keyword_idstring / null见响应示例
dimensionsarray见响应示例
AudienceResponse字段结构
字段类型含义
keyword_idstring见响应示例
availabilitystringavailable、pending、no_data
profilesarray见响应示例

指标与文本分析口径

人群画像的范围

当前画像实际来自抖音创作者中心,覆盖15个标准关键词、21种查询表达。统计期为2026-09-20至2026-09-29,采集于2026-10-01(日本时间)。微信及其他平台画像待补充。

缺失、日期与分页

约定处理方式
缺失数值返回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接口。