# 简书热门推荐

摘要

简书 - 一个优质的创作社区

Tip
简书热门推荐 API,自动爬取当日的热榜数据

接口地址:

https://apiserver.alcex.cn/daily-hot/jianshu

请求方式:

GET/POST

返回格式:

JSON

Curl请求示例:

curl -X GET 'https://apiserver.alcex.cn/daily-hot/jianshu'

请求参数:

查询参数(query_param):

名称 必填 类型 说明
cache Bool 为保证服务稳定性默认缓存1小时,可选择不缓存获取最新数据
limit int 由于部分榜单返回的数据量过多,特地添加了一个 limit 限制,你可以在请求的网址后面加上参数 limit=20 即可
rss bool 默认为false,新版本支持了 RSS 模式,就是可以在各大阅读器中直接阅读热榜数据了

返回参数:

名称 类型 说明
code int 状态码
name str 名称
title str 标题
description str 介绍
link str 链接
total int 数据总数
updateTime str 更新时间
fromCache Bool 是否为缓存数据
data json 数据数组

状态码说明:

状态码 状态 说明
200 成功 请求成功,返回正确的数据
400 请求错误 请求参数错误或缺失必要参数
401 未授权 缺少有效的身份验证凭据
403 禁止访问 服务器理解请求但拒绝执行
404 未找到 请求的资源不存在
429 请求过多 请求频率超过限制
500 服务器错误 服务器内部错误
502 网关错误 网关或代理服务器错误
503 服务不可用 服务器暂时无法处理请求

返回示例:

{
  "code": 200,
  "name": "jianshu",
  "title": "简书",
  "type": "热门推荐",
  "description": "一个优质的创作社区",
  "link": "https://www.jianshu.com/",
  "total": 3,
  "fromCache": false,
  "updateTime": "2025-08-15T23:38:27.317Z",
  "data": [
    {
      "id": "7fe34ab383f4",
      "title": "遇见|纽约,现代艺术博物馆MoMA(4)",
      "cover": "https://upload-images.jianshu.io/upload_images/26135517-828dc815a0469df4.jpg?x-oss-process=image/resize,w_360,h_240",
      "desc": "十九世纪末期,西方工业高速发展、社会快速变化,人们的思想也变得越发活跃亦日新月异。 艺术家们更是时代认知先锋,无论是梵高、高更、塞尚三位决然脱轨...",
      "author": "游世欢喜LatteSunset",
      "url": "https://www.jianshu.com/p/7fe34ab383f4",
      "mobileUrl": "https://www.jianshu.com/p/7fe34ab383f4"
    },
    {
      "id": "2153b2bb221a",
      "title": "花头帕",
      "cover": "https://upload-images.jianshu.io/upload_images/9884355-5c77760662a88f4e.jpg?x-oss-process=image/resize,w_360,h_240",
      "desc": "【郑重声明:原创首发,文责自负,未经许可,严禁转载。】 前几年偶然与小友驱车前去夯沙赶场时,居然在人声鼎沸的集市中寻到一家卖苗族服饰的小裁缝店。...",
      "author": "采葭小妖",
      "url": "https://www.jianshu.com/p/2153b2bb221a",
      "mobileUrl": "https://www.jianshu.com/p/2153b2bb221a"
    },
    {
      "id": "6ed2e40451f8",
      "title": "准大学生买衣服",
      "cover": "https://upload-images.jianshu.io/upload_images/16702692-3a6586758b243936.jpg?x-oss-process=image/resize,w_360,h_240",
      "desc": "准大学生的衣柜,藏着从校服到便装的期待。 以前一月难穿一次的自由,现在和以后都成了每天的日常。 接下来的每个季节都会处于缺衣服的状态。 她开始了...",
      "author": "颜娘娘的碎碎念",
      "url": "https://www.jianshu.com/p/6ed2e40451f8",
      "mobileUrl": "https://www.jianshu.com/p/6ed2e40451f8"
    }
  ]
}

错误返回示例:

{
  "code": 400,
  "error": "请求参数验证失败",
  "message": "请求参数缺失或无效,请查看官网文档以解决此问题:https://api.alcex.cn/",
  "details": [
    "query.id: Field required"
  ],
  "timestamp": 1755182973,
  "request_id": "21646ea2a01c461298cdbdbdb3f3a663"
}
{
  "code": 404,
  "error": "HTTP错误",
  "message": "Not Found",
  "timestamp": 1755182878,
  "request_id": "9ddc3b08d6724e4eafc2b4e2c1f24190"
}
{
    "code": 500,
    "error": "请求错误",
    "message": "请求处理过程中发生错误,请检查请求参数是否正确", 
    "timestamp": 1755182846,
    "request_id": "1cb82ff6aac5482caeac1999df66dccb"
}

多语言代码示例:

正在生成代码示例...

在线测试

提示:在线测试可能无法正常返回数据,建议使用专业工具测试。

Apifox
在 Apifox 中调试

使用专业的API调试工具进行更详细的测试

文档信息
标签:
简书 jianshu 热门推荐
添加时间: 2025-08-16 20:26:13
最后更新: 2025-08-16 23:59:36