# 트윗 스레드 컨텍스트 가져오기

**API:** Data API

**Endpoint:** `GET /v1/beta/twitter/tweet/thread_context`

**Tags:** Twitter / X

트윗 주변의 대화를 재구성합니다. 답글이나 원본 트윗을 모두 받아 주변 스레드를 반환하며 커서로 페이지를 매깁니다. 트윗 자체에 맥락이 부족해 상위 체인이 필요할 때 사용하세요. `tweets` 아래에 `has_next_page`와 `next_cursor`가 포함된 트윗을 반환합니다. 게시물 아래의 답글만 보려면 `get_twitter_tweet_replies_v2`를 사용하세요.

### 가격 참고

- 과금 기준: 측정된 결과 수.
- 참고 요청 추정치: USD 0.00555.
- 최소 원가 기준: USD 0.00015.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
- 원가 기준은 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 |  |
| `tweetId` | query | no | string |  |

## Responses

### 200 — 성공 응답

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: `ResponseCbc4F8806E32_TweetThreadContextResponse` (`#/components/schemas/ResponseCbc4F8806E32_TweetThreadContextResponse`)

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseCbc4F8806E32_Entities

`#/components/schemas/ResponseCbc4F8806E32_Entities`

```json
{
  "type": "object",
  "properties": {
    "hashtags": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "indices": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          "text": {
            "type": "string"
          }
        }
      }
    },
    "urls": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "display_url": {
            "type": "string"
          },
          "expanded_url": {
            "type": "string"
          },
          "indices": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          "url": {
            "type": "string"
          }
        }
      }
    },
    "user_mentions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id_str": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "screen_name": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### ResponseCbc4F8806E32_Tweet

`#/components/schemas/ResponseCbc4F8806E32_Tweet`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "retweetCount": {
      "type": "integer"
    },
    "replyCount": {
      "type": "integer"
    },
    "likeCount": {
      "type": "integer"
    },
    "quoteCount": {
      "type": "integer"
    },
    "viewCount": {
      "type": "integer"
    },
    "createdAt": {
      "type": "string"
    },
    "lang": {
      "type": "string"
    },
    "bookmarkCount": {
      "type": "integer"
    },
    "isReply": {
      "type": "boolean"
    },
    "inReplyToId": {
      "type": "string"
    },
    "conversationId": {
      "type": "string"
    },
    "displayTextRange": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "inReplyToUserId": {
      "type": "string"
    },
    "inReplyToUsername": {
      "type": "string"
    },
    "author": {
      "$ref": "#/components/schemas/ResponseCbc4F8806E32_User"
    },
    "entities": {
      "$ref": "#/components/schemas/ResponseCbc4F8806E32_Entities"
    },
    "quoted_tweet": {
      "type": "string"
    },
    "retweeted_tweet": {
      "type": "string"
    },
    "isLimitedReply": {
      "type": "boolean"
    }
  }
}
```

### ResponseCbc4F8806E32_TweetThreadContextResponse

`#/components/schemas/ResponseCbc4F8806E32_TweetThreadContextResponse`

```json
{
  "type": "object",
  "properties": {
    "has_next_page": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "tweets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseCbc4F8806E32_Tweet"
      }
    },
    "msg": {
      "type": "string"
    }
  }
}
```

### ResponseCbc4F8806E32_User

`#/components/schemas/ResponseCbc4F8806E32_User`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "userName": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "isBlueVerified": {
      "type": "boolean"
    },
    "verifiedType": {
      "type": "string"
    },
    "profilePicture": {
      "type": "string"
    },
    "coverPicture": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "followers": {
      "type": "integer"
    },
    "following": {
      "type": "integer"
    },
    "canDm": {
      "type": "boolean"
    },
    "createdAt": {
      "type": "string"
    },
    "favouritesCount": {
      "type": "integer"
    },
    "hasCustomTimelines": {
      "type": "boolean"
    },
    "isTranslator": {
      "type": "boolean"
    },
    "mediaCount": {
      "type": "integer"
    },
    "statusesCount": {
      "type": "integer"
    },
    "withheldInCountries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "possiblySensitive": {
      "type": "boolean"
    },
    "pinnedTweetIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "isAutomated": {
      "type": "boolean"
    },
    "automatedBy": {
      "type": "string"
    },
    "unavailable": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "unavailableReason": {
      "type": "string"
    }
  }
}
```