小红书蒲公英关联词 API
按一个关键词取小红书用户搜它之前和之后还会搜的词(蒲公英),各带相关度名次、搜索指数、相关笔记数和阅读数,用来拓词选题。搜索指数是平台算出的指数,不是搜索次数;平台不给数的词,这几项为 null。每次约 98 条,最多 120 条;$0.0400 一次。出错和超时不收费;空结果收 $0.0400。
curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/keywords/related" \ --data-urlencode "keyword=面膜" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
{
"code": "ok",
"request_id": "14b8ced1-2b33-47f6-90f7-86463f68684e",
"data": {
"items": [
{
"keyword": "烧烤",
"related_to": "露营",
"relation": "prior",
"rank": 1,
"search_index": 2638774
},
// … 另有 97 条
]
},
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 98
},
"warnings": [],
"meta": {
"capability": "xiaohongshu.pgy.keywords.related",
"result_status": "complete",
"fetched_at": "2026-10-12T21:42:15.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"relevance": "platform",
"composite_index": "platform"
},
"billing": {
"amount": "0.04",
"currency": "USD",
"balance_after": "9.96"
}
}
}取自 2026-10-12 21:42 UTC 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。
返回大小:标准档 9.8 KB(精简 9.8 KB,完整 13.6 KB)。
{
"code": "ok",
"request_id": "be0abe47-fa2e-4d8d-81ca-6c0b66d1346b",
"data": { "items": [] },
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 0
},
"warnings": [],
"meta": {
"capability": "xiaohongshu.pgy.keywords.related",
"result_status": "empty",
"fetched_at": "2026-10-12T21:59:51.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"relevance": "platform",
"composite_index": "platform"
},
"billing": {
"amount": "0.04",
"currency": "USD",
"balance_after": "9.96"
}
}
}取自 2026-10-12 21:59 UTC 录下的真实返回。请求号和余额是示意。
返回大小:标准档 466 B(精简 466 B,完整 466 B)。
curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/keywords/related" \ --data-urlencode "keyword=面膜" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.xiaohongshu.pgy.keywords.related(keyword="面膜") print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.pgy.keywords.related({ keyword: "面膜" });
console.log(result.data.items);dataxapi call xiaohongshu.pgy.keywords.related 'keyword=面膜'{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}把这段加进你的 MCP 客户端,然后让你的 AI 调用 xiaohongshu.pgy.keywords.related。
参数
一个关键词。示例:面膜。
返回档位。三档价格相同。取值:compact、standard(默认)、full。
只要这些字段。按路径写,例如 author.name。
已知限制
- 每页约 98 条,最多 120 条。每页条数由平台决定,不收
limit。 - 一次给全,不发游标。
- 这个对象有 2 个字段这个接口给不了
返回字段
data.items 是关联词对象的列表。预览:结构可能调整,改之前会公告。
关联词
它是哪个词的关联词:所查的那个关键词
怎么关联的:query 是搜索里一起出现,posts 是内容里一起出现,prior 是人们搜所查的词之前搜的,after 是之后搜的querypostspriorafter
在同一种关联里按相关度排第几,从 1 起
和所查的词的相关度,0 到 1
这个关联词的搜索指数:平台算出的指数,不是搜索次数;平台不给这个词的数时为 null
展开全部 12 个字段 →
这个关联词的综合指数:平台把相关内容的热度合起来算出的指数,不是次数
和这个关联词有关的笔记数;平台不给这个词的数时为 null
这些笔记的阅读总数;平台不给这个词的数时为 null
这一条里哪些数是约数或下限;都是准确值时不出现
字段的路径,如 metrics.views
约数,还是下限approximatelower_bound
每条数据的典型体积:compact 98 B、standard 98 B、full 137 B(按 2026-10-12 21:42 UTC 录下的那次返回量的)。
这个接口给不了的
relevance平台没有composite_index平台没有什么时候收费
X-Max-Price 可以设自己的上限,超过就不执行)价格读取于 2026-10-21 10:10 UTC,按价目版本 2,2026-10-17 11:00 UTC 起生效;在 Playground 里运行前会再读一次当前价格。
对象不存在时
平台没有数据的关键词,和没有关联词的关键词一样,返回空结果,不报“不存在”。
常见报错
这个接口会返回的错误码;所有接口共有的见完整列表。
invalid_params参数不合法能否重试:改了再试未扣费insufficient_balance余额不足能否重试:改了再试未扣费upstream_failed数据来源出错能否重试:能未扣费timeout没有在时限内取到数据,可以用同一个幂等键重试能否重试:能未扣费常见问题
小红书蒲公英关联词 API 多少钱?
$0.0400 一次。单次最高扣费 $0.0400。
什么情况下不收费?
出错和超时不收费;空结果收 $0.0400。
一次返回多少条?怎么翻页?
每页约 98 条,最多 120 条。每页条数由平台决定,不收 limit。一次给全,不发游标。
对象不存在会怎样?
平台没有数据的关键词,和没有关联词的关键词一样,返回空结果,不报“不存在”。
小红书的全部 21 个接口
在你的 AI 里用它
复制这段提示词
你的 API Key 已经写在里面,不用再配置什么。
还没有账户?注册只要一个邮箱,不用绑卡,失败的调用不收费。
贴给你的 agent
它会去读提示词指向的那一页,自己接好。
现在问点什么
用下面任意一句,或者用自己的话问。
想自己手动配置?
dataxapi setup给这台电脑上的 AI 代理(Claude Code、Codex、Cursor)装好 DataXAPI 的 MCP 服务和基础技能。Key 从环境变量 DATAXAPI_API_KEY 读,不写进任何文件。MCP 服务地址:https://api.dataxapi.com/mcp。你的客户端要填的配置在本页请求示例的“MCP”页签里;接好后让你的 AI 调用 xiaohongshu.pgy.keywords.related。其他客户端 →展开全文
使用 DataXAPI 的接口 xiaohongshu.pgy.keywords.related(小红书蒲公英关联词)。按一个关键词取小红书用户搜它之前和之后还会搜的词(蒲公英),各带相关度名次、搜索指数、相关笔记数和阅读数,用来拓词选题。搜索指数是平台算出的指数,不是搜索次数;平台不给数的词,这几项为 null。 用 GET 请求 https://api.dataxapi.com/v1/xiaohongshu/pgy/keywords/related,带请求头 "Authorization: Bearer $DATAXAPI_API_KEY"。Key 从环境变量 DATAXAPI_API_KEY 读,不要写进代码。 参数: - keyword (必填):一个关键词。示例:面膜。 - view:返回档位。三档价格相同。取值:compact、standard(默认)、full。 - fields:只要这些字段。按路径写,例如 author.name。 价格:$0.0400 一次。出错和超时不收费;空结果收 $0.0400。 返回 JSON:data.items 是关联词;meta.billing.amount 是这次调用的扣费。 示例: curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/keywords/related" \ --data-urlencode "keyword=面膜" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" 完整说明(Markdown):https://dataxapi.com/zh/apis/xiaohongshu/pgy/keywords/related.md
名称和编号
- 英文名
- Xiaohongshu PGY related keywords API
- 接口编号
xiaohongshu.pgy.keywords.related- 地址
GET /v1/xiaohongshu/pgy/keywords/related
一把 Key,开始用。
21 个平台 207 个接口,一次 $0.0003 起。出错和超时不收费。