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

取得清單推文時間軸

計費參考

需要協助嗎？