Calcule estatísticas de uma coluna CSV
Transforme uma coluna numérica de CSV em um resumo estatístico compacto sem abrir uma planilha nem escrever um script descartável.
Executar grátis
Forneça o texto CSV e o nome exato da coluna numérica para obter mínimo, máximo, média aritmética, mediana e desvio padrão populacional. Cada célula selecionada é validada antes do cálculo; colunas ausentes, células vazias, rótulos, infinitos e outros valores não numéricos geram um erro claro, em vez de um resultado parcial enganoso. Campos entre aspas, aspas escapadas, delimitadores configuráveis e terminações de linha comuns são processados de modo determinístico.
Forneça o texto CSV e escolha uma coluna
Comece com um texto CSV em que o primeiro registro seja o cabeçalho e os demais registros contenham as observações. Defina column como o cabeçalho exato que você deseja analisar. Espaços ao redor do cabeçalho são ignorados, mas a grafia e o uso de maiúsculas continuam relevantes, evitando que outro campo seja selecionado silenciosamente. A vírgula é o separador padrão. Se o arquivo usa ponto e vírgula, tabulação, barra vertical ou outro separador de um caractere, informe-o no campo de delimitador. Valores CSV entre aspas são aceitos, inclusive delimitadores e quebras de linha dentro das aspas, além de aspas duplicadas. O analisador considera como dados todos os registros posteriores ao cabeçalho; portanto, remova notas de rodapé sem relação com a tabela antes do envio. É necessário haver pelo menos um registro de dados. A resposta identifica a coluna escolhida e informa a quantidade de observações junto das cinco estatísticas, permitindo confirmar os valores incluídos antes de usar o resultado em relatório, regra de validação ou decisão automatizada de importação.
Entenda as cinco estatísticas retornadas
O mínimo e o máximo descrevem a faixa observada. A média é o valor aritmético obtido somando todos os números selecionados e dividindo o total pela quantidade. A mediana é o valor central depois da ordenação numérica; quando há um número par de observações, corresponde à média dos dois valores centrais. O desvio padrão é calculado na forma populacional: as distâncias quadráticas em relação à média são divididas pelo total de observações antes da raiz quadrada. Essa definição é adequada quando a coluna CSV representa toda a população que você pretende descrever. Se as linhas forem uma amostra para estimar uma população maior, aplique posteriormente uma correção amostral. Os resultados usam números JavaScript normalizados para quinze algarismos significativos, reduzindo artefatos de ponto flutuante sem eliminar precisão útil. A capacidade não infere unidades, remove valores atípicos, pondera observações nem reinterpreta moedas formatadas. Ela resume exatamente os valores numéricos finitos fornecidos na coluna selecionada.
Proteja as etapas seguintes com validação rigorosa
Estatísticas confiáveis dependem de uma coluna numérica consistente, por isso a validação é propositalmente rigorosa. A solicitação falha quando o cabeçalho informado não existe ou qualquer célula selecionada está vazia, ausente, contém infinito ou não é um número finito. Linhas problemáticas não são ignoradas silenciosamente, pois um cálculo sobre um conjunto menor pode parecer correto e ainda assim estar errado. Normalize símbolos monetários, separadores de milhar, percentuais e marcadores textuais de valores nulos antes de chamar esta capacidade. O erro identifica a coluna e, no caso de uma célula inválida, a posição da linha de dados contada a partir de um, facilitando localizar e corrigir o registro original. Isso torna a capacidade útil como controle de qualidade antes da ingestão: um resultado bem-sucedido confirma que a coluna esperada existe e que todas as linhas participam do cálculo. O processamento é determinístico, não usa rede e não retém o arquivo. O navegador permite uma verificação imediata, enquanto cada solicitação automatizada à API custa US$ 0,002.
Casos de uso
Verificar uma exportação de medições
Resuma uma coluna de sensores ou laboratório e compare sua faixa e dispersão com os limites operacionais esperados.
Validar um fluxo de entrada
Confirme que uma coluna numérica obrigatória existe e contém somente valores utilizáveis antes de importar o CSV.
Descrever resultados de pesquisa
Calcule tendência central e dispersão populacional de uma resposta numérica sem fórmulas de planilha.
Perguntas frequentes
Qual desvio padrão é retornado?
É retornado o desvio padrão populacional: a variância é dividida pelo total de observações antes de extrair a raiz quadrada.
As células vazias são ignoradas?
Não. Uma célula vazia ou ausente na coluna escolhida causa erro de entrada inválida para impedir um subconjunto não declarado.
O CSV pode usar outro separador além da vírgula?
Sim. Forneça qualquer delimitador válido de um caractere, como ponto e vírgula, tabulação ou barra vertical.
Há suporte a campos CSV entre aspas?
Sim. Delimitadores entre aspas, quebras de linha internas e aspas duplas escapadas seguem as convenções de CSV.
Quanto custa uma solicitação à API?
Cada solicitação à API custa US$ 0,002. A versão no navegador pode ser executada localmente em verificações interativas.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/data/csv-column-stats \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"csv":"name,score\nAda,10\nGrace,20\nLinus,30","column":"score"}'const res = await fetch("https://api.kit.forhosting.com/data/csv-column-stats", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"csv": "name,score\nAda,10\nGrace,20\nLinus,30",
"column": "score"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/data/csv-column-stats",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"csv": "name,score\nAda,10\nGrace,20\nLinus,30",
"column": "score"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/csv-column-stats", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"csv":"name,score\\nAda,10\\nGrace,20\\nLinus,30","column":"score"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"csv":"name,score\nAda,10\nGrace,20\nLinus,30","column":"score"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/csv-column-stats", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"csv": "name,score\nAda,10\nGrace,20\nLinus,30",
"column": "score"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "data.csv_column_stats",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 25 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |