Lấy dòng thời gian người dùng | Tài liệu API

# Get User Timeline

Query a Twitter user's timeline by user ID and return normalized tweets, author expansions, and pagination metadata.

GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

Query a user's timeline by normalized user ID. The endpoint returns X API v2-style `data / includes / meta` structures.

```text
GET https://api.apihop.ai/v1/twitter/users/{id}/tweets
```

## Authentication

All Twitter API endpoints require Bearer Token authentication.

```http
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

### `id` (string, required)

Twitter user ID, such as `44196397`.

## Query Parameters

### `max_results` (integer, Default: 10)

Number of tweets to return in one page, from `1` to `100`.

### `pagination_token` (string)

Cursor for the next page, copied from the previous response's `meta.next_token`.

### `exclude` (string)

Comma-separated exclusion policy. Supported values include `replies` and `retweets`.

### `expansions` (string)

Comma-separated expansion fields. Use `author_id` to include `includes.users`.

### `tweet.fields` (string)

Comma-separated tweet fields, such as `created_at,public_metrics,attachments,source`.

### `user.fields` (string)

Controls fields in `includes.users` when `expansions=author_id` is requested.

## Request Example

```bash
curl --request GET \
  "$API_BASE_URL/v1/twitter/users/44196397/tweets?max_results=5&exclude=retweets,replies&expansions=author_id&tweet.fields=created_at,public_metrics,attachments,author_id,conversation_id&user.fields=public_metrics" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Response

### `data` (object[], required)

Timeline tweet list.

### Tweet fields

### `id` (string, required)

Tweet ID.

### `text` (string, required)

Tweet text content.

### `attachments` (object)

Media references, currently returned as `media_keys`.

### `author_id` (string)

Author ID. When `expansions=author_id` is requested, it corresponds to `includes.users`.

### `conversation_id` (string)

Conversation ID.

### `created_at` (string)

Tweet creation time in ISO 8601 format.

### `edit_history_tweet_ids` (string[])

Tweet IDs in the edit history.

### `entities` (object)

Parsed tweet entities, such as hashtags, URLs, and mentions.

### `in_reply_to_user_id` (string)

ID of the user being replied to.

### `lang` (string)

Tweet language.

### `possibly_sensitive` (boolean)

Whether the content is sensitive.

### `public_metrics` (object)

Public tweet metrics.

### public_metrics fields

### `retweet_count` (integer)

Number of retweets.

### `reply_count` (integer)

Number of replies.

### `like_count` (integer)

Number of likes.

### `quote_count` (integer)

Number of quotes.

### `bookmark_count` (integer)

Number of bookmarks.

### `impression_count` (integer)

Number of impressions.

### `referenced_tweets` (object[])

Referenced tweets. `type` may be `retweeted`, `quoted`, or `replied_to`.

### `source` (string)

Tweet source, such as a client or the Web.

### `includes` (object)

Expanded objects. Appears when `expansions` includes `author_id`.

### includes fields

### `users` (object[])

Author list corresponding to `author_id`.

### `meta` (object, required)

Pagination and result metadata.

### meta fields

### `newest_id` (string)

Newest tweet ID in the current page.

### `oldest_id` (string)

Oldest tweet ID in the current page.

### `next_token` (string)

Cursor for the next page. Send it as `pagination_token`.

### `result_count` (integer, required)

Number of tweets in the current page.

### Success Example

```json
{
  "data": [
    {
      "id": "tweet-1",
      "text": "Hello Mars",
      "author_id": "44196397",
      "created_at": "2025-04-22T10:00:00.000Z",
      "public_metrics": {
        "retweet_count": 3,
        "reply_count": 2,
        "like_count": 7
      }
    }
  ],
  "includes": {
    "users": [
      {
        "id": "44196397",
        "name": "Elon Musk",
        "username": "elonmusk"
      }
    ]
  },
  "meta": {
    "newest_id": "tweet-1",
    "oldest_id": "tweet-1",
    "next_token": "cursor-123",
    "result_count": 1
  }
}
```

