# 사용자 최근 트윗 가져오기

**API:** Data API

**Endpoint:** `GET /v1/beta/twitter/user/last_tweets`

**Tags:** Twitter / X

`userName`(@handle) 또는 `userId`를 받아 사용자의 최신 트윗을 가져옵니다. 핸들을 아직 ID로 확인하지 않았을 때 유용합니다. 선택적으로 답글을 포함할 수 있습니다. 커서로 페이지를 매깁니다. `data` 아래에 `has_next_page`와 `next_cursor`가 포함된 트윗을 반환합니다. 숫자 ID가 이미 있고 상위 트윗 확장이 포함된 전체 프로필 순서 타임라인이 필요하면 `get_twitter_user_tweet_timeline`을 사용하세요.

### 가격 참고

- 과금 기준: 측정된 결과 수.
- 참고 요청 추정치: USD 0.003.
- 최소 원가 기준: 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 |
| --- | --- | --- | --- | --- |
| `count` | query | no | string |  |
| `cursor` | query | no | string |  |
| `includeReplies` | query | no | string |  |
| `userId` | query | no | string |  |
| `userName` | query | no | string | X username (the part after @), for example OpenAI. |

## Responses

### 200 — 사용자 트윗

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

**application/json**

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

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseAd3D19335Ae4_UserTweetsResponse

`#/components/schemas/ResponseAd3D19335Ae4_UserTweetsResponse`

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "code": {
      "type": "integer",
      "description": "제공자 상태 코드입니다."
    },
    "msg": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "tweets": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "X에서 반환된 트윗 객체입니다."
          }
        },
        "pin_tweet": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "has_next_page": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
```