小红书笔记详情 API 调用说明文档
一、背景
小红书是一个生活方式分享社区,用户可以在平台上发布和获取各类生活方式的笔记内容。为了提供更高效、更便捷的服务,我们开放了小红书笔记详情 API,供开发者查询小红书笔记的详细信息。
二、应用
小红书笔记详情 API 主要应用于以下场景:
- 内容管理系统:对于需要大量获取小红书笔记内容的应用,如内容管理系统,可以通过 API 获取笔记的详细信息,从而为用户提供更为丰富的内容。
- 第三方数据分析工具:数据分析工具可以利用 API 获取小红书笔记的数据,对社区内的热门话题、用户行为等进行深度分析。
- 个性化推荐系统:通过对 API 的使用,可以获取小红书笔记的详细信息,进而为推荐系统提供数据支持,为用户提供更为精准的个性化推荐。
三、API 调用说明
-
请求方式:使用 GET 方法进行请求。
-
请求参数:
-
公共参数
名称 类型 必须 描述 key String 是 调用key(必须以GET方式拼接在URL中) secret String 是 调用密钥 api_name String 是 API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] cache String 否 [yes,no]默认yes,将调用缓存的数据,速度比较快 result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 lang String 否 [cn,en,ru]翻译语言,默认cn简体中文 version String 否 API版本 请求参数
请求参数:num_iid=649c46ab000000002702ad36
参数说明:num_iid:笔记ID
-
-
响应参数:
title
:笔记的标题。content
:笔记的内容。author
:笔记的作者名称。like_count
:笔记的点赞数量。comment_count
:笔记的评论数量。tag
:笔记所带的标签。created_at
:笔记的发布时间。
-
调用示例:
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:
$method = "GET";
$url = "https://api-服务器.cn/smallredbook/item_get_video/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=649c46ab000000002702ad36";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
其中,:note_id
替换为具体的笔记 ID,YOUR_ACCESS_TOKEN
替换为申请获得的 access token。
5. 返回值说明:API 调用成功时,返回 JSON 格式的数据,包含笔记的详细信息;调用失败时,返回相应的错误信息。
6. 错误码说明:在调用失败的情况下,API 会返回一个错误码以及相应的错误信息。以下是可能遇到的错误码及其含义:
* 404
:笔记不存在。
* 401
:未授权访问,access token 无效或已过期。
* 403
:禁止访问,账号存在违规行为或被封禁。
* 其他错误码请参考具体文档或联系客服支持获取更多信息。