Felo API PlatformFelo API Platform

Felo Respostas a Posts do X

Provedor: Felo · Pago com saldo da plataforma

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. 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

CampoTipoObrigatórioSignificado
tweet_idsstring ou array de stringsSimUm ID de post ou um lote de até 20 IDs
cursorstringNãoAté 4.000 caracteres; use com um único ID de post
since_timeintegerNãoHora de início em segundos Unix
until_timeintegerNãoHora de término em segundos Unix

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

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:

{"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 e o uso no console. Os campos completos dos objetos estão no esquema OpenAPI.

Precisa de ajuda?