Lấy người dùng theo tên | Tài liệu API

# Get User By Username

Query a Twitter user profile by username and return a normalized X API v2-style user object.

GET https://api.apihop.ai/v1/twitter/users

Use `username` to query a user profile. This endpoint is useful when you only know a username and need the normalized `data.id` for timeline requests.

```text
GET https://api.apihop.ai/v1/twitter/users
```

## Authentication

All Twitter API endpoints require Bearer Token authentication.

```http
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

### `username` (string, required)

Twitter username. Both `elonmusk` and `@elonmusk` are accepted; the leading `@` is removed server-side.

### `user.fields` (string)

Comma-separated user fields, such as `created_at,description,public_metrics,verified`.

## Request Example

```bash
curl --request GET \
  "$API_BASE_URL/v1/twitter/users?username=elonmusk&user.fields=created_at,description,public_metrics,verified" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Response

### `data` (object, required)

Normalized user object.

### data fields

### `id` (string, required)

Unique user identifier. Prefer this value for timeline queries.

### `name` (string, required)

Display name.

### `username` (string, required)

Username without `@`.

### `created_at` (string)

ISO 8601 timestamp, returned when `user.fields=created_at` is requested.

### `description` (string)

User bio.

### `entities` (object)

Profile entities, such as URL descriptions and links.

### `location` (string)

Location in the user profile.

### `pinned_tweet_id` (string)

ID of the pinned tweet.

### `profile_banner_url` (string)

Profile banner URL.

### `profile_image_url` (string)

Profile image URL.

### `protected` (boolean)

Whether the account is protected.

### `public_metrics` (object)

Public user metrics.

### public_metrics fields

### `followers_count` (integer)

Number of followers.

### `following_count` (integer)

Number of accounts followed.

### `tweet_count` (integer)

Total number of tweets.

### `listed_count` (integer)

Number of lists containing the user. May be absent when the data source does not provide it.

### `url` (string)

Website URL in the user profile.

### `verified` (boolean)

Whether the account is verified.

### `verified_type` (string)

Verification type, such as `Business`.

### Success Example

```json
{
  "data": {
    "id": "44196397",
    "name": "Elon Musk",
    "username": "elonmusk",
    "created_at": "2009-06-02T20:12:29.000Z",
    "description": "Mars and cars",
    "public_metrics": {
      "followers_count": 10,
      "following_count": 20,
      "tweet_count": 40
    },
    "verified": true
  }
}
```

## Error Response

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for the full code reference, protocol differences, and diagnostic steps.

```json
{
  "success": false,
  "error": {
    "code": 40000,
    "message": "Insufficient credit. Required: 100000, Available: 99999"
  },
  "requestId": "req_xxx"
}
```

## Usage Tips

- If you only know `username`, call this endpoint first
- If you plan to query a timeline, use the returned `data.id`
- If you only need avatar, bio, or follower counts, pass `user.fields` explicitly

Dùng username để truy vấn hồ sơ người dùng. Điểm cuối hữu ích khi chỉ biết tên người dùng và cần data.id chuẩn hóa cho yêu cầu dòng thời gian.

text

GET https://api.apihop.ai/v1/twitter/users

Xác thực

Mọi điểm cuối API Twitter cần xác thực Bearer Token.

http

Authorization: Bearer YOUR_API_KEY

Tham số truy vấn

usernamestringbắt buộc

Tên người dùng Twitter. Chấp nhận cả elonmusk và @elonmusk; dấu @ đầu bị loại ở máy chủ.

user.fieldsstring

Trường người dùng phân cách dấu phẩy, như created_at,description,public_metrics,verified.

Ví dụ yêu cầu

bash

curl --request GET \
  "$API_BASE_URL/v1/twitter/users?username=elonmusk&user.fields=created_at,description,public_metrics,verified" \
  --header "Authorization: Bearer YOUR_API_KEY"

Phản hồi

dataobjectbắt buộc

Đối tượng người dùng chuẩn hóa.

Các trường data

idstringbắt buộc

Mã định danh người dùng duy nhất. Ưu tiên giá trị này cho truy vấn dòng thời gian.

namestringbắt buộc

Tên hiển thị.

usernamestringbắt buộc

Tên người dùng không có @.

created_atstring

Dấu thời gian ISO 8601, trả khi yêu cầu user.fields=created_at.

descriptionstring

Tiểu sử người dùng.

entitiesobject

Thực thể hồ sơ, như mô tả URL và liên kết.

locationstring

Vị trí trong hồ sơ người dùng.

pinned_tweet_idstring

ID bài đăng ghim.

profile_banner_urlstring

URL ảnh bìa hồ sơ.

profile_image_urlstring

URL ảnh hồ sơ.

protectedboolean

Tài khoản có được bảo vệ không.

public_metricsobject

Chỉ số người dùng công khai.

Các trường public_metrics

followers_countinteger

Số người theo dõi.

following_countinteger

Số tài khoản đang theo dõi.

tweet_countinteger

Tổng số bài đăng.

listed_countinteger

Số danh sách chứa người dùng. Có thể vắng mặt khi nguồn dữ liệu không cung cấp.

urlstring

URL website trong hồ sơ người dùng.

verifiedboolean

Tài khoản có được xác minh không.

verified_typestring

Loại xác minh, như Business.

Ví dụ thành công

json

{
  "data": {
    "id": "44196397",
    "name": "Elon Musk",
    "username": "elonmusk",
    "created_at": "2009-06-02T20:12:29.000Z",
    "description": "Mars and cars",
    "public_metrics": {
      "followers_count": 10,
      "following_count": 20,
      "tweet_count": 40
    },
    "verified": true
  }
}

Phản hồi lỗi

Xem Mã lỗi và khắc phục để có tham chiếu mã đầy đủ, khác biệt giao thức và bước chẩn đoán.

json

{
  "success": false,
  "error": {
    "code": 40000,
    "message": "Insufficient credit. Required: 100000, Available: 99999"
  },
  "requestId": "req_xxx"
}

Mẹo sử dụng

Nếu chỉ biết username, gọi điểm cuối này trước
Nếu định truy vấn dòng thời gian, dùng data.id trả về
Nếu chỉ cần ảnh đại diện, tiểu sử hoặc số người theo dõi, truyền rõ user.fields