Referencia de endpoints de Threads | Documentación de 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 perfiles, publicaciones, respuestas, republicaciones, comentarios y búsquedas mediante 12 endpoints autenticados de Threads.

Usa GET con parámetros de consulta y sin cuerpo. Se rechazan campos desconocidos, repetidos o inválidos. Conserva los identificadores como cadenas, incluso fuera del rango entero seguro de JavaScript. El tiempo límite es de 60 segundos, sin reintentos automáticos.

El precio predeterminado es $0.002 (2000 credits) por solicitud correcta, incluidos arrays u objetos vacíos, no por elemento. Prevalecen las tarifas específicas de la cuenta. Los fallos del proveedor liberan la reserva. Los errores de liquidación no repiten la llamada al proveedor.

Las publicaciones, republicaciones, respuestas, comentarios y búsquedas populares o recientes no admiten paginación. end_cursor está reservado y no tiene efecto; next_cursor y has_more no permiten obtener otras páginas. Las listas de usuario devuelven solo el lote disponible (unos 25 elementos), no todo el historial. Ningún endpoint obtiene más datos automáticamente.

web-fetch_user_info

Perfil de usuario

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`username`	Sí	`string`; Nombre de usuario

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

Perfil por ID

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`user_id`	Sí	`string`; ID numérico de usuario; `^[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

Publicaciones del usuario

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`user_id`	Sí	`string`; ID numérico de usuario; `^[0-9]+$`
`end_cursor`	No	`string`; Reservado; sin paginación

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

Republicaciones del usuario

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`user_id`	Sí	`string`; ID numérico de usuario; `^[0-9]+$`
`end_cursor`	No	`string`; Reservado; sin paginación

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

Respuestas del usuario

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`user_id`	Sí	`string`; ID numérico de usuario; `^[0-9]+$`
`end_cursor`	No	`string`; Reservado; sin paginación

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

Publicación por ID numérico

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`post_id`	Sí	`string`; ID numérico de publicación; `^[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

Publicación por código corto o URL

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

Precio por solicitud correcta: $0.002 (2000 credits).

Al menos uno: post_id, url.

Campo	Obligatorio	Contrato
`post_id`	No	`string`; Código corto de publicación
`url`	No	`string`; URL completa de publicación

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

Comentarios

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`post_id`	Sí	`string`; ID numérico de publicación; `^[0-9]+$`
`end_cursor`	No	`string`; Reservado; sin paginación

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

Búsqueda popular

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`query`	Sí	`string`; Términos de búsqueda
`end_cursor`	No	`string`; Reservado; sin paginación

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

Búsqueda reciente

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`query`	Sí	`string`; Términos de búsqueda
`end_cursor`	No	`string`; Reservado; sin paginación

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

Búsqueda de publicaciones

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`query`	Sí	`string`; Términos de búsqueda

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

Búsqueda de perfiles

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

Precio por solicitud correcta: $0.002 (2000 credits).

Campo	Obligatorio	Contrato
`query`	Sí	`string`; Términos de búsqueda

bash

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

Respuestas

Se conservan el JSON nativo code/data y la precisión numérica. El éxito exige code=200 y data distinto de null. Un error de negocio con HTTP 200 sigue siendo un fallo. Las estructuras varían; el ejemplo es ilustrativo, no una respuesta real.

json

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

Errores

HTTP 400: parámetros inválidos; 401: fallo de autenticación; 402: saldo insuficiente; 403: acceso denegado; 405: método no admitido; 408: cancelación; 429: límite de frecuencia; 5xx: fallo del servicio o proveedor, incluido 504 por tiempo agotado. Conserva X-Request-Id.

Fuentes

Verificado el 2026-10-31 con OpenAPI V5.3.2 y los precios oficiales. fetch_post_id_from_url solo aparece en la lista de precios, no en OpenAPI, por lo que queda excluido.

TikHub · OpenAPI · Prices