# 사용자 정보 가져오기

**API:** Data API

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

**Tags:** Twitter / X

@handle(스크린 이름)로 X(Twitter) 사용자 한 명의 공개 프로필을 조회합니다. 계정이 누구인지(정체성, 도달 범위, 신뢰도)를 알고 콘텐츠를 신뢰하거나 분석할지 결정하기 전에 사용하세요. 표시 이름, 바이오, 팔로워/팔로잉 수, 인증 상태, 계정 생성일, 위치, 프로필 이미지를 반환합니다. 숫자 사용자 ID만 있으면 `get_twitter_user_batch_info_by_ids`를 사용하세요. 국가나 사용자 이름 변경 이력 같은 확장 프로필 메타데이터가 필요하면 `get_twitter_user_about`을 사용하세요. 프로필이 아니라 게시물이 필요하면 `get_twitter_user_tweet_timeline`을 사용하세요.

### 가격 참고

- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.00018.
- 참고 고객 배수: 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 |
| --- | --- | --- | --- | --- |
| `userName` | query | no | string | X username (the part after @), for example OpenAI. |

## Responses

### 200 — 사용자 정보

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

**application/json**

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

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseAd3D19335Ae4_UserInfoResponse

`#/components/schemas/ResponseAd3D19335Ae4_UserInfoResponse`

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "msg": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "additionalProperties": true,
      "description": "X에서 반환된 사용자 프로필 객체입니다."
    }
  }
}
```