Threads: opis punktów końcowych | Dokumentacja 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)

Odczytuj profile, posty, odpowiedzi, ponowne publikacje, komentarze i wyniki wyszukiwania przez 12 uwierzytelnionych punktów końcowych Threads.

Używaj parametrów zapytania GET bez treści żądania. Nieznane, zdublowane lub nieprawidłowe pola są odrzucane. Zachowuj ID jako ciągi znaków, także wartości poza bezpiecznym zakresem liczb całkowitych JavaScript. Żądania przekraczają limit po 60 sekundach i nie są automatycznie ponawiane.

Domyślna cena wynosi $0.002 (2000 kredytów) za udane żądanie, w tym udane puste tablice lub obiekty, a nie za pozycję. Pierwszeństwo mają ceny indywidualne konta. Nieudane żądania dostawcy zwalniają rezerwację. Błędy rozliczenia zwracają błąd bez powtarzania żądania do dostawcy.

Posty użytkownika, ponowne publikacje, odpowiedzi, komentarze postów oraz wyszukiwanie najlepszych i najnowszych wyników nie obsługują stronicowania. Ich pole end_cursor jest zarezerwowane i nie działa; nie używaj next_cursor ani has_more do pobierania kolejnych stron. Listy użytkownika zwracają tylko dostępną partię (około 25 pozycji), a nie pełną historię. Żaden punkt końcowy nie pobiera automatycznie dalszych danych.

web-fetch_user_info

Profil użytkownika

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`username`	Tak	`string`; Nazwa użytkownika

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

Profil użytkownika według ID

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`user_id`	Tak	`string`; Numeryczne ID użytkownika; `^[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

Posty użytkownika

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`user_id`	Tak	`string`; Numeryczne ID użytkownika; `^[0-9]+$`
`end_cursor`	Nie	`string`; Zarezerwowane; bez stronicowania

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

Ponowne publikacje użytkownika

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`user_id`	Tak	`string`; Numeryczne ID użytkownika; `^[0-9]+$`
`end_cursor`	Nie	`string`; Zarezerwowane; bez stronicowania

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

Odpowiedzi użytkownika

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`user_id`	Tak	`string`; Numeryczne ID użytkownika; `^[0-9]+$`
`end_cursor`	Nie	`string`; Zarezerwowane; bez stronicowania

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 według numerycznego ID

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`post_id`	Tak	`string`; Numeryczne ID posta; `^[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 według shortcode lub URL

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Co najmniej jedno: post_id, url.

Pole	Wymagane	Kontrakt
`post_id`	Nie	`string`; Shortcode posta
`url`	Nie	`string`; Pełny adres URL posta

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

Komentarze posta

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`post_id`	Tak	`string`; Numeryczne ID posta; `^[0-9]+$`
`end_cursor`	Nie	`string`; Zarezerwowane; bez stronicowania

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

Najlepsze wyniki wyszukiwania

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`query`	Tak	`string`; Wyszukiwane hasła
`end_cursor`	Nie	`string`; Zarezerwowane; bez stronicowania

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

Najnowsze wyniki wyszukiwania

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`query`	Tak	`string`; Wyszukiwane hasła
`end_cursor`	Nie	`string`; Zarezerwowane; bez stronicowania

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

Wyszukiwanie postów

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`query`	Tak	`string`; Wyszukiwane hasła

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

Wyszukiwanie profili

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

Cena za udane żądanie: $0.002 (2000 kredytów).

Pole	Wymagane	Kontrakt
`query`	Tak	`string`; Wyszukiwane hasła

bash

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

Odpowiedzi

Natywne opakowanie JSON code/data i precyzja liczb zostają zachowane. Sukces wymaga code=200 i data innego niż null. Błąd biznesowy HTTP 200 jest niepowodzeniem. Struktury odpowiedzi różnią się według punktu końcowego; ten przykład jest ilustracyjny, a nie odpowiedzią na żywo.

json

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

Błędy

HTTP 400: nieprawidłowe parametry; 401: błąd uwierzytelnienia; 402: niewystarczające środki; 403: odmowa dostępu; 405: nieobsługiwana metoda; 408: anulowanie; 429: limit częstotliwości; 5xx: błąd usługi lub dostawcy, w tym limit czasu 504. Zachowaj X-Request-Id do diagnozy.

Źródła

Sprawdzono względem oficjalnego OpenAPI V5.3.2 i cen punktów końcowych 2026-10-31. Operacja fetch_post_id_from_url występująca tylko w cenniku jest wykluczona, ponieważ nie ma jej w OpenAPI.

TikHub · OpenAPI · Ceny