必读事项
- 如需获取密钥,请访问 https://galaxysapi.com/ 注册后在平台内创建密钥。
- 所有接口请求成功才扣费,失败和异常均不会扣费,请放心使用。
- 所有资源已升级,延迟更低,并发更高。
- 正常情况下接口秒级响应。有概率遇到处理风控,请求出现等待几十秒属于正常现象,建议超时时间设置 60 秒以上。
- 请注意,账户超 1 个月未使用会被清理,无法找回。
- 错误码说明:200 请求成功;400 参数错误,请检查必填参数;401 认证失败,请检查 Authorization。
- 错误码说明:402 余额不足,请联系管理员充值;403 账户被封禁,请联系管理员;500 服务器错误,请稍后重试。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
说明:获取小红书笔记详情,支持图文 / 视频。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_detail"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "68663c5e000000000d027a20"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 视频笔记ID |
说明:获取小红书视频笔记详情,含视频地址、时长等信息。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_detail_video"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6a0ae55400000000350212e6"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词,如:猫粮 |
| page | integer | 是 | 第几页,如:1 |
| page_size | integer | 否 | 每页数量,默认20 |
| sortType | string | 否 | 排序:general(综合) / time_descending(最新) / popularity_descending(最多点赞) / comment_descending(最多评论) / collect_descending(最多收藏) |
| filterNoteType | string | 否 | 笔记类型:不限 / 视频笔记 / 普通笔记 / 直播笔记 |
| filterNoteTime | string | 否 | 发布时间:不限 / 一天内 / 一周内 / 半年内 |
| filterNoteRange | string | 否 | 搜索范围:不限 / 已看过 / 未看过 / 已关注 |
| searchId | string | 否 | 翻页必传,首次请求不传,使用返回的 searchId |
| sessionId | string | 否 | 翻页必传,首次请求不传,使用返回的 sessionId |
| filter_hot | string | 否 | 筛选标签,精细化搜索,如:可购买、品牌、测评、家具 |
说明:按关键词搜索小红书笔记,支持排序、类型、时间筛选;翻页用上次返回的 search_id。
在线测试
import requests
url = "https://api.galaxysapi.com/api/search_note"
headers = {"Authorization": "YOUR_KEY"}
search_id = ""
session_id = ""
for page in range(1, 4):
params = {
"keyword": "猫粮",
"page": str(page),
"sortType": "general",
"searchId": search_id,
"sessionId": session_id,
}
resp = requests.get(url, params=params, headers=headers)
result = resp.json()
# 获取翻页参数(下一页必传)
search_id = result.get("searchId", "")
session_id = result.get("sessionId", "")
print(f"第{page}页, 余额: {result.get('balance')}")
print(f" searchId: {search_id}")
print(f" sessionId: {session_id}")
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
| start | string | 否 | 分页游标 |
| sortStrategy | string | 否 | 评论排序方式:1=默认,2=最新评论,3=点赞最多 |
说明:获取笔记的一级评论列表,支持排序与翻页。
在线测试
import requests, json
url = "https://api.galaxysapi.com/api/get_note_comment"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "NOTE_ID", "sortStrategy": "2", "start": ""}
# 首次 start 留空,翻页时使用上次响应中的游标
while True:
resp = requests.get(url, params=params, headers=headers, timeout=30).json()
outer = resp.get("data")
if isinstance(outer, str): outer = json.loads(outer)
body = (outer or {}).get("data") or {}
comments = body.get("comments") or []
print("本页评论数:", len(comments))
# cursor 是 JSON 字符串(如 {"cursor":"xxx","index":1,"pageArea":"UNFOLDED"}),
# 翻页只需要传里面的 cursor 值,不要把整串 JSON 传回去
raw_cursor = body.get("cursor")
next_cursor = ""
if isinstance(raw_cursor, str) and raw_cursor.strip().startswith("{"):
try:
next_cursor = json.loads(raw_cursor).get("cursor", "")
except Exception:
next_cursor = ""
elif raw_cursor:
next_cursor = raw_cursor
# has_more 有时在最后一页仍为 true,但游标已经提取不出值——视为已翻完,避免死循环
if not body.get("has_more") or not next_cursor:
break
params["start"] = next_cursor
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
| comment_id | string | 是 | 评论ID |
| start | string | 否 | 分页游标 |
说明:获取某条评论下的二级评论(回复)。
在线测试
import requests, json
url = "https://api.galaxysapi.com/api/get_note_sub_comment"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "NOTE_ID", "comment_id": "COMMENT_ID", "start": ""}
# 首次 start 留空,翻页时使用上次响应中的游标
while True:
resp = requests.get(url, params=params, headers=headers, timeout=30).json()
outer = resp.get("data")
if isinstance(outer, str): outer = json.loads(outer)
body = (outer or {}).get("data") or {}
comments = body.get("comments") or []
print("本页二级评论数:", len(comments))
# cursor 是 JSON 字符串,翻页只需要传里面的 cursor 值,不要把整串 JSON 传回去;
# num 不一定严格生效(常见每页5~8条),has_more 也可能在数据没取完时提前变 false,
# 建议以一级评论的 sub_comment_count 作为期望条数来判断是否已经拿全
raw_cursor = body.get("cursor")
next_cursor = ""
if isinstance(raw_cursor, str) and raw_cursor.strip().startswith("{"):
try:
next_cursor = json.loads(raw_cursor).get("cursor", "")
except Exception:
next_cursor = ""
elif raw_cursor:
next_cursor = raw_cursor
if not body.get("has_more") or not next_cursor:
break
params["start"] = next_cursor
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
说明:获取小红书用户主页信息,含昵称、简介、粉丝 / 获赞等。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_user_info"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "5659223450c4b4595d6c312c"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| cursor | string | 否 | 分页游标 |
说明:获取指定用户发布的笔记列表,游标翻页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/user_note_list"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "5659223450c4b4595d6c312c"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageId | string | 是 | 话题页面ID,24位十六进制 |
| sort | string | 否 | 排序:hot 最热,time 最新。默认 hot |
| cursor | string | 否 | 分页游标,首次留空;翻页时原样回传上一次响应里的 cursor |
说明:获取话题标签下的笔记列表,支持翻页。话题ID从可从详情接口返回的话题链接里面提取。
在线测试
import json
import requests
url = "https://api.galaxysapi.com/api/tag_notes"
headers = {"Authorization": "YOUR_KEY"}
# 首次请求:cursor 留空
params = {
"pageId": "5c014b045b29cb0001ead530",
"sort": "hot"
}
resp = requests.get(url, params=params, headers=headers, timeout=60)
result = resp.json()
print(json.dumps(result, ensure_ascii=False, indent=2))
# 翻页请求:原样回传上一次响应里的 cursor
data = result.get("data", {})
if data.get("has_more") and data.get("cursor"):
next_params = {**params, "cursor": data["cursor"]}
next_resp = requests.get(url, params=next_params, headers=headers, timeout=60)
print(json.dumps(next_resp.json(), ensure_ascii=False, indent=2))
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
说明:小红书笔记详情(Web 数据源),支持图文 / 视频。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_detail_web"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6a2942320000000016025071"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
| node_type | string | 否 | 笔记类型:images=图文笔记(默认)/ video=视频笔记,图文笔记不要传video,否则可能返回随机数据 |
说明:APP端笔记详情,支持图文/视频。返回 data 为数组,每个元素含 user(作者)、note_list(正文/图片/视频)、comment_list。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_detail_v1"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6a2942320000000016025071"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
说明:APP端用户信息。返回 data 为对象,含昵称、红薯号、性别、简介、粉丝/获赞等统计信息。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_user_info_v1"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "5b7445a64115e0000101b952"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| cursor | string | 否 | 分页游标,首次留空,翻页传上页最后一条笔记的 cursor |
说明:APP端用户作品列表。返回 data 为对象 { notes, tags, has_more },has_more=true 时代表还有下一页(用最后一条笔记的 cursor 翻页)。
在线测试
import requests
url = "https://api.galaxysapi.com/api/user_note_list_v1"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "5b7445a64115e0000101b952"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| page | string | 否 | 页数,默认 1 |
| page_size | string | 否 | 每页数量,默认20 |
| sort | string | 否 | 排序:general=综合(默认),time_descending=最新,popularity_descending=最多点赞,comment_descending=最多评论,collect_descending=最多收藏,english_preferred=英文优先 |
| note_type | string | 否 | 笔记类型:不传=全部,video=只看视频笔记,image=只看图文笔记,live=只看直播笔记 |
| note_range | string | 否 | 搜索范围:不限(默认)/已看过/未看过/已关注 |
| note_time | string | 否 | 发布时间:不限(默认)/一天内/一周内/一个月内/一年内 |
| search_id | string | 否 | 搜索标识,翻页时使用 |
| session_id | string | 否 | 会话标识 |
说明:APP端笔记搜索。返回 data 为对象,笔记列表在 data.items[],data.search_request_id 为本次搜索标识(翻页可用)。
在线测试
import requests
url = "https://api.galaxysapi.com/api/search_note_v1"
headers = {"Authorization": "YOUR_KEY"}
params = {"keyword": "旅游"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
| num | string | 否 | 每页数量,默认15 |
| sort | string | 否 | 排序:默认/最新/最多点赞 |
| cursor | string | 否 | 翻页游标 |
说明:APP端一级评论,评论列表在 data.comments[],data.has_more 为 true 时翻页;评论的 id 可作为二级评论的 comment_id。翻页时把上次响应的 data.cursor 原样传回来即可(不用自己解析),但要注意:最后一页有时仍会返回 has_more:true,此时如果传回 cursor 后下一页返回空列表,应视为已翻完,不要死循环重试。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_comment_v1"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6718e886000000001b02c67c"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
| comment_id | string | 是 | 上级评论ID(来自一级评论的 id) |
| num | string | 否 | 返回数量 |
| cursor | string | 否 | 分页游标 |
说明:APP端二级评论(回复)。comment_id 取自一级评论接口返回的评论 id。评论列表在 data.comments[],data.has_more 翻页。回复关系看 target_comment.id,它可能指向一级评论、也可能指向另一条二级评论(楼中楼),不要假设都是回复一级评论。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_sub_comment_v1"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6718e886000000001b02c67c", "comment_id": "6722db7d000000001a0127c4"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| goods_id | string | 是 | 商品ID 或商品短链 |
说明:通过商品 ID 或商品短链获取小红书商品详情,含店铺与 SKU 信息。
在线测试
import requests
url = "https://api.galaxysapi.com/api/xhs_goods_detail_web"
headers = {"Authorization": "YOUR_KEY"}
params = {"goods_id": "682162d0791e9400151e7200"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 关键词 |
| page | int | 否 | 页数,默认 1 |
| search_id | string | 否 | 搜索标识,页数 >1 时必传 |
说明:按关键词搜索小红书用户;page>1 时需传上次返回的 search_id。
在线测试
import requests
url = "https://api.galaxysapi.com/api/search_user_web"
headers = {"Authorization": "YOUR_KEY"}
params = {"keyword": "旅游"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| page | int | 否 | 页数,第一页为 1 |
| note_type | int | 否 | 笔记类型:1=图文,2=视频 |
说明:小红书笔记搜索(Web 数据源),支持按类型筛选、分页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/search_note_web"
headers = {"Authorization": "YOUR_KEY"}
params = {"keyword": "旅游"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
说明:更新笔记的 xsec_token;评论接口需先用它换取 token。
在线测试
import requests
url = "https://api.galaxysapi.com/api/update_xsec_token_web"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6a02c5a4000000003700dff0"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
| xsec_token | string | 是 | 首次用更新 xsec_token 接口返回值;翻页用上一次本接口返回值 |
| cursor | string | 否 | 分页游标,首次为空 |
说明:小红书一级评论(Web),需配合 xsec_token;翻页用上次响应返回的 token。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_comment_web"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6a02c5a4000000003700dff0", "xsec_token": "MBW1R-1ysYzoHhvurSSzhy6iMCe7FesKtW5KjxJ38a1to="}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID |
| xsec_token | string | 是 | 使用一级评论接口返回的 data.xsec_token;二级评论翻页时使用上一次二级评论响应返回的 data.xsec_token |
| cursor | string | 是 | 上级评论的 sub_comment_cursor |
| root_comment_id | string | 是 | 上级评论的 ID |
说明:小红书笔记二级评论(Web),需 xsec_token 及上级评论的 cursor / root_comment_id。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_sub_comment_web"
headers = {"Authorization": "YOUR_KEY"}
params = {
"note_id": "6a06c2ec000000003701c99d",
"xsec_token": "ABquNzf-DSV20_H_bT2lY342maQVlTemDU6kpj36WU2eE=",
"cursor": "6a101bce000000002900db80",
"root_comment_id": "6a100c7400000000280356c0"
}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| page | int | 否 | 页数,首页为 1 |
说明:获取达人发布的商品笔记列表,支持分页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_user_posts_web"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "5b7445a64115e0000101b952", "page": "1"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| page | int | 否 | 页码,从1开始,默认1 |
| search_id | string | 否 | 搜索ID(分页用),首次为空 |
| source | string | 否 | 来源,默认 explore_feed |
说明:小红书商城商品搜索,按关键词分页检索。
在线测试
import requests
url = "https://api.galaxysapi.com/api/search_products_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"keyword": "手机壳", "page": 1}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sku_id | string | 是 | 商品 SKU ID |
| source | string | 否 | 来源,默认 mall_search |
| pre_page | string | 否 | 上一页来源,默认 mall_search |
说明:通过 SKU ID 获取小红书商品详情。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_product_detail_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"sku_id": "669ddd44e05f3700011067ed"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sku_id | string | 是 | 商品 SKU ID |
| page | int | 否 | 页码,从0开始 |
| sort_strategy_type | int | 否 | 排序策略,0=默认 |
| share_pics_only | int | 否 | 仅看有图,0=全部 |
| from_page | string | 否 | 来源页面,默认 score_page |
说明:获取小红书商品评论,支持分页与排序。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_product_reviews_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"sku_id": "669ddd44e05f3700011067ed", "page": 0}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户 ID |
说明:小红书用户信息(App V2 数据源)。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_user_info_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "61b46d790000000010008153"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户 ID |
| cursor | string | 否 | 分页游标,首次留空,翻页传上页最后一条笔记的 cursor |
说明:获取指定博主发布的全部笔记,游标翻页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_user_notes_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "61b46d790000000010008153", "cursor": ""}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page_id | string | 是 | 话题页面 ID |
| source | string | 否 | 来源,默认 normal |
说明:获取话题详情,含名称、浏览量、讨论数、分享信息等。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_topic_info_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"page_id": "5c1cc866febed9000184b7c1"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记 ID |
说明:获取小红书图文笔记完整详情,含内容、图片、作者、互动数据。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_image_note_detail_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "697c0eee000000000a03c308"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 二选一 | 笔记 ID(与 share_text 二选一,优先用此项) |
| share_text | string | 二选一 | 小红书分享链接(与 note_id 二选一),支持 APP/Web |
说明:获取视频笔记完整详情(播放地址/封面/作者/互动)。note_id 与 share_text 至少传一个,同时传以 note_id 为准。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_video_note_detail_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "697c0eee000000000a03c308"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 二选一 | 用户 ID(与 share_text 二选一,优先用此项) |
| share_text | string | 二选一 | 小红书分享链接(与 user_id 二选一),支持 APP/Web |
| cursor | string | 否 | 分页游标,首次留空,翻页传上页最后一条笔记的 note_id |
说明:获取指定用户公开收藏的笔记列表,游标翻页。user_id 与 share_text 至少传一个,同时传以 user_id 为准。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_user_faved_notes_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "5a8cf39111be10466d285d6b", "cursor": ""}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page_id | string | 是 | 话题页面 ID |
| sort | string | 否 | 排序:trend(最热,默认)、time(最新) |
| cursor_score | string | 否 | 分页游标分数,翻页时传入 |
| last_note_id | string | 否 | 上一页最后一条笔记 ID |
| last_note_ct | string | 否 | 上一页最后一条笔记创建时间 |
| session_id | string | 否 | 会话 ID,翻页保持一致 |
| first_load_time | string | 否 | 首次加载时间戳,翻页保持一致 |
| source | string | 否 | 来源,默认 normal |
说明:获取指定话题下的笔记列表,支持最热/最新排序,游标翻页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_topic_feed_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"page_id": "5c1cc866febed9000184b7c1", "sort": "trend"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| page | string | 否 | 页码,从 1 开始 |
| sort_type | string | 否 | 排序:general/time_descending/popularity_descending/comment_descending/collect_descending/english_preferred |
| note_type | string | 否 | 笔记类型:不限/视频笔记/普通笔记/直播笔记 |
| time_filter | string | 否 | 发布时间:不限/一天内/一周内/半年内 |
| search_id | string | 否 | 搜索 ID,翻页传入首次搜索返回值 |
| search_session_id | string | 否 | 搜索会话 ID,翻页传入首次搜索返回值 |
| source | string | 否 | 来源,默认 explore_feed |
| ai_mode | string | 否 | AI 模式:0=关闭(默认),1=开启 |
说明:按关键词搜索笔记,支持排序、笔记类型、发布时间筛选与分页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/search_notes_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"keyword": "美食推荐", "page": "1", "sort_type": "general"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| page | string | 否 | 页码,从 1 开始 |
| search_id | string | 否 | 搜索 ID,翻页传入首次搜索返回值 |
| source | string | 否 | 来源,默认 explore_feed |
说明:按关键词搜索用户,每页 20 条,支持分页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/search_users_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"keyword": "美食博主", "page": "1"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 二选一 | 笔记 ID(与 share_text 二选一,优先用此项) |
| share_text | string | 二选一 | 小红书分享链接(与 note_id 二选一),支持 APP/Web |
| cursor | string | 否 | 分页游标,首次留空 |
| index | string | 否 | 评论索引,首次传0 |
| pageArea | string | 否 | 折叠状态:UNFOLDED(展开)或FOLDED(折叠) |
| sort_strategy | string | 否 | 排序策略:latest_v2(最新)、like_count(点赞数)、default(默认) |
说明:note_id 与 share_text 至少传一个,同时传以 note_id 为准。评论列表在 data.data.comments[],data.data.has_more 为 true 时翻页;评论的 id 可作为二级评论接口的 comment_id。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_comments_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6a325a5c000000002201727c"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| comment_id | string | 是 | 一级评论 ID(指定获取这条评论下的子评论) |
| note_id | string | 二选一 | 笔记 ID(与 share_text 二选一,优先用此项) |
| share_text | string | 二选一 | 小红书分享链接(与 note_id 二选一),支持 APP/Web |
| cursor | string | 否 | 分页游标,首次留空 |
| index | string | 否 | 分页索引,首次传1 |
说明:comment_id 取自一级评论接口返回的评论 id;note_id 与 share_text 至少传一个。回复列表在 data.data.comments[],翻页时把上次响应的 data.data.cursor/index 原样回传。
在线测试
import requests
url = "https://api.galaxysapi.com/api/get_note_sub_comments_rnote"
headers = {"Authorization": "YOUR_KEY"}
params = {"comment_id": "6a326740000000002a007c6a", "note_id": "6a325a5c000000002201727c"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| aweme_id | string | 是 | 抖音作品/文章 ID(纯数字) |
说明:获取抖音作品详情,支持图文 / 视频 / 文章。
在线测试
import requests
url = "https://api.galaxysapi.com/api/douyin_video_detail"
headers = {"Authorization": "YOUR_KEY"}
params = {"aweme_id": "7448118827402972455"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| aweme_id | string | 是 | 抖音作品 ID(纯数字) |
| cursor | string | 否 | 翻页游标,默认 0 |
| count | string | 否 | 每页数量,默认 20 |
说明:获取抖音作品的一级评论,cursor 翻页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/douyin_video_comments"
headers = {"Authorization": "YOUR_KEY"}
params = {"aweme_id": "7448118827402972455", "cursor": "0", "count": "20"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| item_id | string | 是 | 抖音作品 ID(纯数字) |
| comment_id | string | 是 | 一级评论 ID(纯数字) |
| cursor | string | 否 | 翻页游标,默认 0 |
| count | string | 否 | 每页数量,默认 20 |
说明:获取抖音某条一级评论下的回复(二级评论)。注意作品 ID 参数名为 item_id。
在线测试
import requests
url = "https://api.galaxysapi.com/api/douyin_comment_replies"
headers = {"Authorization": "YOUR_KEY"}
params = {"item_id": "7448118827402972455", "comment_id": "7448331808838320959", "cursor": "0", "count": "20"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sec_user_id | string | 是 | 用户 sec_user_id |
说明:获取指定抖音用户的主页信息(昵称/签名/粉丝数/作品数等)。
在线测试
import requests
url = "https://api.galaxysapi.com/api/douyin_user_profile"
headers = {"Authorization": "YOUR_KEY"}
params = {"sec_user_id": "MS4wLjABAAAAY3J1P0y5w7hzttTyvZiLjhMu3iOzF-1yFi6yNtXVHzkmVGFIx7T8s-nRmGNusfh1"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sec_user_id | string | 是 | 用户 sec_user_id |
| max_cursor | string | 否 | 翻页游标,默认 0 |
| count | string | 否 | 每页数量,默认 20(不超过 20) |
| sort_type | string | 否 | 排序:0=最新(默认),1=最热 |
说明:获取指定抖音用户主页发布的作品列表,max_cursor 翻页。
在线测试
import requests
url = "https://api.galaxysapi.com/api/douyin_user_videos"
headers = {"Authorization": "YOUR_KEY"}
params = {"sec_user_id": "MS4wLjABAAAAY3J1P0y5w7hzttTyvZiLjhMu3iOzF-1yFi6yNtXVHzkmVGFIx7T8s-nRmGNusfh1", "max_cursor": "0", "count": "20", "sort_type": "0"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| cursor | string | 否 | 翻页游标,首次传 0 |
| sort_type | string | 否 | 排序:0=综合,1=最多点赞,2=最新发布 |
| publish_time | string | 否 | 发布时间:0=不限,1=最近一天,7=最近一周,180=最近半年 |
| filter_duration | string | 否 | 视频时长:0=不限,0-1=1分钟内,1-5=1-5分钟,5-10000=5分钟以上 |
| content_type | string | 否 | 内容类型:0=不限,1=视频,2=图片,3=文章 |
| search_id | string | 否 | 搜索 ID,翻页时从上次响应获取 |
| backtrace | string | 否 | 翻页回溯标识,翻页时从上次响应获取 |
说明:抖音综合搜索,支持排序 / 发布时间 / 时长 / 内容类型筛选。视频列表在 data.business_data[].data.aweme_list[] 下(含 aweme_id、desc、统计、视频地址等)。注意:sort_type / publish_time / content_type 等筛选值请以字符串形式传入(如 "1")。
在线测试
import requests
url = "https://api.galaxysapi.com/api/douyin_general_search"
headers = {"Authorization": "YOUR_KEY"}
body = {"keyword": "猫咪", "cursor": "0", "sort_type": "0", "content_type": "0"}
resp = requests.post(url, json=body, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
说明:获取蒲公英(小红书官方达人营销平台)里该用户的基础信息,含粉丝数、报价、行业标签、内容标签等。仅限已入驻蒲公英的达人账号。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_author_info"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
| business | int | 否 | 0=日常笔记(默认),1=合作笔记 |
| note_type | int | 否 | 1=图文,2=视频,3=图文+视频(默认) |
| advertise_switch | int | 否 | 0=自然流量(默认),1=全流量(含投流) |
| date_type | int | 否 | 1=近30天(默认),2=近90天 |
说明:该达人笔记的曝光/阅读/互动等中位数与超越率、内容标签分布,以及近期代表笔记列表。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_author_data_performance"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d", "business": 0, "note_type": 3, "advertise_switch": 0, "date_type": 1}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
说明:粉丝增长率、活跃粉丝占比、互动粉丝率等成长类指标及其超越率。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_author_growth_performance"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
| page | int | 否 | 页码,从 1 开始,默认 1 |
| note_type | int | 否 | 1=图文,2=视频,3=合作笔记,4=全部(默认) |
| order_type | int | 否 | 1=最新(默认),2=阅读最多,3=互动最多 |
| advertise_switch | int | 否 | 0=自然流量(默认),1=全流量 |
| is_third_platform | int | 否 | 是否第三方平台数据,0=否(默认),1=是 |
说明:分页获取该达人的笔记列表,含阅读/点赞/收藏数与是否为广告合作笔记(brandName 字段)。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_author_notes_list"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d", "page": 1, "note_type": 4, "order_type": 1}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
说明:预估该达人图文/视频合作的 CPM、互动成本等投放成本参考值。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_author_promotion_cost"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词(达人昵称/小红书号/内容关键词) |
| page_num | int | 否 | 页码,从 1 开始,默认 1 |
| page_size | int | 否 | 每页数量,默认由上游决定 |
| search_type | int | 否 | 0=号/昵称精确搜索,1=综合搜索(默认) |
说明:在蒲公英平台按关键词搜索已入驻达人,返回粉丝数、报价、内容标签、代表笔记等,可用 user_id 字段联动其余蒲公英接口。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_blogger_list"
headers = {"Authorization": "YOUR_KEY"}
params = {"keyword": "美妆", "page_num": 1, "search_type": 1}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
| business | int | 否 | 0=日常笔记(默认),1=合作笔记 |
| note_type | int | 否 | 1=图文,2=视频,3=图文+视频(默认) |
| date_type | int | 否 | 1=近30天(默认),2=近90天 |
| advertise_switch | int | 否 | 0=自然流量(默认),1=全流量 |
说明:CPM/CPV 等每日投放核心指标明细(近30天,按天返回),及汇总数据 sumData。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_core_metrics"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d", "business": 0, "note_type": 3, "date_type": 1}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
| business | int | 否 | 0=按规模(默认),1=按成本 |
说明:达人整体画像概览,含内容标签分布、外溢指标、达人类型(品效型/种草型等)画像标签。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_data_overview"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d", "business": 0}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
| date_type | int | 否 | 1=近30天(默认),2=近60天 |
| increase_type | int | 否 | 1=总量(默认),2=增量 |
说明:按天返回粉丝总数曲线(或每日增量),以及区间净增粉丝数与增长率。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_fans_growth"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d", "date_type": 1, "increase_type": 1}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 小红书用户ID,24位十六进制 |
说明:该达人粉丝画像——年龄段/性别/兴趣分布/省份城市分布/机型分布占比。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_fans_tags"
headers = {"Authorization": "YOUR_KEY"}
params = {"user_id": "556aceba484fb624f84be04d"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| note_id | string | 是 | 笔记ID,24位十六进制 |
说明:通过蒲公英获取笔记详情,含图片/视频信息、曝光、点赞等互动数据;限已在蒲公英报备/合作过的笔记。
在线测试
import requests
url = "https://api.galaxysapi.com/api/pgy_note_detail"
headers = {"Authorization": "YOUR_KEY"}
params = {"note_id": "6a325a5c000000002201727c"}
resp = requests.get(url, params=params, headers=headers)
print(resp.json())