Référence des endpoints Threads | Documentation des 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)

Consultez profils, publications, réponses, republications, commentaires et recherches via 12 endpoints Threads authentifiés.

Utilisez GET avec des paramètres de requête, sans corps. Les champs inconnus, répétés ou invalides sont refusés. Gardez les identifiants sous forme de chaînes, même au-delà de la précision entière sûre de JavaScript. Le délai maximal est de 60 secondes, sans nouvelle tentative automatique.

Le tarif par défaut est de $0.002 (2000 credits) par requête réussie, y compris les tableaux ou objets vides, et non par élément. Les tarifs propres au compte prévalent. Un échec fournisseur libère la réservation. Une erreur de règlement ne relance pas la requête fournisseur.

Les publications, republications, réponses, commentaires ainsi que les recherches populaires et récentes ne sont pas paginés. end_cursor est réservé et sans effet ; next_cursor et has_more ne permettent pas de charger d’autres pages. Les listes utilisateur renvoient seulement le lot disponible (environ 25 éléments), pas tout l’historique. Aucun endpoint ne récupère automatiquement des données supplémentaires.

web-fetch_user_info

Profil utilisateur

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`username`	Oui	`string`; Nom d’utilisateur

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 par identifiant

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`user_id`	Oui	`string`; Identifiant utilisateur numérique; `^[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

Publications utilisateur

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`user_id`	Oui	`string`; Identifiant utilisateur numérique; `^[0-9]+$`
`end_cursor`	Non	`string`; Réservé ; sans 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

Republications utilisateur

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`user_id`	Oui	`string`; Identifiant utilisateur numérique; `^[0-9]+$`
`end_cursor`	Non	`string`; Réservé ; sans 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

Réponses utilisateur

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`user_id`	Oui	`string`; Identifiant utilisateur numérique; `^[0-9]+$`
`end_cursor`	Non	`string`; Réservé ; sans 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

Publication par identifiant numérique

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`post_id`	Oui	`string`; Identifiant de publication numérique; `^[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

Publication par code court ou URL

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

Prix par requête réussie: $0.002 (2000 credits).

Au moins un: post_id, url.

Champ	Obligatoire	Contrat
`post_id`	Non	`string`; Code court de publication
`url`	Non	`string`; URL complète de publication

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

Commentaires

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`post_id`	Oui	`string`; Identifiant de publication numérique; `^[0-9]+$`
`end_cursor`	Non	`string`; Réservé ; sans 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

Recherche populaire

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`query`	Oui	`string`; Termes de recherche
`end_cursor`	Non	`string`; Réservé ; sans 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

Recherche récente

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`query`	Oui	`string`; Termes de recherche
`end_cursor`	Non	`string`; Réservé ; sans 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

Recherche de publications

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`query`	Oui	`string`; Termes de recherche

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

Recherche de profils

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

Prix par requête réussie: $0.002 (2000 credits).

Champ	Obligatoire	Contrat
`query`	Oui	`string`; Termes de recherche

bash

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

Réponses

Le JSON natif code/data et la précision numérique sont conservés. Un succès exige code=200 et data différent de null. Une erreur métier dans HTTP 200 reste un échec. Les structures varient ; cet exemple est illustratif, pas une réponse réelle.

json

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

Erreurs

HTTP 400 : paramètres invalides ; 401 : authentification invalide ; 402 : solde insuffisant ; 403 : accès refusé ; 405 : méthode non prise en charge ; 408 : annulation ; 429 : limite de débit ; 5xx : erreur de service ou fournisseur, dont 504 pour le délai dépassé. Conservez X-Request-Id.

Sources

Vérifié le 2026-10-31 avec OpenAPI V5.3.2 et les tarifs officiels. fetch_post_id_from_url figure uniquement dans la liste de prix et pas dans OpenAPI ; cette opération est exclue.

TikHub · OpenAPI · Prices