API 文档

BASE URLhttps://redfox.hk

暂无可用的 API 平台

X(Twitter)获取用户发帖

最低 ¥0.03/次起即将上线需配置 API Key

根据用户名或用户ID获取用户时间线，支持游标分页

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/x/userTimeline

API 密钥获取与配置

获取密钥

调用 API 前，请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段，密钥用于身份校验与额度计费。

获取步骤

前往控制台页面，进入 API 密钥管理模块。
若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/x/userTimeline

请求头

名称	类型	必填	说明	示例
REDFOX_API_KEY	string	否		ak_c4fc9018ffb14ce4ae35dafd92f466c3
Content-Type	string	是	请求体数据类型	application/json

请求参数

参数	类型	必填	说明	示例
screenName	string	否	用户名，例如：elonmusk，可以从用户主页链接中获取，例如：https://twitter.com/elonmusk 中的 elonmusk。,	elonmusk
restId	string	否	用户ID（如 44196397），传入后会忽略 screenName	44196397
cursor	string	否	游标，默认为None，用于翻页，后续从上一次请求的返回结果中获取

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`（以实际服务为准）。

响应字段

字段	类型	说明	示例
code	integer	响应状态码，2000表示成功	2000
msg	string	响应消息	成功
data	object
nextCursor	string	下一页游标，翻页时传入	DAAHCgABHS4hnD-__-oLAAIAAAAT...
pinned	object	置顶推文，无置顶时为null
author	object	推文作者信息
avatar	null	作者头像，时间线中可能为null
displayName	null	作者显示名称，可能为null
followers	null	作者粉丝数，可能为null
userId	string	作者唯一ID	44196397
username	null	作者handle，可能为null
verified	boolean	是否认证账号	true
bookmarkCount	integer	收藏数	1686
createdAt	string	发布时间	Tue Sep 22 01:23:58 +0000 2026
isSensitive	boolean	是否为敏感内容	false
language	string	推文语言代码	en
likeCount	integer	点赞数	31174
medias	object	媒体资源，无媒体时为null
photos	array	图片列表
height	integer	图片高度（像素）	769
mediaId	string	媒体唯一ID	2102207237351464960
url	string	图片URL	https://pbs.twimg.com/media/HSyKWCqW4AA5Ubh.jpg
width	integer	图片宽度（像素）	1200
videos	array	视频列表，无视频时为空数组
quoteCount	integer	引用推文数	365
quoted	null	被引用的推文，非引用推文时为null
replyCount	integer	回复数
retweetCount	integer	转发数
retweetedTweet	null	转发推文
text	string	原始推文正文	日本でのStarlinkの導入が...
tweetId	string	原始推文ID	2102591025068052721
viewCount	string	浏览量，字符串类型	67012
prevCursor	string	上一页游标	DAAHCgABHS4hnD_AJxELAAIAAAAT...
timeline	array	时间线推文列表，按时间倒序
user	object	查询目标用户信息
description	null	用户个人简介，可能为null
following	null	关注数，可能为null
isProtected	boolean	是否为受保护（私密）账号	false
location	string	用户所在地，可能为空字符串
mediaCount	null	媒体发布数，可能为null
tweetCount	null	推文总数，可能为null
website	null	个人网站链接，可能为null

请求示例

# 暂无示例

响应示例

{
  "code": 2000,
  "data": {
    "nextCursor": "DAAHCgABHS4hnD-__-oLAAIAAAAT...",
    "prevCursor": "DAAHCgABHS4hnD_AJxELAAIAAAAT...",
    "user": {
      "avatar": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg",
      "createdAt": "Tue Jun 02 20:12:29 +0000 2009",
      "description": null,
      "displayName": "Elon Musk",
      "followers": null,
      "following": null,
      "isProtected": false,
      "location": "",
      "mediaCount": null,
      "tweetCount": null,
      "userId": "44196397",
      "username": "elonmusk",
      "verified": true,
      "website": null
    },
    "pinned": {
      "author": {
        "avatar": null,
        "displayName": null,
        "followers": null,
        "userId": "44196397",
        "username": null,
        "verified": true
      },
      "bookmarkCount": 1686,
      "createdAt": "Tue Sep 22 01:23:58 +0000 2026",
      "isSensitive": false,
      "language": "en",
      "likeCount": 31174,
      "medias": {
        "photos": [
          {
            "height": 769,
            "mediaId": "2102207237351464960",
            "url": "https://pbs.twimg.com/media/HSyKWCqW4AA5Ubh.jpg",
            "width": 1200
          }
        ],
        "videos": []
      },
      "quoteCount": 365,
      "quoted": null,
      "replyCount": 2934,
      "retweetCount": 2647,
      "retweetedTweet": null,
      "text": "Grok 4.7 https://t.co/wJvgyIPDr2",
      "tweetId": "2102207241101144450",
      "viewCount": "22149736"
    },
    "timeline": [
      {
        "author": {
          "avatar": null,
          "displayName": null,
          "followers": null,
          "userId": "44196397",
          "username": null,
          "verified": true
        },
        "bookmarkCount": 0,
        "createdAt": "Wed Sep 23 06:52:20 +0000 2026",
        "isSensitive": null,
        "language": "ja",
        "likeCount": 0,
        "medias": null,
        "quoteCount": 0,
        "quoted": null,
        "replyCount": 0,
        "retweetCount": 99,
        "retweetedTweet": {
          "author": {
            "avatar": null,
            "displayName": null,
            "followers": null,
            "userId": "1330170106501079041",
            "username": null,
            "verified": true
          },
          "bookmarkCount": 27,
          "createdAt": "Wed Sep 23 02:48:59 +0000 2026",
          "isSensitive": false,
          "language": "ja",
          "likeCount": 718,
          "medias": {
            "photos": [
              {
                "height": 800,
                "mediaId": "2102588002048618496",
                "url": "https://pbs.twimg.com/media/HS3kpdsbMAAQfgu.jpg",
                "width": 1200
              }
            ],
            "videos": []
          },
          "quoteCount": 11,
          "quoted": null,
          "replyCount": 65,
          "retweetCount": 99,
          "retweetedTweet": null,
          "text": "日本でのStarlinkの導入が...",
          "tweetId": "2102591025068052721",
          "viewCount": "67012"
        },
        "text": "RT @Starlink: 日本でのStarlinkの導入が...",
        "tweetId": "2102652267015061546",
        "viewCount": "316424"
      },
      {
        "author": {
          "avatar": null,
          "displayName": null,
          "followers": null,
          "userId": "44196397",
          "username": null,
          "verified": true
        },
        "bookmarkCount": 282,
        "createdAt": "Tue Sep 22 22:07:53 +0000 2026",
        "isSensitive": null,
        "language": "en",
        "likeCount": 8044,
        "medias": null,
        "quoteCount": 100,
        "quoted": {
          "author": {
            "avatar": null,
            "displayName": null,
            "followers": null,
            "userId": "15540222",
            "username": null,
            "verified": true
          },
          "bookmarkCount": 126,
          "createdAt": "Tue Sep 22 22:03:10 +0000 2026",
          "isSensitive": null,
          "language": "en",
          "likeCount": 1108,
          "medias": null,
          "quoteCount": 24,
          "quoted": null,
          "replyCount": 133,
          "retweetCount": 55,
          "retweetedTweet": null,
          "text": "We ran fresh Next.js evals...",
          "tweetId": "2102519097770885231",
          "viewCount": "2444733"
        },
        "replyCount": 1232,
        "retweetCount": 827,
        "retweetedTweet": null,
        "text": "Interesting. Grok 4.7 is performing fairly well for a smallish model.",
        "tweetId": "2102520283618017355",
        "viewCount": "2944537"
      }
    ]
  },
  "msg": "成功"
}

常见状态码说明

调用接口时，响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。

状态码	说明	排查建议
`400`	请求参数错误	检查请求体、Query 参数是否与文档一致，必填项是否齐全。
`401`	鉴权失败	确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY，且密钥有效、未禁用。
`403`	无权限访问	当前密钥或账号无权调用该接口，请检查密钥状态与接口权限。
`500`	系统内部错误	服务端异常，请稍后重试；持续出现请联系技术支持。
`503`	服务暂不可用	服务维护或短暂过载，请间隔一段时间后重试。
`1001`	缺少必要参数	对照「请求参数」表，补全必填字段。
`1002`	参数格式不正确	检查字段类型与格式（如 URL、日期、枚举值）是否符合说明。
`1003`	参数类型错误	确认 JSON 中数字、字符串、布尔等类型与文档定义一致。
`3103`	密钥不存在	密钥可能已删除或填写错误，请前往控制台核对并重新复制。
`3105`	API Key 已禁用	在控制台启用该密钥，或创建新密钥后替换请求头中的值。
`3201`	积分不足	账户余额不足以支付本次调用，请前往控制台充值后再试。
`3202`	积分账户不存在	账号积分账户异常，请登录控制台确认账户状态。
`4004`	操作过于频繁，请稍后再试	触发频率限制，降低请求频率或增加调用间隔后重试。

调用步骤

在请求头配置REDFOX_API_KEY或X-API-KEY
按 API 说明示例构造请求参数或请求体。
发起请求。
解析 JSON 响应中的 code、message 与 data 字段。

Request（示例代码，仅供参考）

bash

curl -X POST "https://redfox.hk/story/api/x/userTimeline" \
  -H "REDFOX_API_KEY: your_api_key" \
  -H "REDFOX_API_KEY: ak_c4fc9018ffb14ce4ae35dafd92f466c3" \
  -H "Content-Type: application/json" \
  -d '{
  "screenName": "elonmusk",
  "restId": "44196397",
  "cursor": ""
}'

Response（示例代码，仅供参考）

json

{
  "code": 2000,
  "data": {
    "nextCursor": "DAAHCgABHS4hnD-__-oLAAIAAAAT...",
    "prevCursor": "DAAHCgABHS4hnD_AJxELAAIAAAAT...",
    "user": {
      "avatar": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg",
      "createdAt": "Tue Jun 02 20:12:29 +0000 2009",
      "description": null,
      "displayName": "Elon Musk",
      "followers": null,
      "following": null,
      "isProtected": false,
      "location": "",
      "mediaCount": null,
      "tweetCount": null,
      "userId": "44196397",
      "username": "elonmusk",
      "verified": true,
      "website": null
    },
    "pinned": {
      "author": {
        "avatar": null,
        "displayName": null,
        "followers": null,
        "userId": "44196397",
        "username": null,
        "verified": true
      },
      "bookmarkCount": 1686,
      "createdAt": "Tue Sep 22 01:23:58 +0000 2026",
      "isSensitive": false,
      "language": "en",
      "likeCount": 31174,
      "medias": {
        "photos": [
          {
            "height": 769,
            "mediaId": "2102207237351464960",
            "url": "https://pbs.twimg.com/media/HSyKWCqW4AA5Ubh.jpg",
            "width": 1200
          }
        ],
        "videos": []
      },
      "quoteCount": 365,
      "quoted": null,
      "replyCount": 2934,
      "retweetCount": 2647,
      "retweetedTweet": null,
      "text": "Grok 4.7 https://t.co/wJvgyIPDr2",
      "tweetId": "2102207241101144450",
      "viewCount": "22149736"
    },
    "timeline": [
      {
        "author": {
          "avatar": null,
          "displayName": null,
          "followers": null,
          "userId": "44196397",
          "username": null,
          "verified": true
        },
        "bookmarkCount": 0,
        "createdAt": "Wed Sep 23 06:52:20 +0000 2026",
        "isSensitive": null,
        "language": "ja",
        "likeCount": 0,
        "medias": null,
        "quoteCount": 0,
        "quoted": null,
        "replyCount": 0,
        "retweetCount": 99,
        "retweetedTweet": {
          "author": {
            "avatar": null,
            "displayName": null,
            "followers": null,
            "userId": "1330170106501079041",
            "username": null,
            "verified": true
          },
          "bookmarkCount": 27,
          "createdAt": "Wed Sep 23 02:48:59 +0000 2026",
          "isSensitive": false,
          "language": "ja",
          "likeCount": 718,
          "medias": {
            "photos": [
              {
                "height": 800,
                "mediaId": "2102588002048618496",
                "url": "https://pbs.twimg.com/media/HS3kpdsbMAAQfgu.jpg",
                "width": 1200
              }
            ],
            "videos": []
          },
          "quoteCount": 11,
          "quoted": null,
          "replyCount": 65,
          "retweetCount": 99,
          "retweetedTweet": null,
          "text": "日本でのStarlinkの導入が...",
          "tweetId": "2102591025068052721",
          "viewCount": "67012"
        },
        "text": "RT @Starlink: 日本でのStarlinkの導入が...",
        "tweetId": "2102652267015061546",
        "viewCount": "316424"
      },
      {
        "author": {
          "avatar": null,
          "displayName": null,
          "followers": null,
          "userId": "44196397",
          "username": null,
          "verified": true
        },
        "bookmarkCount": 282,
        "createdAt": "Tue Sep 22 22:07:53 +0000 2026",
        "isSensitive": null,
        "language": "en",
        "likeCount": 8044,
        "medias": null,
        "quoteCount": 100,
        "quoted": {
          "author": {
            "avatar": null,
            "displayName": null,
            "followers": null,
            "userId": "15540222",
            "username": null,
            "verified": true
          },
          "bookmarkCount": 126,
          "createdAt": "Tue Sep 22 22:03:10 +0000 2026",
          "isSensitive": null,
          "language": "en",
          "likeCount": 1108,
          "medias": null,
          "quoteCount": 24,
          "quoted": null,
          "replyCount": 133,
          "retweetCount": 55,
          "retweetedTweet": null,
          "text": "We ran fresh Next.js evals...",
          "tweetId": "2102519097770885231",
          "viewCount": "2444733"
        },
        "replyCount": 1232,
        "retweetCount": 827,
        "retweetedTweet": null,
        "text": "Interesting. Grok 4.7 is performing fairly well for a smallish model.",
        "tweetId": "2102520283618017355",
        "viewCount": "2944537"
      }
    ]
  },
  "msg": "成功"
}