首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >「内容审计」接口功能详解|数据鱼API

「内容审计」接口功能详解|数据鱼API

原创
作者头像
用户12862874
发布于 2026-11-20 21:57:08
发布于 2026-11-20 21:57:08
100
举报

接口简介

「内容审计」(content-audit)是数据鱼API平台提供的内容运营量化接口,Base 路径 /api/content-audit,共 3 个端点。它面向已发布内容的存量维护场景,提供两个独立的小型计算能力:一是内容衰退分析(decay),按内容距上次更新的天数与流量变化幅度计算衰退指数,并给出需要采取的动作建议与优先级;二是词汇独特性分析(uniqueness),对一段文本统计总词数、去重词数与词汇多样性比率,给出重复度提示。

衰退指数的口径:decay_index = (距上次更新天数 / 365) × (1 − 流量变化百分比 / 100),结果保留两位小数。流量增长会压低指数、流量下滑会放大指数;指数大于 0.8 建议立即更新(Refresh Immediately,优先级 1),大于 0.5 建议规划更新(Plan Update,优先级 2),否则视为健康(Healthy,优先级 3)。

独特性分析的口径:按空格分词统计英文词汇,比率低于 0.4 判定为重复内容(Repetitive content),否则提示多样性良好(Good diversity)。接口为纯本地计算,无数据库与外部上游依赖,与其他数据鱼API接口共用统一 JSON 响应信封,适合批量嵌入内容巡检脚本。

端点总览

方法

路径

说明

鉴权

GET

/api/content-audit/ping

健康检查,返回 status ok

免鉴权

GET

/api/content-audit/decay

内容衰退指数与更新建议

是

POST

/api/content-audit/uniqueness

文本词汇独特性与多样性分析

是

通用约定

  • 鉴权:decay 与 uniqueness 需携带 API Key,通过 X-API-Key 请求头或 ?api_key= 查询参数传递;缺失返回 4011,无效返回 4013。
  • 响应结构:统一 {"code": 0, "msg": "success", "data": {...}};参数可放 JSON body、表单或 query,参数名一致。
  • 错误口径:文本为空(或统计不到任何词)时 uniqueness 返回业务码 4002(msg:参数或输入不合法: Empty text),而不是 4001。
  • 全站通用错误码(4011/4013 等)口径与数据鱼API其他接口一致。

核心端点详解

健康检查 ping

返回 status ok,用于存活探测。

代码语言:javascript
复制
GET /api/content-audit/ping
代码语言:javascript
复制
{"code": 0, "msg": "success", "data": {"status": "ok"}}

内容衰退分析 decay

按更新时间与流量变化计算衰退指数与处理优先级。

参数

类型

必填

默认

说明

days

int

否

0

距上次更新的天数

traffic_change

number

否

0

流量变化百分比,负数表示下滑,如 -10

返回字段:days_since_update(回显天数)、traffic_trend(格式化百分比字符串,如 -10%)、decay_index(衰退指数)、action_needed(Refresh Immediately / Plan Update / Healthy)、priority(1/2/3,数字越小越紧急)。实测 days=400、traffic_change=-10 时指数为 1.21,判定 Refresh Immediately、优先级 1。参数缺省时按 0 天、0% 流量变化计算,得指数 0、Healthy。

代码语言:javascript
复制
GET /api/content-audit/decay?days=400&traffic_change=-10

词汇独特性 uniqueness

对文本做分词统计与多样性比率计算。

参数

类型

必填

默认

说明

text

string

否

—

待分析文本;为空或统计不到词汇时返回 4002

返回字段:total_words(总词数)、unique_words(去重词数)、lexical_diversity(多样性百分比字符串)、quality_hint(低于 0.4 为 Repetitive content,否则 Good diversity)。实测文本统计得 11 词、去重 8 词,多样性 72.73%:

代码语言:javascript
复制
POST /api/content-audit/uniqueness
Content-Type: application/json

{"text": "the quick brown fox jumps over the lazy dog the fox"}

数据与限制

  • 输入无长度上限声明,长文本建议截取代表性段落;decay 的两个参数均可省略,省略按 0 处理。
  • 衰退指数理论区间随输入浮动:负流量会放大指数超过 1,属正常输出而非异常值。
  • 分词按拉丁词规则执行,大小写会被归一化后统计(The 与 the 计为同词)。
  • 纯本地计算,无缓存策略,重复调用同一输入结果一致。

典型使用场景

  • 内容存量巡检:定时拉取站点文章的最后更新时间与流量环比,批量调用 decay 生成「需要刷新」的优先级清单。
  • 编辑侧自检:发布前对正文调用 uniqueness,多样性过低时提示作者扩写或改写,减少同词堆叠。
  • 内容运营看板:把 decay 的 action_needed 与 priority 直接映射为看板状态列,驱动月度更新计划。

注意事项

  • uniqueness 的分词仅支持英文口径:中文等不按空格分词的文本统计结果为 0 词,实测直接返回 4002(Empty text)而非全 0 统计,接入中文内容前需自行分词或仅传英文片段。
  • text 参数在参数表中标注为非必填,但缺省即空文本,同样触发 4002;实际上该端点必须传入有效英文文本才有意义。
  • decay 的流量变化按整数/小数百分比传入(如 -10 代表下滑 10%),接口不做数据源拉取,days 与 traffic_change 均由调用方自备,口径不一致会导致指数失真。
  • 衰退指数与多样性比率为启发式量化参考,不能等同于搜索引擎对内容质量的实际评价;建议与真实流量、转化数据结合解读,避免单一指标驱动决策。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 接口简介
  • 端点总览
  • 通用约定
  • 核心端点详解
    • 健康检查 ping
    • 内容衰退分析 decay
    • 词汇独特性 uniqueness
  • 数据与限制
  • 典型使用场景
  • 注意事项
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档