# Felo Respostas a Posts do X

POST /api/v1/data/x/tweet/replies

Escolha a operação para os dados de que você precisa. Os cinco endpoints usam POST e retornam JSON na raiz, sem um wrapper comum `data`.

Todos os exemplos usam `FELO_API_KEY` a partir da [visão geral](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-overview.md). As chamadas usam **saldo da plataforma**, não créditos Pro da Felo. Os exemplos de resposta são ilustrativos; o conteúdo ao vivo e os campos opcionais variam.





## 5. Ler respostas

`POST /api/v1/data/x/tweet/replies`

| Campo | Tipo | Obrigatório | Significado |
|---|---|---|---|
| `tweet_ids` | string ou array de strings | Sim | Um ID de post ou um lote de até 20 IDs |
| `cursor` | string | Não | Até 4.000 caracteres; use com um único ID de post |
| `since_time` | integer | Não | Hora de início em segundos Unix |
| `until_time` | integer | Não | Hora de término em segundos Unix |

Substitua o espaço reservado por um ID real de post:

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/tweet/replies" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_ids":["POST_ID"]}'
```

Ao contrário da timeline e da busca de posts, as respostas são agrupadas em `results`. Cada entrada tem seu próprio estado de paginação:

```json
{"results":[{"tweet_id":"POST_ID","replies":[],"total":0,"has_next":false,"next_cursor":null}]}
```

### Limites de respostas por solicitação

Cada solicitação lê uma página upstream de respostas por `tweet_id` e mantém no máximo 100 respostas; ela não busca automaticamente todas as páginas de respostas. Em um lote de até 20 IDs, o limite de 100 respostas se aplica separadamente a cada entrada `results`. As contagens reais podem ser menores.

O `total` de cada entrada é o número de respostas retornadas nessa entrada, não a contagem completa de respostas do post. Para continuar, use o `next_cursor` dessa entrada e envie apenas o ID do post único na próxima solicitação. Não há parâmetro `limit` para aumentar o teto por solicitação.



## Paginação e controle de custo

`total` conta o array correspondente na resposta atual: posts de nível superior para consultas de post, ou respostas dentro de cada entrada de resultado para consultas de respostas. Ele não é uma contagem global de correspondências, nem a contagem completa de respostas de um post, nem a contagem final cobrável.

1. Envie a primeira solicitação sem `cursor`.
2. Leia `has_next` e `next_cursor` da resposta. Para respostas, leia-os em cada entrada de resultado.
3. Se houver outra página e o cursor não estiver vazio, envie-o inalterado com a mesma consulta. Para um lote de respostas, continue cada post separadamente.
4. Pare quando não houver próxima página, quando um cursor se repetir ou quando seu próprio limite de páginas ou de gastos for atingido.

Os metadados de paginação refletem a última resposta upstream; a coleção retornada pode ser truncada por um limite de resultados. Mesmo `has_next=false` não é garantia de que todo o histórico do X ou todas as respostas foram recuperados. Exiba a contagem real retornada em vez de rotular um conjunto de resultados limitado como todos os dados disponíveis.

Cada página bem-sucedida pode gerar uma cobrança. Essas cinco operações são cobradas por resultados retornados, não por uma taxa fixa por solicitação. Respostas aninhadas e outros registros retornados podem afetar a contagem cobrada; não estime o custo apenas pelo tamanho do array de nível superior. Consulte os [preços atuais](https://openapi.felo.ai/api/v1/data/prices) e o uso no console. Os campos completos dos objetos estão no [esquema OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).