ดึงไทม์ไลน์ผู้ใช้ | เอกสาร 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.

ค้นหาไทม์ไลน์ด้วย ID ผู้ใช้มาตรฐาน เอนด์พอยต์ส่งโครงสร้าง data / includes / meta แบบ X API v2

text

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

การยืนยันตัวตน

เอนด์พอยต์ API Twitter ทั้งหมดต้องยืนยันตัวตนด้วย Bearer Token

http

Authorization: Bearer YOUR_API_KEY

พารามิเตอร์เส้นทาง

idstringจำเป็น

ID ผู้ใช้ Twitter เช่น 44196397

พารามิเตอร์การค้นหา

max_resultsintegerค่าเริ่มต้น: 10

จำนวนทวีตที่ส่งกลับต่อหน้า ตั้งแต่ 1 ถึง 100

pagination_tokenstring

เคอร์เซอร์หน้าถัดไป คัดลอกจาก meta.next_token ของการตอบกลับก่อนหน้า

excludestring

รายการประเภทที่ไม่รวม คั่นด้วยจุลภาค รองรับ replies และ retweets

expansionsstring

ฟิลด์เพิ่มเติมคั่นด้วยจุลภาค ใช้ author_id เพื่อรวม includes.users

tweet.fieldsstring

ฟิลด์ทวีตคั่นด้วยจุลภาค เช่น created_at,public_metrics,attachments,source

user.fieldsstring

ควบคุมฟิลด์ใน includes.users เมื่อขอ expansions=author_id

ตัวอย่างคำขอ

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"

การตอบกลับ

dataobject[]จำเป็น

รายการทวีตไทม์ไลน์

ฟิลด์ทวีต

idstringจำเป็น

ID ทวีต

textstringจำเป็น

เนื้อหาข้อความทวีต

attachmentsobject

ข้อมูลอ้างอิงสื่อ ปัจจุบันส่งกลับเป็น media_keys

author_idstring

ID ผู้เขียน เมื่อขอ expansions=author_id จะสอดคล้องกับ includes.users

conversation_idstring

ID บทสนทนา

created_atstring

เวลาสร้างทวีตในรูปแบบ ISO 8601

edit_history_tweet_idsstring[]

ID ทวีตในประวัติแก้ไข

entitiesobject

เอนทิตีทวีตที่แยกแล้ว เช่น แฮชแท็ก URL และการกล่าวถึง

in_reply_to_user_idstring

ID ผู้ใช้ที่ถูกตอบกลับ

langstring

ภาษาทวีต

possibly_sensitiveboolean

เนื้อหาอ่อนไหวหรือไม่

public_metricsobject

ตัวชี้วัดสาธารณะของทวีต

ฟิลด์ public_metrics

retweet_countinteger

จำนวนรีทวีต

reply_countinteger

จำนวนการตอบกลับ

like_countinteger

จำนวนการกดถูกใจ

quote_countinteger

จำนวนการอ้างโพสต์

bookmark_countinteger

จำนวนบุ๊กมาร์ก

impression_countinteger

จำนวนการแสดงผล

referenced_tweetsobject[]

ทวีตที่อ้างอิง type อาจเป็น retweeted, quoted หรือ replied_to

sourcestring

แหล่งทวีต เช่น ไคลเอนต์หรือเว็บ

includesobject

ออบเจ็กต์เพิ่มเติม แสดงเมื่อ expansions มี author_id

ฟิลด์ includes

usersobject[]

รายชื่อผู้เขียนที่ตรงกับ author_id

metaobjectจำเป็น

เมทาดาทาการแบ่งหน้าและผลลัพธ์

ฟิลด์ meta

newest_idstring

ID ทวีตใหม่สุดในหน้าปัจจุบัน

oldest_idstring

ID ทวีตเก่าสุดในหน้าปัจจุบัน

next_tokenstring

เคอร์เซอร์หน้าถัดไป ส่งเป็น pagination_token

result_countintegerจำเป็น

จำนวนทวีตในหน้าปัจจุบัน

ตัวอย่างสำเร็จ

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

การตอบกลับผิดพลาด

ดูรหัสข้อผิดพลาดและการแก้ปัญหา สำหรับรหัสทั้งหมด ความต่างของโปรโตคอล และขั้นตอนวินิจฉัย

json

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

การแบ่งหน้า

หากมี meta.next_token ให้ส่งเป็น pagination_token เพื่อดึงหน้าถัดไป