Extrair coluna CSV

O que significa extrair uma coluna CSV e quando usar

Quando has_header é true, a primeira linha fornece os nomes das colunas e é excluída do array values retornado; quando é false, cada linha é dado e você deve selecionar por índice numérico. Não a use para filtrar linhas por condição, unir dois arquivos, renomear muitas colunas ou converter uma tabela inteira em JSON aninhado — são intenções de produto separadas com landings próprias.

Contrato de entrada, seleção por cabeçalho ou índice e campos da resposta

O delimiter opcional tem padrão vírgula; use um único caractere ou a forma comum "\t" para tabulação. A correspondência de cabeçalhos diferencia maiúsculas e minúsculas, de modo que Email e email são diferentes; quando um descompasso só de maiúsculas se resolveria de forma única, a mensagem de erro pode sugerir a grafia disponível. Envie um corpo JSON com o campo de string obrigatório csv igual ao texto não vazio da tabela e o column obrigatório igual a um nome de cabeçalho ou a um índice inteiro base zero (como número ou string numérica pura como "0"). Os aliases text, input, data, source, content e value são aceitos para o corpo CSV; col, field, index e name para o seletor. O opcional has_header tem padrão true; defina false quando a primeira linha já for dado. Falta de csv, csv vazio, csv não string, column ausente, nomes de cabeçalho desconhecidos, índices negativos ou fora do intervalo e campos entre aspas sem fechar disparam invalid_input com uma mensagem que nomeia o problema, e essas falhas não são cobradas na API pré-paga. Em sucesso a resposta inclui column como rótulo resolvido, column_index como posição base zero usada, values como as strings de célula em ordem (string vazia se uma linha curta não tiver essa célula), count igual ao comprimento de values, has_header e delimiter ecoando o modo, row_count como número de linhas de dados, method sempre csv_select_column, e headers com os nomes da primeira linha somente quando has_header é true — campos opcionais são omitidos em vez de null. Use só values quando uma lista de e-mails precisar apenas da coluna; use headers e column_index ao montar tabelas de UI que destaquem o campo selecionado.

Uso da API, preços, fluxos de trabalho e limites práticos

Chame a ferramenta gratuita no navegador para extrair coluna CSV em tabelas de dever de casa, exportações de CRM e puxadas rápidas de campo sem escrever um parser CSV em cada linguagem. Não espere inferência de tipos, parsing de datas ou detecção automática de delimitador além do parâmetro delimiter explícito — são problemas separados. Autores que enviam SDKs podem documentar csv e column como obrigatórios, mostrar um exemplo de sucesso com cabeçalho nomeado e um erro de coluna ausente para que integradores vejam os dois lados do contrato. Use a API pré-paga do KIT quando um CMS, etapa ETL, harness de QA, app de tutoria ou cliente móvel precisar do mesmo contrato com saldo a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após o motor rejeitar a requisição. Um fluxo típico cola uma exportação, seleciona a coluna email com has_header true e então alimenta values em um envio de e-mail ou etapa de deduplicação. Combine este endpoint com filter-csv ou csv-to-json quando o próximo passo for seleção de linhas ou um array completo de objetos, mas mantenha extrair coluna CSV como landing própria para que a intenção de um único campo não se misture com transformações de várias colunas. Mantenha payloads em tamanhos de documento ordinários adequados a um isolate de Worker, em vez de dumps de armazém de vários megabytes.