接口说明

Reddit Search API 按关键词搜索 Reddit 内容,返回搜索结果及对应信息。

使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。

请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/reddit-search

请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集最长约75秒,客户端超时建议设为90秒。

请求参数

参数必填类型说明
targetYesstring搜索关键词
optionsNoobject仅处理下列开放参数;未列出的字段忽略,内部参数不可覆盖。

options 参数说明

参数必填类型说明
maxPagesNointeger本次请求翻几页,默认 1,最大 5,按实际返回条数计费,更多数据用返回的游标续取
默认值: 1
最小值: 1
最大值: 5
subredditNostring子版块名 (不带 r/)
sortNostringrelevance (默认) / hot / top / new / comments
tNostring时间范围: hour / day / week / month / year / all
includeOver18Noboolean包含 NSFW, 默认 false
afterNostring | null续页: 原样传入 pagination.after 的游标
sinceNostring | number只要该时间之后发布的帖子: ISO 日期 (2026-10-01) 或秒 / 毫秒时间戳; 没传 t 时自动用覆盖它的最小时间窗
untilNostring | number只要该时间之前发布的帖子, 格式同 since

仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。

每次默认1页,最多5页;页数必须为正整数,超过5按5处理。

只搜索帖子;content是搜索摘要而非完整正文,content/snippetId可能为null。

响应值

返回值类型说明
codeinteger状态码,0 表示成功
messagestring响应信息,成功时为 ok
pointCostnumber本次请求实际消耗的积点
dataobject返回数据,结构见下表
metaobject请求标识及耗时(毫秒)
billingobject计费条数、单价及规则版本

返回参数 data 说明

返回值类型说明
postsobject[]仅返回当前搜索 HTML 支持的字段; 含已有缩略图、预览图和图集
countnumber本次返回条数
paginationobjectPagination

data.posts[] 字段说明

返回值类型说明
titlestring | null标题
publishedAtobject | null发布时间 (text 为 ISO)
likesnumber | null得分 (赞 - 踩)
commentsCountnumber | null评论数
redditPostIdstring帖子 id (t3_)
id36string | null帖子短 id (链接里那段)
urlstring | null帖子链接
subredditstring | null子版块名
over18boolean是否 NSFW
spoilerboolean是否剧透
thumbnailstring | null缩略图
previewImagestring | null预览大图
galleryobject[]搜索页已有的图集图片
contentstring | null搜索摘要 (并非完整正文)
snippetIdstring | null搜索命中摘要 id
subredditIdstring | null子版块 id (t5_)
safeSearchstring | null搜索安全状态 (上游原值)
structureTypestring | null搜索结果结构类型 (上游原值)
subredditNsfwboolean | null子版块是否 NSFW; 与帖子 over18 分开
subredditQuarantinedboolean | null子版块是否被隔离
actionInfoobject | null选定摘要来源的事件信息
posterobject作者

data.posts[].publishedAt 字段说明

返回值类型说明
textstring | null上游原始时间文本
valuenumber | null解析后的毫秒时间戳; 解析失败为 null

data.posts[].gallery[] 字段说明

返回值类型说明
urlstring图片链接
widthnumber | null宽
heightnumber | null高

data.posts[].actionInfo 字段说明

返回值类型说明
positionnumber | null结果位置
relativePositionnumber | null相对位置
typestring | null事件类型

data.posts[].poster 字段说明

返回值类型说明
nicknamestring | null作者用户名
profileUrlstring | null作者主页
idstring | null作者 id (t2_)

data.pagination 字段说明

返回值类型说明
afterstring | nullBase64 编码的搜索续页游标, 原样传回 options.after
hasMoreboolean是否还有更多

请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/reddit-search \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "cat"
}'

返回示例

下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。

{
  "code": 0,
  "message": "ok",
  "pointCost": 5.6,
  "data": {
    "posts": [
      {
        "title": "The sweetest boy",
        "publishedAt": {
          "text": "2026-11-01T04:49:26.000Z",
          "value": 1793508566000
        },
        "likes": 40892,
        "commentsCount": 395,
        "redditPostId": "t3_1xkue2d",
        "id36": "1xkue2d",
        "url": "https://www.reddit.com/r/cats/comments/1xkue2d/the_sweetest_boy/",
        "subreddit": "cats",
        "over18": false,
        "spoiler": false,
        "thumbnail": "https://external-preview.redd.it/cXM1ZnZyZ3JseHloMVQVzRAdSxi9LkSs_PMqMdLGYGT9cMAz8h8NwoMTEtSZ.png?width=140&height=78&format=jpg&auto=webp&s=4e1d5ec8d9dd5d1f...",
        "previewImage": "https://external-preview.redd.it/cXM1ZnZyZ3JseHloMVQVzRAdSxi9LkSs_PMqMdLGYGT9cMAz8h8NwoMTEtSZ.png?width=140&height=78&format=jpg&auto=webp&s=4e1d5ec8d9dd5d1f...",
        "gallery": [],
        "content": "People that are saying cats cant show affection are on some stuff bro.",
        "snippetId": "t1_19ryqf8nbs8bo",
        "subredditId": "t5_2qhta",
        "safeSearch": "UNAVAILABLE",
        "structureType": "search",
        "subredditNsfw": false,
        "subredditQuarantined": false,
        "actionInfo": {
          "position": 0,
          "relativePosition": 0,
          "type": null
        },
        "poster": {
          "nickname": "DarthiusFatticus",
          "profileUrl": "https://www.reddit.com/user/DarthiusFatticus/",
          "id": "t2_5t81wgdhd"
        }
      }
    ],
    "count": 7,
    "pagination": {
      "after": "L3N2Yy9zaHJlZGRpdC9zZWFyY2gvP3E9Y2F0JnR5cGU9cG9zdHMmY3Vyc29yPWV5SmpZVzVrYVdSaGRHVnpYM0psZEhWeWJtVmtJam9pZTF3aWMyVmpkR2x2Ymw4eFgzQnBjR1ZzYVc1bFh6QmZaMnh2WW1Gc...",
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-reddit-search-1793954305068487100",
    "durationMs": 2991
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 7,
    "pointCost": 5.6
  }
}

积点消耗说明

每条主体结果消耗 0.8 积点。

空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

在线调试