مرجع نقاط نهاية Threads | وثائق API

# Threads endpoint reference

Read profiles, posts, replies, reposts, comments and search results through 12 authenticated Threads endpoints.

Use GET query parameters without a request body. Unknown, duplicate or invalid fields are rejected. Keep IDs as strings, including values beyond the JavaScript safe integer range. Requests time out after 60 seconds and are not automatically retried.

The default price is $0.002 (2000 credits) per successful request, including successful empty arrays or objects, not per item. Account-specific prices take precedence. Failed upstream requests release the reservation. Settlement errors return an error without repeating the upstream request.

User posts, reposts, replies, post comments, top search and recent search do not support pagination. Their end_cursor field is reserved and has no effect; do not use next_cursor or has_more to fetch further pages. User lists return only the available batch (about 25 items), not full history. No endpoint automatically retrieves more data.

### web-fetch_user_info

User profile

`GET https://api.apihop.ai/v1/threads/web/users/profile`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `username` | Yes | `string`; Username |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=jlo"
```

### web-fetch_user_info_by_id

User profile by ID

`GET https://api.apihop.ai/v1/threads/web/users/profile/by-id`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/profile/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=67027868801"
```

### web-fetch_user_posts

User posts

`GET https://api.apihop.ai/v1/threads/web/users/posts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_user_reposts

User reposts

`GET https://api.apihop.ai/v1/threads/web/users/reposts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/reposts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_user_replies

User replies

`GET https://api.apihop.ai/v1/threads/web/users/replies`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_post_detail

Post by numeric ID

`GET https://api.apihop.ai/v1/threads/web/posts/by-id`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | Yes | `string`; Numeric post ID; `^[0-9]+$` |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3349029093483693129"
```

### web-fetch_post_detail_v2

Post by shortcode or URL

`GET https://api.apihop.ai/v1/threads/web/posts/detail`

Price per successful request: **$0.002** (2000 credits).

At least one: `post_id`, `url`.

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | No | `string`; Post shortcode |
| `url` | No | `string`; Full post URL |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"
```

### web-fetch_post_comments

Post comments

`GET https://api.apihop.ai/v1/threads/web/posts/comments`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | Yes | `string`; Numeric post ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3390920896561588969"
```

### web-search_top

Top search

`GET https://api.apihop.ai/v1/threads/web/search/top`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/top" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_recent

Recent search

`GET https://api.apihop.ai/v1/threads/web/search/recent`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/recent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_posts

Post search

