FlowData

Quais APIs de dados o FlowData oferece?

Publicado em 10. novembro 2026

O FlowData é composto por várias APIs de dados que você chama com a mesma chave FlowData em https://api.flowdata.one/v1. Este artigo explica rapidamente para que serve cada área e mostra uma requisição mínima de exemplo. Todos os parâmetros e exemplos de resposta estão na documentação da API.

Em todos os exemplos, substitua fd_SUA_CHAVE pela sua própria chave. Veja como obtê-la em Criar uma chave de API do FlowData.

IP Geolocation

Retorna país, região, cidade, coordenadas, fuso horário e provedor de um endereço IP ou domínio. Usos típicos: situar visitantes em uma região aproximada ou identificar pedidos suspeitos.

curl "https://api.flowdata.one/v1/geolocation/8.8.8.8?lang=de" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

Sem um endereço no caminho (/v1/geolocation), você recebe os dados do endereço IP de onde vem a requisição. Para consultar vários endereços de uma vez, use POST /v1/geolocation/batch. O corpo é um array JSON com no máximo 100 entradas:

curl -X POST "https://api.flowdata.one/v1/geolocation/batch" \
  -H "Authorization: Bearer fd_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '["8.8.8.8", "1.1.1.1"]'

Client Info

Retorna o endereço IP, indícios de proxy, navegador e idioma do cliente que faz a chamada. Essa área é gratuita e é uma boa opção para o primeiro teste.

curl "https://api.flowdata.one/v1/client-info" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

Maps

Busca de lugares, geocodificação e rotas. Há três endpoints:

  • GET /v1/maps/search com q (termo de busca) e, opcionalmente, limit (de 1 a 10) e country (por exemplo DE)
  • GET /v1/maps/geocode com address para ir de um endereço às coordenadas, ou com lat e lng para o caminho inverso
  • GET /v1/maps/directions com origin e destination, cada um como "longitude,latitude", e opcionalmente profile (driving, driving-traffic, walking, cycling)
curl "https://api.flowdata.one/v1/maps/geocode?address=Alexanderplatz%201,%20Berlin" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

Email Verifier

Verifica se um endereço de e-mail pode receber mensagens, por exemplo antes de incluí-lo na sua lista de newsletter. A resposta traz o endereço verificado (email_address) e o resultado (status e result). A chave sempre vai no cabeçalho, nunca na URL:

curl "https://api.flowdata.one/v1/email-verification/name%40example.com" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

A API responde a um endereço em formato inválido com HTTP 400.

YouTube

Retorna métricas de um canal do YouTube. Como identificador, informe o handle (por exemplo @YouTube) ou o ID do canal.

curl "https://api.flowdata.one/v1/youtube/stats/@YouTube" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

Processamento de mídia

Redimensiona e comprime vídeos, imagens e áudio, aplica marcas d'água e gera miniaturas. Diferente das outras áreas, o processamento de mídia funciona com trabalhos que rodam em segundo plano. Para começar, veja Iniciar um trabalho de mídia.

Bom saber

  • Você paga conforme o uso: por 1.000 requisições bem-sucedidas nas áreas de dados e por minuto de saída iniciado ou por imagem no processamento de mídia. O Client Info é gratuito. Requisições com falha, buscas no Maps sem resultado e o resultado de e-mail unknown não custam nada. Os valores estão na página de preços.
  • Cada requisição aparece no registro da respectiva área, assim você vê na hora se sua integração está chamando corretamente, veja Estatísticas e registro de chamadas.
  • Chame as APIs sempre a partir do seu servidor, para que sua chave não vá parar no navegador.

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API