## 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"
}
```

## Pagination

If `meta.next_token` is present, pass it as `pagination_token` to fetch the next page.

Truy vấn dòng thời gian người dùng bằng ID chuẩn hóa. Điểm cuối trả cấu trúc data / includes / meta kiểu X API v2.

text

GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

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ố đường dẫn

idstringbắt buộc

ID người dùng Twitter, như 44196397.

Tham số truy vấn

max_resultsintegerMặc định: 10

Số bài đăng trả trong một trang, từ 1 đến 100.

pagination_tokenstring

Con trỏ trang tiếp, sao chép từ meta.next_token của phản hồi trước.

excludestring

Chính sách loại trừ phân cách dấu phẩy. Giá trị hỗ trợ gồm replies và retweets.

expansionsstring

Trường mở rộng phân cách dấu phẩy. Dùng author_id để có includes.users.

tweet.fieldsstring

Trường bài đăng phân cách dấu phẩy, như created_at,public_metrics,attachments,source.

user.fieldsstring

Điều khiển trường trong includes.users khi yêu cầu expansions=author_id.

Ví dụ yêu cầu

bash

curl --request GET \
  "$API_BASE_URL/v1/twitter/users/44196397/tweets?max_results=5&exclude=retweets,replies&expansions=author_id&tweet.fields=created_at,public_metrics,attachments,author_id,conversation_id&user.fields=public_metrics" \
  --header "Authorization: Bearer YOUR_API_KEY"

Phản hồi

dataobject[]bắt buộc

Danh sách bài đăng dòng thời gian.

Các trường bài đăng

idstringbắt buộc

ID bài đăng.

textstringbắt buộc

Nội dung văn bản bài đăng.

attachmentsobject

Tham chiếu đa phương tiện, hiện trả dưới dạng media_keys.

author_idstring

ID tác giả. Khi yêu cầu expansions=author_id, trường tương ứng với includes.users.

conversation_idstring

ID hội thoại.

created_atstring

Thời gian tạo bài đăng theo ISO 8601.

edit_history_tweet_idsstring[]

ID bài đăng trong lịch sử chỉnh sửa.

entitiesobject

Thực thể bài đăng đã phân tích, như thẻ chủ đề, URL và lượt nhắc.

in_reply_to_user_idstring

ID người dùng được trả lời.

langstring

Ngôn ngữ bài đăng.

possibly_sensitiveboolean

Nội dung có nhạy cảm không.

public_metricsobject

Chỉ số bài đăng công khai.

Các trường public_metrics

retweet_countinteger

Số lượt đăng lại.

reply_countinteger

Số lượt trả lời.

like_countinteger

Số lượt thích.

quote_countinteger

Số lượt trích dẫn.

bookmark_countinteger

Số lượt đánh dấu.

impression_countinteger

Số lượt hiển thị.

referenced_tweetsobject[]

Bài đăng được tham chiếu. type có thể là retweeted, quoted hoặc replied_to.

sourcestring

Nguồn bài đăng, như máy khách hoặc Web.

includesobject

Đối tượng mở rộng. Xuất hiện khi expansions có author_id.

Các trường includes

usersobject[]

Danh sách tác giả tương ứng author_id.

metaobjectbắt buộc

Siêu dữ liệu phân trang và kết quả.

Các trường meta

newest_idstring

ID bài đăng mới nhất trên trang hiện tại.

oldest_idstring

ID bài đăng cũ nhất trên trang hiện tại.

next_tokenstring

Con trỏ trang tiếp. Gửi dưới tên pagination_token.

result_countintegerbắt buộc

Số bài đăng trên trang hiện tại.

Ví dụ thành công

json

{
  "data": [
    {
      "id": "tweet-1",
      "text": "Hello Mars",
      "author_id": "44196397",
      "created_at": "2025-04-22T10:00:00.000Z",
      "public_metrics": {
        "retweet_count": 3,
        "reply_count": 2,
        "like_count": 7
      }
    }
  ],
  "includes": {
    "users": [
      {
        "id": "44196397",
        "name": "Elon Musk",
        "username": "elonmusk"
      }
    ]
  },
  "meta": {
    "newest_id": "tweet-1",
    "oldest_id": "tweet-1",
    "next_token": "cursor-123",
    "result_count": 1
  }
}

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"
}

Phân trang

Nếu có meta.next_token, truyền dưới tên pagination_token để lấy trang tiếp.