Справочник эндпоинтов 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 с параметрами запроса без тела. Неизвестные, повторяющиеся и неверные поля отклоняются. Храните ID как строки, в том числе за пределами безопасного целого JavaScript. Тайм-аут составляет 60 секунд; автоматических повторов нет.

Стандартная цена — $0.002 (2000 credits) за успешный запрос, включая пустые массивы или объекты, а не за элемент. Индивидуальные цены аккаунта имеют приоритет. При сбое поставщика резерв освобождается. Ошибка расчёта не вызывает повторного запроса поставщику.

Публикации, репосты, ответы пользователя, комментарии, популярный и свежий поиск не поддерживают пагинацию. end_cursor зарезервирован и не действует; next_cursor и has_more не позволяют получить следующие страницы. Списки пользователя возвращают лишь доступную порцию (около 25 элементов), а не всю историю. Ни один эндпоинт не загружает дополнительные данные автоматически.

web-fetch_user_info

Профиль пользователя

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

Цена успешного запроса: $0.002 (2000 credits).

Поле	Обязательно	Контракт
`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

Профиль по ID

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

Цена успешного запроса: $0.002 (2000 credits).

Поле	Обязательно	Контракт
`user_id`	Да	`string`; Числовой 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

Публикации пользователя

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

Цена успешного запроса: $0.002 (2000 credits).

Поле	Обязательно	Контракт
`user_id`	Да	`string`; Числовой ID пользователя; `^[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 credits).

Поле	Обязательно	Контракт
`user_id`	Да	`string`; Числовой ID пользователя; `^[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 credits).

Поле	Обязательно	Контракт
`user_id`	Да	`string`; Числовой ID пользователя; `^[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

Публикация по числовому ID

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

Цена успешного запроса: $0.002 (2000 credits).

Поле	Обязательно	Контракт
`post_id`	Да	`string`; Числовой 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

Публикация по коду или URL

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

Цена успешного запроса: $0.002 (2000 credits).

Хотя бы одно: post_id, url.

Поле	Обязательно	Контракт
`post_id`	Нет	`string`; Короткий код публикации
`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 credits).

Поле	Обязательно	Контракт
`post_id`	Да	`string`; Числовой ID публикации; `^[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 credits).

Поле	Обязательно	Контракт
`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 credits).

Поле	Обязательно	Контракт
`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 credits).

Поле	Обязательно	Контракт
`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 credits).

Поле	Обязательно	Контракт
`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.

Источники

Сверено 2026-10-31 с официальной OpenAPI V5.3.2 и ценами эндпоинтов. fetch_post_id_from_url есть только в прайс-листе, но отсутствует в OpenAPI, поэтому исключён.

TikHub · OpenAPI · Prices