小红书获得小红书笔记详情 API

一时失言乱红尘 2024-02-05 18:19 34阅读 0赞

小红书笔记详情 API 调用说明文档

#### 一、背景 ####

小红书是一个生活方式分享社区，用户可以在平台上发布和获取各类生活方式的笔记内容。为了提供更高效、更便捷的服务，我们开放了小红书笔记详情 API，供开发者查询小红书笔记的详细信息。

#### 二、应用 ####

小红书笔记详情 API 主要应用于以下场景：

1.  内容管理系统：对于需要大量获取小红书笔记内容的应用，如内容管理系统，可以通过 API 获取笔记的详细信息，从而为用户提供更为丰富的内容。
2.  第三方数据分析工具：数据分析工具可以利用 API 获取小红书笔记的数据，对社区内的热门话题、用户行为等进行深度分析。
3.  个性化推荐系统：通过对 API 的使用，可以获取小红书笔记的详细信息，进而为推荐系统提供数据支持，为用户提供更为精准的个性化推荐。

#### 三、API 调用说明 ####

1.  请求方式：使用 GET 方法进行请求。
2.  请求参数：
    
     *  公共参数
        
        <table> 
         <thead> 
          <tr> 
           <th>名称</th> 
           <th>类型</th> 
           <th>必须</th> 
           <th>描述</th> 
          </tr> 
         </thead> 
         <tbody> 
          <tr> 
           <td>key</td> 
           <td>String</td> 
           <td>是</td> 
           <td><a href="http://o0b.cn/opjenn" rel="nofollow" title="调用key">调用key</a>（必须以GET方式拼接在URL中）</td> 
          </tr> 
          <tr> 
           <td>secret</td> 
           <td>String</td> 
           <td>是</td> 
           <td>调用密钥</td> 
          </tr> 
          <tr> 
           <td>api_name</td> 
           <td>String</td> 
           <td>是</td> 
           <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
          </tr> 
          <tr> 
           <td>cache</td> 
           <td>String</td> 
           <td>否</td> 
           <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
          </tr> 
          <tr> 
           <td>result_type</td> 
           <td>String</td> 
           <td>否</td> 
           <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
          </tr> 
          <tr> 
           <td>lang</td> 
           <td>String</td> 
           <td>否</td> 
           <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
          </tr> 
          <tr> 
           <td>version</td> 
           <td>String</td> 
           <td>否</td> 
           <td>API版本</td> 
          </tr> 
         </tbody> 
        </table>
        
        请求参数
        
        请求参数：num\_iid=649c46ab000000002702ad36
        
        参数说明：num\_iid:笔记ID
3.  响应参数：
    
     *  `title`：笔记的标题。
     *  `content`：笔记的内容。
     *  `author`：笔记的作者名称。
     *  `like_count`：笔记的点赞数量。
     *  `comment_count`：笔记的评论数量。
     *  `tag`：笔记所带的标签。
     *  `created_at`：笔记的发布时间。
4.  调用示例：

<?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`：禁止访问，账号存在违规行为或被封禁。  
\* 其他错误码请参考具体文档或联系客服支持获取更多信息。