Riferimento degli endpoint Threads | Documentazione 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)

Consulta profili, post, risposte, repost, commenti e ricerche tramite 12 endpoint Threads autenticati.

Usa GET con parametri di query e senza corpo. Campi sconosciuti, duplicati o non validi vengono rifiutati. Mantieni gli ID come stringhe, anche oltre l’intervallo intero sicuro di JavaScript. Il timeout è di 60 secondi, senza tentativi automatici.

Il prezzo predefinito è $0.002 (2000 credits) per richiesta riuscita, inclusi array o oggetti vuoti, non per elemento. I prezzi specifici dell’account hanno precedenza. Gli errori del fornitore liberano la prenotazione. Gli errori di contabilizzazione non ripetono la chiamata al fornitore.

Post, repost, risposte, commenti e ricerche popolari o recenti non supportano la paginazione. end_cursor è riservato e non ha effetto; next_cursor e has_more non consentono altre pagine. Gli elenchi utente restituiscono solo il gruppo disponibile (circa 25 elementi), non l’intera cronologia. Nessun endpoint recupera altri dati automaticamente.

web-fetch_user_info

Profilo utente

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`username`	Sì	`string`; Nome utente

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

Profilo per ID

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`user_id`	Sì	`string`; ID utente numerico; `^[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

Post utente

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`user_id`	Sì	`string`; ID utente numerico; `^[0-9]+$`
`end_cursor`	No	`string`; Riservato; nessuna paginazione

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

Repost utente

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`user_id`	Sì	`string`; ID utente numerico; `^[0-9]+$`
`end_cursor`	No	`string`; Riservato; nessuna paginazione

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

Risposte utente

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`user_id`	Sì	`string`; ID utente numerico; `^[0-9]+$`
`end_cursor`	No	`string`; Riservato; nessuna paginazione

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 per ID numerico

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`post_id`	Sì	`string`; ID post numerico; `^[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 per codice breve o URL

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Almeno uno: post_id, url.

Campo	Obbligatorio	Contratto
`post_id`	No	`string`; Codice breve del post
`url`	No	`string`; URL completo del post

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

Commenti

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`post_id`	Sì	`string`; ID post numerico; `^[0-9]+$`
`end_cursor`	No	`string`; Riservato; nessuna paginazione

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

Ricerca popolare

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`query`	Sì	`string`; Termini di ricerca
`end_cursor`	No	`string`; Riservato; nessuna paginazione

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

Ricerca recente

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`query`	Sì	`string`; Termini di ricerca
`end_cursor`	No	`string`; Riservato; nessuna paginazione

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

Ricerca post

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`query`	Sì	`string`; Termini di ricerca

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

Ricerca profili

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

Prezzo per richiesta riuscita: $0.002 (2000 credits).

Campo	Obbligatorio	Contratto
`query`	Sì	`string`; Termini di ricerca

bash

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

Risposte

Il JSON nativo code/data e la precisione numerica vengono conservati. Il successo richiede code=200 e data diverso da null. Un errore applicativo con HTTP 200 resta un errore. Le strutture variano; l’esempio è illustrativo, non una risposta reale.

json

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

Errori

HTTP 400: parametri non validi; 401: autenticazione non valida; 402: saldo insufficiente; 403: accesso negato; 405: metodo non supportato; 408: annullamento; 429: limite di frequenza; 5xx: errore del servizio o fornitore, incluso 504 per timeout. Conserva X-Request-Id.

Fonti

Verificato il 2026-10-31 con OpenAPI V5.3.2 e i prezzi ufficiali. fetch_post_id_from_url compare solo nel listino e non in OpenAPI, quindi è escluso.

TikHub · OpenAPI · Prices