Apinoa Docs

Profiles

按关键词搜索 Reddit 用户。

查看原始 .mdx
GET | POST /v1/reddit/profiles

参数可以用 GET 的查询字符串发送,也可以用 POST 的 JSON 请求体发送,两者等价。

传入内容

传入读取内容说明
query用户搜索

每次调用只传一个来源。所有标识符也都接受页面 URL。

参数

参数类型必填说明
cursorstringOpaque cursor from the previous page's cursor. Pass it alone for the next page.
limitinteger 1–100Items per page, 1–100.
querystringKeywords to search accounts for.

请求

curl "https://gateway.apinoa.com/v1/reddit/profiles?query=python&limit=3" \
  -H "x-api-key: $APINOA_API_KEY"

响应

在 data 中返回 Account Page。 真实响应的节选:数组只保留前几项,长文本已截断。

{
  "success": true,
  "data": {
    "platform": "reddit",
    "items": [
      {
        "platform": "reddit",
        "id": "32tit",
        "handle": "python",
        "url": "https://www.reddit.com/user/python/",
        "avatarUrl": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_5.png",
        "verified": true,
        "createdAt": "2008-01-28T15:10:46.000Z",
        "ext": {
          "fullname": "t2_32tit",
          "karma": {
            "post": 1,
            "comment": 0
          },
          "hasVerifiedEmail": false,
          "acceptsFollowers": true,
          "iconUrl": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_5.png"
        }
      },
      {
        "platform": "reddit",
        "id": "s6onk5we",
        "handle": "python-python-python",
        "url": "https://www.reddit.com/user/python-python-python/",
        "avatarUrl": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_6.png",
        "verified": true,
        "createdAt": "2022-09-04T05:54:45.000Z",
        "ext": {
          "fullname": "t2_s6onk5we",
          "karma": {
            "post": 1,
            "comment": 12
          },
          "hasVerifiedEmail": true,
          "acceptsFollowers": false,
          "hideFromRobots": true,
          "iconUrl": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_6.png"
        }
      }
    ]
  }
}

错误

状态代码含义
400INVALID_CURSOR该 cursor 不是本操作返回的。请不带它重新开始。
400INVALID_PARAMS参数缺失、未知或超出范围。消息中会指出是哪一个。
401UNAUTHORIZED缺少 x-api-key 请求头,或密钥已吊销或未知。
402INSUFFICIENT_BALANCE余额不足以支付本次调用。请在控制台充值。
404NOT_FOUND账号、帖子或分组不存在,或为私密、已删除、有年龄限制。
429MARKETPLACE_SATURATED并发调用过多。请等待 Retry-After 秒后重试。
502UPSTREAM_ERROR平台返回了无法使用的内容。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格 每次调用 $0.001。标价;单日调用超过 1,000 次后单价下调。

本页内容