O que são Datasets?

Datasets são conjuntos de dados reunidos de forma coesa que representam, juntos, uma entrega de valor ao cliente; ou seja, toda consulta a uma API da Plataforma de Dados é uma consulta a um dataset que reúne dados que "conversam" entre si.

Os datasets da Plataforma de Dados são organizados em diversas APIs que podem fornecer dados de bases da própria BigDataCorp (Dados Internos), dados de fontes externas (On-Demand) ou de plataformas parceiras do mercado (Marketplace).

✅ APIs de Dados Internos

As APIs de Dados Internos contêm conjuntos de dados capturados, tratados e mantidos pela BigDataCorp. Quando o cliente chama alguma dessas APIs está acessando informações armazenadas no ambiente da BigDataCorp, o que garante melhor tempo de resposta e disponibilidade do serviço. Os Datasets Internos são organizados em APIs específicas para cada tipo de entidade. Por exemplo, a API de Pessoas é o conjunto de datasets internos que visa fornecer dados de pessoas ao receber parâmetros de identificação das mesmas.

📘

Para todos os datasets internos, disponibilizamos para os nossos clientes 500 requisições gratuitas por mês (contadas as requisições contra todos os datasets internos, desde que feitas via API). Essas requisições podem ser usadas para qualquer propósito.

📢 Importante

As consultas aos dataset de IA Generativa não estão elegíveis para o desconto das 500 consultas grátis por mês, portanto, elas sempre serão cobradas.

📝 API On-Demand

A API de On-Demand possui consultas executadas em tempo real que acessam diretamente alguma fonte de dados externa, para as quais não faz sentido - ou é tecnicamente inviável - a manutenção de bases off-line e de histórico de dados consultados.
Vale lembrar que as consultas on-demand possuem uma disponibilidade e um tempo de resposta diretamente atrelado à fonte e, portanto, podem ter variações grandes em relação aos Datasets Internos.

Essas consultas, no geral, não aceitam datas de referência, filtros e outras opções de consultas presentes nos Datasets Internos. As informações de como consultar estão disponíveis de forma específica em cada um dos Datasets da API de On-demand desta documentação, em sua parte técnica.

📢 Importante

As consultas on-demand não estão elegíveis para o desconto das 500 consultas grátis por mês, portanto, elas sempre serão cobradas.

🤝🏽 API de Marketplace

A API de Marketplace é formada por atributos ou conjuntos de dados construídos por nossos parceiros, que agrupamos e trazemos para o mercado. Dentro de cada um dos conjuntos de dados você achará uma descrição dos atributos retornados, uma breve descrição do parceiro que construiu aquele atributo e qualquer característica especial da informação retornada ou dos parâmetros que podem ser informados na consulta, além das chaves de consulta tradicionais.

Por se tratarem de informações geradas por parceiros, todos esses datasets são tratados como consultas on-demand. Isso significa que não disponibilizamos 500 consultas gratuitas por mês à esses dados e os mecanismos de consulta com data de referência podem não estar disponíveis para todos eles.

📢 Importante

As consultas de parceiros não estão elegíveis para o desconto das 500 consultas grátis por mês, portanto, elas sempre serão cobradas.