# 리스트 트윗 타임라인 가져오기 **API:** Data API **Endpoint:** `GET /v1/beta/twitter/list/tweets_timeline` **Tags:** Twitter / X `listId`로 X 리스트의 트윗 타임라인을 가져오며, 페이지당 최대 20개이고 커서로 페이지를 매깁니다. `has_next_page`와 `next_cursor`가 포함된 트윗을 반환합니다. 리스트에 누가 있는지 보려면 `get_twitter_list_members`를 사용하세요. ### 가격 참고 - 과금 기준: 성공한 요청당 고정 원가 기준. - 참고 요청 추정치: USD 0.0015. - 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요. 참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `cursor` | query | no | string | | | `listId` | query | no | string | | ## Responses ### 200 — 리스트 트윗 타임라인 응답 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: `ResponseA06878E34984_ListTweetsTimelineResponse` (`#/components/schemas/ResponseA06878E34984_ListTweetsTimelineResponse`) ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseA06878E34984_ListTweetsTimelineResponse `#/components/schemas/ResponseA06878E34984_ListTweetsTimelineResponse` ```json { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_Tweet" }, "description": "목록의 트윗 배열" }, "has_next_page": { "type": "boolean", "description": "더 많은 결과가 있는지 여부를 나타냅니다" }, "next_cursor": { "type": "string", "description": "다음 결과 페이지를 가져오기 위한 커서" }, "status": { "type": "string", "enum": [ "success", "error" ], "example": "success", "description": "요청 상태" }, "msg": { "type": "string", "description": "요청 메시지, status가 error이면 오류 메시지" } } } ``` ### ResponseA06878E34984_Tweet `#/components/schemas/ResponseA06878E34984_Tweet` ```json { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string", "description": "트윗 ID" }, "url": { "type": "string", "description": "트윗 URL" }, "text": { "type": "string", "description": "트윗 텍스트" }, "source": { "type": "string", "description": "트윗의 소스 클라이언트" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string", "description": "트윗이 생성된 날짜와 시간" }, "lang": { "type": "string", "description": "트윗 언어" }, "bookmarkCount": { "type": "integer" }, "isReply": { "type": "boolean" }, "inReplyToId": { "type": "string" }, "conversationId": { "type": "string" }, "inReplyToUserId": { "type": "string" }, "inReplyToUsername": { "type": "string" }, "author": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUser" } } } ``` ### ResponseA06878E34984_TwitterUrl `#/components/schemas/ResponseA06878E34984_TwitterUrl` ```json { "type": "object", "properties": { "display_url": { "type": "string", "description": "표시 URL" }, "expanded_url": { "type": "string", "description": "확장 URL" }, "indices": { "type": "array", "items": { "type": "integer" }, "description": "URL 인덱스" }, "url": { "type": "string", "description": "URL" } } } ``` ### ResponseA06878E34984_TwitterUser `#/components/schemas/ResponseA06878E34984_TwitterUser` ```json { "type": "object", "properties": { "type": { "type": "string", "description": "사용자 유형" }, "userName": { "type": "string", "description": "사용자의 사용자 이름" }, "url": { "type": "string", "description": "사용자 프로필의 URL" }, "id": { "type": "string", "description": "사용자 ID" }, "name": { "type": "string", "description": "사용자 이름" }, "isBlueVerified": { "type": "boolean", "description": "사용자가 블루 인증되었는지 나타냅니다" }, "verifiedType": { "type": "string", "description": "인증 유형" }, "profilePicture": { "type": "string", "description": "프로필 사진 URL" }, "coverPicture": { "type": "string", "description": "커버 사진 URL" }, "description": { "type": "string", "description": "사용자 설명" }, "location": { "type": "string", "description": "사용자 위치" }, "followers": { "type": "integer", "description": "팔로워 수" }, "following": { "type": "integer", "description": "팔로잉 수" }, "canDm": { "type": "boolean", "description": "사용자가 다이렉트 메시지를 받을 수 있는지 나타냅니다" }, "createdAt": { "type": "string", "description": "계정 생성 날짜" }, "favouritesCount": { "type": "integer", "description": "즐겨찾기 수" }, "hasCustomTimelines": { "type": "boolean", "description": "사용자가 맞춤 타임라인을 갖는지 나타냅니다" }, "isTranslator": { "type": "boolean", "description": "사용자가 번역자인지 나타냅니다" }, "mediaCount": { "type": "integer", "description": "미디어 항목 수" }, "statusesCount": { "type": "integer", "description": "상태 수" }, "withheldInCountries": { "type": "array", "items": { "type": "string" }, "description": "사용자가 제한된 국가 목록" }, "possiblySensitive": { "type": "boolean", "description": "사용자에게 민감한 콘텐츠가 있는지 나타냅니다" }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" }, "description": "고정된 트윗 ID 목록" }, "isAutomated": { "type": "boolean", "description": "계정 자동화 여부를 나타냅니다" }, "automatedBy": { "type": "string", "description": "계정을 자동화한 주체를 나타냅니다" }, "unavailable": { "type": "boolean", "description": "계정을 사용할 수 없는지 여부를 나타냅니다." }, "message": { "type": "string", "description": "계정에 대한 메시지" }, "unavailableReason": { "type": "string", "description": "사용할 수 없는 이유" }, "profile_bio": { "type": "object", "properties": { "description": { "type": "string", "description": "바이오 설명" }, "entities": { "type": "object", "properties": { "description": { "type": "object", "properties": { "urls": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl" } } } }, "url": { "type": "object", "properties": { "urls": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl" } } } } } } } } } } ```