Referência de endpoints do Threads | Documentação de APIs

# 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)

Consulte perfis, publicações, respostas, republicações, comentários e buscas em 12 endpoints autenticados do Threads.

Use GET com parâmetros de consulta e sem corpo. Campos desconhecidos, repetidos ou inválidos são rejeitados. Mantenha os IDs como strings, inclusive fora do intervalo inteiro seguro do JavaScript. O tempo limite é de 60 segundos, sem novas tentativas automáticas.

O preço padrão é $0.002 (2000 credits) por requisição bem-sucedida, incluindo arrays ou objetos vazios, não por item. Preços específicos da conta têm prioridade. Falhas do fornecedor liberam a reserva. Erros de liquidação não repetem a chamada ao fornecedor.

Publicações, republicações, respostas, comentários e buscas populares ou recentes não oferecem paginação. end_cursor é reservado e não tem efeito; next_cursor e has_more não permitem buscar outras páginas. Listas de usuários retornam apenas o lote disponível (cerca de 25 itens), não todo o histórico. Nenhum endpoint busca mais dados automaticamente.

web-fetch_user_info

Perfil do usuário

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`username`	Sim	`string`; Nome de usuário

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`user_id`	Sim	`string`; ID numérico do usuário; `^[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

Publicações do usuário

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`user_id`	Sim	`string`; ID numérico do usuário; `^[0-9]+$`
`end_cursor`	Não	`string`; Reservado; sem paginação

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

Republicações do usuário

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`user_id`	Sim	`string`; ID numérico do usuário; `^[0-9]+$`
`end_cursor`	Não	`string`; Reservado; sem paginação

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

Respostas do usuário

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`user_id`	Sim	`string`; ID numérico do usuário; `^[0-9]+$`
`end_cursor`	Não	`string`; Reservado; sem paginação

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

Publicação por ID numérico

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`post_id`	Sim	`string`; ID numérico da publicação; `^[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

Publicação por código curto ou URL

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Ao menos um: post_id, url.

Campo	Obrigatório	Contrato
`post_id`	Não	`string`; Código curto da publicação
`url`	Não	`string`; URL completa da publicação

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

Comentários

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`post_id`	Sim	`string`; ID numérico da publicação; `^[0-9]+$`
`end_cursor`	Não	`string`; Reservado; sem paginação

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

Busca popular

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`query`	Sim	`string`; Termos de busca
`end_cursor`	Não	`string`; Reservado; sem paginação

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

Busca recente

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`query`	Sim	`string`; Termos de busca
`end_cursor`	Não	`string`; Reservado; sem paginação

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

Busca de publicações

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`query`	Sim	`string`; Termos de busca

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

Busca de perfis

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

Preço por requisição bem-sucedida: $0.002 (2000 credits).

Campo	Obrigatório	Contrato
`query`	Sim	`string`; Termos de busca

bash

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

Respostas

O JSON nativo code/data e a precisão numérica são preservados. O sucesso exige code=200 e data diferente de null. Um erro de negócio com HTTP 200 continua sendo uma falha. As estruturas variam; o exemplo é ilustrativo, não uma resposta real.

json

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

Erros

HTTP 400: parâmetros inválidos; 401: falha de autenticação; 402: saldo insuficiente; 403: acesso negado; 405: método não aceito; 408: cancelamento; 429: limite de frequência; 5xx: falha do serviço ou fornecedor, incluindo 504 por tempo esgotado. Guarde X-Request-Id.

Fontes

Conferido em 2026-10-31 com OpenAPI V5.3.2 e os preços oficiais. fetch_post_id_from_url aparece apenas na tabela de preços, não em OpenAPI, e foi excluído.

TikHub · OpenAPI · Prices