Felo API PlatformFelo API Platform
全部 X 端點
v0.2.0-beta
OpenAPI 3.1.0

取得清單成員

伺服器:https://openapi.felo.ai
用戶端程式庫

Twitter / X

​

Query public users, posts, communities and trends.

取得清單成員

​

列出 X 清單中包含的帳號,每頁 20 個,以游標分頁。用它取得現成、由人工精選的群體——篩選工作已由他人完成。完整的使用者物件位於 members 之下。若要以單一動態牆讀取這些帳號的貼文,請使用 get_twitter_list_tweets_timeline。清單的訂閱者請使用 get_twitter_list_followers。

計費參考

  • 計量方式:以成功請求為固定成本基礎。
  • 參考請求估算:0.0015 美元。
  • 參考客戶乘數:1.0。不得再次套用於已結算的客戶金額。

僅供參考的中繼資料,並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。

查詢參數
  • cursor
    類型: string

    頁面游標

  • list_id
    類型: string
    必填

    清單 ID

回應
  • 200
    類型: object · ResponseA06878E34984_TwitterListMembersResponse

    清單成員回應

    • has_next_page
      類型: boolean

      指出是否還有更多結果

    • members
      類型: array 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[]

        使用者被限制的國家/地區清單

    • msg
      類型: string

      請求的訊息;當 status 為 error 時為錯誤訊息

    • next_cursor
      類型: string

      用於取得下一頁結果的游標

    • status
      類型: string 列舉

      請求狀態

      值
      • success
      • error
    application/json
  • 400

    無法處理該要求。請檢查請求參數。

  • 401

    需要有效的 Felo API 金鑰。

  • 402

    由於未符合計費要求,要求無法繼續。

  • 403

    該帳戶無權執行此操作。

  • 429

    已達到要求或支出上限。

  • 502

    服務無法完成該要求。

  • 503

    API 或計費服務暫時無法使用。

  • 504

    服務在處理要求時逾時。

  • default

    錯誤回應;上游透傳回應可能採用供應商格式

    application/json
Request Example for get/v1/beta/twitter/list/members
curl 'https://openapi.felo.ai/v1/beta/twitter/list/members?list_id=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "members": [
    {
      "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"
}
Get List Members

需要協助嗎?