Threads uç nokta başvurusu | API Belgeleri

# 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)

Kimlik doğrulamalı 12 Threads uç noktasından profil, gönderi, yanıt, yeniden paylaşım, yorum ve arama sonuçlarını alın.

Gövde olmadan GET sorgu parametrelerini kullanın. Bilinmeyen, yinelenen veya geçersiz alanlar reddedilir. JavaScript güvenli tam sayı aralığını aşanlar dahil, kimlikleri dize olarak tutun. Zaman aşımı 60 saniyedir; otomatik yeniden deneme yapılmaz.

Varsayılan fiyat, boş dizi veya nesneler dahil başarılı istek başına $0.002 (2000 credits) tutarındadır; öğe başına değildir. Hesaba özel fiyatlar önceliklidir. Sağlayıcı hatalarında rezervasyon kaldırılır. Hesaplaşma hataları sağlayıcı isteğini yinelemez.

Kullanıcı gönderileri, yeniden paylaşımları, yanıtları, gönderi yorumları, popüler ve yeni aramalar sayfalamayı desteklemez. end_cursor ayrılmıştır ve etkisizdir; next_cursor veya has_more ile sonraki sayfalar alınamaz. Kullanıcı listeleri tüm geçmişi değil, mevcut grubu (yaklaşık 25 öğe) döndürür. Hiçbir uç nokta otomatik olarak daha fazla veri almaz.

web-fetch_user_info

Kullanıcı profili

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`username`	Evet	`string`; Kullanıcı adı

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

Kimlikle kullanıcı profili

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`user_id`	Evet	`string`; Sayısal kullanıcı kimliği; `^[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

Kullanıcı gönderileri

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`user_id`	Evet	`string`; Sayısal kullanıcı kimliği; `^[0-9]+$`
`end_cursor`	Hayır	`string`; Ayrılmış; sayfalama yok

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

Kullanıcı yeniden paylaşımları

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`user_id`	Evet	`string`; Sayısal kullanıcı kimliği; `^[0-9]+$`
`end_cursor`	Hayır	`string`; Ayrılmış; sayfalama yok

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

Kullanıcı yanıtları

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`user_id`	Evet	`string`; Sayısal kullanıcı kimliği; `^[0-9]+$`
`end_cursor`	Hayır	`string`; Ayrılmış; sayfalama yok

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

Sayısal kimlikle gönderi

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`post_id`	Evet	`string`; Sayısal gönderi kimliği; `^[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

Kısa kod veya URL ile gönderi

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

En az biri: post_id, url.

Alan	Gerekli	Sözleşme
`post_id`	Hayır	`string`; Gönderi kısa kodu
`url`	Hayır	`string`; Tam gönderi URL’si

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

Gönderi yorumları

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`post_id`	Evet	`string`; Sayısal gönderi kimliği; `^[0-9]+$`
`end_cursor`	Hayır	`string`; Ayrılmış; sayfalama yok

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

Popüler arama

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`query`	Evet	`string`; Arama terimleri
`end_cursor`	Hayır	`string`; Ayrılmış; sayfalama yok

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

Yeni arama

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`query`	Evet	`string`; Arama terimleri
`end_cursor`	Hayır	`string`; Ayrılmış; sayfalama yok

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

Gönderi araması

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`query`	Evet	`string`; Arama terimleri

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

Profil araması

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

Başarılı istek başına fiyat: $0.002 (2000 credits).

Alan	Gerekli	Sözleşme
`query`	Evet	`string`; Arama terimleri

bash

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

Yanıtlar

Yerel JSON code/data yapısı ve sayısal hassasiyet korunur. Başarı için code=200 ve null olmayan data gerekir. HTTP 200 içindeki iş hatası başarısızlıktır. Yanıt yapıları değişir; örnek açıklama amaçlıdır, canlı yanıt değildir.

json

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

Hatalar

HTTP 400: geçersiz parametre; 401: kimlik doğrulama hatası; 402: yetersiz bakiye; 403: erişim reddi; 405: desteklenmeyen yöntem; 408: iptal; 429: hız sınırı; 5xx: hizmet veya sağlayıcı hatası, zaman aşımı için 504 dahil. Tanılama için X-Request-Id değerini saklayın.

Kaynaklar

2026-10-31 tarihinde OpenAPI V5.3.2 ve resmi uç nokta fiyatlarıyla doğrulandı. Yalnızca fiyat listesinde bulunan fetch_post_id_from_url, OpenAPI’de olmadığından kapsam dışıdır.

TikHub · OpenAPI · Prices