v0.2.0-beta

OpenAPI 3.1.0

获取列表推文时间线

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

Twitter / X

Query public users, posts, communities and trends.

Twitter / X 操作

get/v1/beta/twitter/list/tweets_timeline

获取列表推文时间线

按 listId 获取 X 列表的推文时间线，每页最多 20 条，使用游标分页。返回推文以及 has_next_page 和 next_cursor。要查看列表中的成员，请使用 get_twitter_list_members。

计费参考

计量方式：按成功请求的固定成本计费。
参考请求估算：0.0015 美元。
参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

查询参数

cursor
类型: string
listId
类型: string

响应

200
类型: object · ResponseA06878E34984_ListTweetsTimelineResponse

列表推文时间线响应
has_next_page
类型: boolean

表示是否还有更多结果

msg
类型: string

请求的消息；当 status 为 error 时为错误消息

next_cursor
类型: string

用于获取下一页结果的游标

status
类型: string 枚举

请求状态

值
success
error
tweets
类型: array object[] · ResponseA06878E34984_Tweet[]

列表中的推文数组

author
类型: object · ResponseA06878E34984_TwitterUser
automatedBy
类型: string

表示账号的自动化操作者

canDm
类型: boolean

表示用户是否可接收私信

coverPicture
类型: string

封面图片的 URL

createdAt
类型: string

账号创建日期

description
类型: string

用户描述

favouritesCount
类型: integer

收藏数

followers
类型: integer

关注者数

following
类型: integer

关注数

hasCustomTimelines
类型: boolean

表示用户是否有自定义时间线

id
类型: string

用户 ID

isAutomated
类型: boolean

表示账号是否为自动化账号

isBlueVerified
类型: boolean

表示用户是否通过蓝标认证

isTranslator
类型: boolean

表示用户是否为译者

location
类型: string

用户所在地

mediaCount
类型: integer

媒体项数量

message
类型: string

关于该账号的消息

name
类型: string

用户名

pinnedTweetIds
类型: array string[]

置顶推文 ID 列表

possiblySensitive
类型: boolean

表示用户是否有敏感内容

profile_bio
类型: object
description
类型: string

个人简介

entities
类型: object
description
类型: object
urls
类型: array object[] · ResponseA06878E34984_TwitterUrl[]
display_url
类型: string

显示用 URL

expanded_url
类型: string

展开后的 URL

indices
类型: array integer[]

URL 的索引位置

url
类型: string

URL

url
类型: object
urls
类型: array object[] · ResponseA06878E34984_TwitterUrl[]
display_url
类型: string

显示用 URL

expanded_url
类型: string

展开后的 URL

indices
类型: array integer[]

URL 的索引位置

url
类型: string

URL

profilePicture
类型: string

头像图片的 URL

statusesCount
类型: integer

状态数量

type
类型: string

用户类型

unavailable
类型: boolean

表示账号是否不可用

unavailableReason
类型: string

不可用原因

url
类型: string

用户个人资料的 URL

userName
类型: string

用户的用户名

verifiedType
类型: string

验证类型

withheldInCountries
类型: array string[]

用户被限制的国家/地区列表

bookmarkCount
类型: integer

Integer numbers.

conversationId
类型: string
createdAt
类型: string

推文的创建日期和时间

id
类型: string

推文的 ID

inReplyToId
类型: string
inReplyToUserId
类型: string
inReplyToUsername
类型: string
isReply
类型: boolean
lang
类型: string

推文的语言

likeCount
类型: integer

Integer numbers.

quoteCount
类型: integer

Integer numbers.

replyCount
类型: integer

Integer numbers.

retweetCount
类型: integer

Integer numbers.

source
类型: string

推文的来源客户端

text
类型: string

推文文本

type
类型: string
url
类型: string

推文的 URL

viewCount
类型: integer

Integer numbers.
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

由于未满足计费要求，请求无法继续。
403

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

错误响应；上游透传响应可能采用提供方格式

application/json

get/v1/beta/twitter/list/tweets_timeline

curl https://openapi.felo.ai/v1/beta/twitter/list/tweets_timeline \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

显示 Schema

{
  "tweets": [
    {
      "type": "string",
      "id": "string",
      "url": "string",
      "text": "string",
      "source": "string",
      "retweetCount": 1,
      "replyCount": 1,
      "likeCount": 1,
      "quoteCount": 1,
      "viewCount": 1,
      "createdAt": "string",
      "lang": "string",
      "bookmarkCount": 1,
      "isReply": true,
      "inReplyToId": "string",
      "conversationId": "string",
      "inReplyToUserId": "string",
      "inReplyToUsername": "string",
      "author": {
        "type": "string",
        "userName": "string",
        "url": "string",
        "id": "string",
        "name": "string",
        "isBlueVerified": true,
        "verifiedType": "string",
        "profilePicture": "string",
        "coverPicture": "string",
        "description": "string",
        "location": "string",
        "followers": 1,
        "following": 1,
        "canDm": true,
        "createdAt": "string",
        "favouritesCount": 1,
        "hasCustomTimelines": true,
        "isTranslator": true,
        "mediaCount": 1,
        "statusesCount": 1,
        "withheldInCountries": [
          "string"
        ],
        "possiblySensitive": true,
        "pinnedTweetIds": [
          "string"
        ],
        "isAutomated": true,
        "automatedBy": "string",
        "unavailable": true,
        "message": "string",
        "unavailableReason": "string",
        "profile_bio": {
          "description": "string",
          "entities": {
            "description": {
              "urls": [
                {
                  "display_url": "string",
                  "expanded_url": "string",
                  "indices": [
                    1
                  ],
                  "url": "string"
                }
              ]
            },
            "url": {
              "urls": [
                {
                  "display_url": "string",
                  "expanded_url": "string",
                  "indices": [
                    1
                  ],
                  "url": "string"
                }
              ]
            }
          }
        }
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "string",
  "status": "success",
  "msg": "string"
}

列表推文时间线响应

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

获取列表推文时间线

身份验证Required

Twitter / X

获取列表推文时间线

计费参考

需要帮助？