`GET https://api.apihop.ai/v1/threads/web/search/posts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_profiles

Profile search

`GET https://api.apihop.ai/v1/threads/web/search/profiles`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/profiles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=mark"
```

## Responses

The native JSON code/data envelope and numeric precision are preserved. Success requires code=200 and non-null data. An HTTP 200 business error is a failure. Response shapes vary by endpoint; this example is illustrative, not a live response.

```json
{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}
```

## Errors

HTTP 400: invalid parameters; 401: authentication failure; 402: insufficient credit; 403: access denied; 405: unsupported method; 408: cancellation; 429: rate limit; 5xx: service or upstream failure, including 504 timeout. Keep X-Request-Id for diagnosis.

## Sources

Checked against official OpenAPI V5.3.2 and endpoint prices on 2026-10-31. The price-only fetch_post_id_from_url operation is excluded because it is absent from OpenAPI.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

اقرأ الملفات والمنشورات والردود وإعادة النشر والتعليقات ونتائج البحث عبر 12 نقطة نهاية Threads تتطلب المصادقة.

استخدم معاملات استعلام GET دون جسم طلب. ترفض الحقول المجهولة أو المكررة أو غير الصحيحة. احتفظ بالمعرفات كسلاسل نصية، بما فيها القيم خارج نطاق الأعداد الصحيحة الآمن في JavaScript. تنتهي مهلة الطلبات بعد 60 ثانية ولا تعاد تلقائيا.

السعر الافتراضي $0.002 (2000 رصيد) لكل طلب ناجح، بما فيه المصفوفات أو الكائنات الفارغة الناجحة، وليس لكل عنصر. لأسعار الحساب الخاصة الأولوية. تحرر طلبات المزود الفاشلة المبلغ المحجوز. تعيد أخطاء التسوية خطأ دون تكرار طلب المزود.

لا تدعم منشورات المستخدم وإعادة النشر والردود وتعليقات المنشورات والبحث الأبرز والبحث الحديث ترقيم الصفحات. حقل end_cursor فيها محجوز ولا يؤثر؛ ولا تستخدم next_cursor أو has_more لجلب صفحات إضافية. تعيد قوائم المستخدمين الدفعة المتاحة فقط (نحو 25 عنصرا)، وليس السجل الكامل. لا تجلب أي نقطة نهاية بيانات إضافية تلقائيا.

web-fetch_user_info

ملف المستخدم

GET https://api.apihop.ai/v1/threads/web/users/profile

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`username`	نعم	`string`; اسم المستخدم

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=jlo"

web-fetch_user_info_by_id

ملف المستخدم حسب المعرف

GET https://api.apihop.ai/v1/threads/web/users/profile/by-id

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`user_id`	نعم	`string`; معرف المستخدم الرقمي; `^[0-9]+$`

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/profile/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=67027868801"

web-fetch_user_posts

منشورات المستخدم

GET https://api.apihop.ai/v1/threads/web/users/posts

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`user_id`	نعم	`string`; معرف المستخدم الرقمي; `^[0-9]+$`
`end_cursor`	لا	`string`; محجوز; دون ترقيم صفحات

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_user_reposts

إعادة نشر المستخدم

GET https://api.apihop.ai/v1/threads/web/users/reposts

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`user_id`	نعم	`string`; معرف المستخدم الرقمي; `^[0-9]+$`
`end_cursor`	لا	`string`; محجوز; دون ترقيم صفحات

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/reposts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_user_replies

ردود المستخدم

GET https://api.apihop.ai/v1/threads/web/users/replies

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`user_id`	نعم	`string`; معرف المستخدم الرقمي; `^[0-9]+$`
`end_cursor`	لا	`string`; محجوز; دون ترقيم صفحات

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_post_detail

منشور حسب المعرف الرقمي

GET https://api.apihop.ai/v1/threads/web/posts/by-id

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`post_id`	نعم	`string`; معرف المنشور الرقمي; `^[0-9]+$`

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3349029093483693129"

web-fetch_post_detail_v2

منشور حسب shortcode أو URL

GET https://api.apihop.ai/v1/threads/web/posts/detail

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

واحد على الأقل: post_id, url.

الحقل	مطلوب	العقد
`post_id`	لا	`string`; رمز shortcode للمنشور
`url`	لا	`string`; عنوان URL الكامل للمنشور

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"

web-fetch_post_comments

تعليقات المنشور

GET https://api.apihop.ai/v1/threads/web/posts/comments

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`post_id`	نعم	`string`; معرف المنشور الرقمي; `^[0-9]+$`
`end_cursor`	لا	`string`; محجوز; دون ترقيم صفحات

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3390920896561588969"

web-search_top

البحث الأبرز

GET https://api.apihop.ai/v1/threads/web/search/top

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`query`	نعم	`string`; عبارات البحث
`end_cursor`	لا	`string`; محجوز; دون ترقيم صفحات

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/top" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"

web-search_recent

البحث الحديث

GET https://api.apihop.ai/v1/threads/web/search/recent

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`query`	نعم	`string`; عبارات البحث
`end_cursor`	لا	`string`; محجوز; دون ترقيم صفحات

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/recent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"

web-search_posts

البحث عن المنشورات

GET https://api.apihop.ai/v1/threads/web/search/posts

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`query`	نعم	`string`; عبارات البحث

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"

web-search_profiles

البحث عن الملفات

GET https://api.apihop.ai/v1/threads/web/search/profiles

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

الحقل	مطلوب	العقد
`query`	نعم	`string`; عبارات البحث

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/profiles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=mark"

الاستجابات

يحفظ غلاف JSON الأصلي code/data والدقة العددية. يتطلب النجاح code=200 وdata غير null. خطأ الأعمال مع HTTP 200 يعد إخفاقا. تختلف بنية الاستجابة بحسب نقطة النهاية؛ وهذا المثال توضيحي، وليس استجابة مباشرة.

json

{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}

الأخطاء

HTTP 400: معاملات غير صحيحة؛ 401: إخفاق المصادقة؛ 402: رصيد غير كاف؛ 403: رفض الوصول؛ 405: طريقة غير مدعومة؛ 408: إلغاء؛ 429: حد المعدل؛ 5xx: إخفاق الخدمة أو المزود، بما فيه انتهاء المهلة 504. احتفظ بـX-Request-Id للتشخيص.

المصادر

جرى التحقق مقابل OpenAPI V5.3.2 الرسمي وأسعار نقاط النهاية في 2026-10-31. استبعدت العملية fetch_post_id_from_url الموجودة في الأسعار فقط لأنها غير موجودة في OpenAPI.

TikHub · OpenAPI · الأسعار