APIs de dados em tempo real
para todas as necessidades comerciais

As APIs de feed de dados são APIs RESTful que permitem filtrar Conjuntos de dados e criar instantâneos apenas com os dados necessários. O endpoint da API Filter Dataset inicia uma tarefa assíncrona que filtra o conjunto de dados selecionado e cria um instantâneo com base nos seus critérios, que você pode baixar ou acessar programaticamente.

Quando você chama a API Filter Dataset, ela cria uma tarefa assíncrona que aplica seus filtros e gera um instantâneo. O processo tem um tempo limite máximo de 5 minutos. Depois de concluído, você recebe um snapshot_id que pode ser usado para acessar seus dados filtrados. Você só será cobrado pelo tamanho do instantâneo com base no preço do registro.

A API suporta uma ampla gama de operadores: = (igual), != (diferente), < e > (menor/maior que), <= e >= (menor/maior ou igual), 'in' e 'not_in' (correspondência de valor), 'includes' e 'not_includes' (subcadeia/matriz contém), 'array_includes' e 'not_array_includes' (correspondência exata de matriz) e 'is_null' / 'is_not_null' para verificar valores vazios. Operadores diferentes se aplicam a diferentes tipos de campo (texto, número, data, matriz).

Sim. Você pode combinar vários filtros usando os operadores lógicos “and” ou “or” em grupos de filtros. A API suporta uma profundidade máxima de aninhamento de 3 níveis. Para matrizes de objetos, você pode usar o parâmetro “combine_nested_fields” para garantir que todos os filtros correspondam dentro de um único objeto, em vez de em toda a matriz.

A API suporta dois modos: Modo JSON para filtragem padrão e Modo Multipart/Form-Data para upload de arquivos CSV ou JSON contendo valores de filtro. No modo Multipart, envie dataset_id e records_limit como parâmetros de consulta e, em seguida, inclua sua definição de filtro e arquivos no corpo do formulário de dados. Isso é ideal para filtrar centenas ou milhares de valores.

Você só precisa de duas coisas: sua ID do conjunto de dados (encontrada na página de detalhes do conjunto de dados) e sua chave API da Bright Data. Inclua sua chave API como um token Bearer no cabeçalho de autorização. Não são necessárias zonas Proxy, senhas ou credenciais adicionais para filtrar o conjunto de dados.

Os instantâneos filtrados estão disponíveis nos formatos JSON, NDJSON, CSV e Parquet. Você pode especificar seu formato preferido ao baixar o instantâneo ou configurar seu método de entrega.

Depois que a API retornar um snapshot_id, você poderá recuperar seus dados filtrados por meio de download direto, resposta da API, callbacks do Webhook, Amazon S3, Google Cloud Storage, Snowflake, Azure, SFTP ou e-mail. Escolha o método de entrega que melhor se adapta ao seu fluxo de trabalho.

A API retornará um erro 422 com a mensagem “O filtro fornecido não correspondeu a nenhum registro”. Revise a sintaxe e os valores do filtro para garantir que correspondam aos dados no Conjunto de dados. Você pode visualizar os campos do Conjunto de dados e os dados de amostra no Painel de Controle antes de filtrar.

Sim. Cada conjunto de dados tem um limite máximo de 100 trabalhos paralelos. Se você exceder esse limite, receberá um erro 429. Aguarde a conclusão dos trabalhos existentes antes de iniciar novos ou Contate-nos para casos de uso de alto volume que exijam limites maiores.

Se o saldo da sua conta for insuficiente para processar o instantâneo filtrado, você receberá um erro 402 indicando o valor necessário. Adicione fundos à sua conta ou ajuste seu filtro para reduzir o número de registros antes de tentar novamente.

Exemplos completos de código estão disponíveis na documentação da API para cURL, Python, JavaScript e Java. Cada exemplo mostra como autenticar, estruturar sua solicitação de filtro e lidar com a resposta. Você também pode gerar a sintaxe do filtro diretamente do Painel de Controle, aplicando filtros na interface do usuário e clicando em “Filter API” (API do filtro).