Extrair números de um texto
Uma frase com 12.5%, 1,234,567.89, 3 fábricas, 4200 unidades, margem de -1.5 e 2e3 peças devolve exatamente esses 6 números, na ordem de leitura e com os repetidos. Cole um relatório ou uma anotação de laboratório e copie os valores. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Tirar cifras de um parágrafo é tarefa diária de analistas, estudantes, jornalistas e de quem herda um relatório como prosa em vez de planilha. Esta ferramenta percorre o texto da esquerda para a direita e lista cada inteiro e cada decimal que encontra, inclusive valores com sinal, agrupamento inglês de milhares e notação científica, na ordem em que aparecem. Serve para puxar quantidades de atualizações de status, anotações de laboratório, faturas escritas em frases e resumos de changelog sem abrir uma planilha nem redigir uma expressão regular. Texto vazio ou ausente falha com entrada inválida para que ninguém armazene uma carga silenciosa.
O que conta como número e como os tokens são lidos em ordem
Um número em prosa contínua não é o mesmo objeto que uma célula de planilha. As pessoas escrevem 42, 3.14, .75, +2, o valor -1.5, 1,234.56 e 2e3 na mesma frase, e também escrevem intervalos como páginas 10-20 e versões como v1.2.3 que parecem numéricos mas não devem colapsar em um único decimal. Esta capacidade percorre a cadeia uma vez, da esquerda para a direita, e guarda cada token que é inteiro ou decimal sob um conjunto fixo de regras.
Um mais ou menos inicial é sinal só no começo do texto ou após espaço ou pontuação de abertura, de modo que uma variação de -1.5 leva sinal enquanto o intervalo 10-20 produz dois inteiros sem sinal. O agrupamento inglês de milhares é aceito quando as vírgulas separam grupos de exatamente três dígitos, então 1,234,567.89 é um só valor. Aceita-se um decimal que começa com ponto, como .75.
Expoentes científicos na forma e ou E mais um sinal opcional e ao menos um dígito fazem parte do mesmo token. Sequências com vários pontos que lembram versões de software ou endereços IPv4 são partidas em componentes inteiros, de modo que v1.2.3 vira 1, 2 e 3, e não 1.2 seguido de .3. A ordem é sempre a da primeira aparição, inclusive duplicatas, porque um relatório que repete a mesma cifra duas vezes diz algo diferente de um despejo de valores únicos.
Contrato de entrada, campos da resposta e quando o pedido é recusado
Não encontrar números é um sucesso válido: numbers fica um array vazio e count vale zero, o resultado honesto de um parágrafo que só tem palavras. Use numbers sozinho quando quiser colar as cifras de volta em um documento. Use values quando um script for somar, ordenar ou comparar.
Como o algoritmo é lógica pura de cadeias, testes de integração contínua podem fixar o objeto inteiro. Mantenha as cargas em tamanhos de documento comuns, não despejos de vários megabytes; este produto é uma utilidade de texto, não um armazém em massa. O texto de origem segue as mesmas regras de retenção que outros itens de parse do KIT.
Casos de uso
Puxar cifras de relatórios escritos
Analistas colam um parágrafo trimestral e recebem cada inteiro e decimal em ordem, com milhares agrupados e percentuais reduzidos ao token numérico.
Anotações de laboratório e deveres
Estudantes e técnicos extraem valores medidos de anotações contínuas sem redigitar cada leitura em uma planilha à mão.
Perguntas frequentes
Como extraio números de um texto?
O array numbers da resposta lista cada inteiro e decimal na ordem de primeira aparição, e values guarda os mesmos tokens como números finitos.
Ele conserva decimais como 3.14 e .75?
Sim. Inteiros, decimais comuns, decimais com ponto inicial, agrupamento inglês de milhares e notação científica são todos coletados.
A ferramenta para extrair números de um texto é gratuita?
A ferramenta do navegador roda grátis no seu dispositivo.
Um intervalo de páginas como 10-20 vira um número negativo?
Não. Um menos é sinal só no início ou após espaço ou pontuação de abertura, então 10-20 produz 10 e 20, enquanto uma variação de -1.5 produz -1.5.
Por que uma versão como v1.2.3 gera três números separados?
Porque uma sequência com vários pontos parece uma versão ou um endereço, não um decimal. Ela é dividida nas partes inteiras, então v1.2.3 gera 1, 2 e 3 em vez de um enganoso 1.2 seguido de .3.
Ferramentas relacionadas
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/str/extract-numbers \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Quarterly report: revenue rose 12.5% to $1,234,567.89 after 3 plants shipped 4200 units at -1.5 margin and 2e3 spares."}'const res = await fetch("https://api.kit.forhosting.com/str/extract-numbers", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Quarterly report: revenue rose 12.5% to $1,234,567.89 after 3 plants shipped 4200 units at -1.5 margin and 2e3 spares."
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/str/extract-numbers",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Quarterly report: revenue rose 12.5% to $1,234,567.89 after 3 plants shipped 4200 units at -1.5 margin and 2e3 spares."
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/extract-numbers", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Quarterly report: revenue rose 12.5% to $1,234,567.89 after 3 plants shipped 4200 units at -1.5 margin and 2e3 spares."}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Quarterly report: revenue rose 12.5% to $1,234,567.89 after 3 plants shipped 4200 units at -1.5 margin and 2e3 spares."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/extract-numbers", 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
{
"text": "Quarterly report: revenue rose 12.5% to $1,234,567.89 after 3 plants shipped 4200 units at -1.5 margin and 2e3 spares."
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.extract_numbers",
"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_chars | 100000 |
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. |
Notas técnicas
O que conta como número e como os tokens são lidos em ordem
Marcas de moeda, sinais de porcentagem e palavras de unidade são fronteiras, não parte do token: 12.5% e $42.00 contribuem 12.5 e 42.00.
Contrato de entrada, campos da resposta e quando o pedido é recusado
Envie um corpo JSON com o campo de cadeia obrigatório text igual à amostra não vazia que você deseja analisar. Aceitam-se os aliases input, value, s, content, body e string quando clientes antigos ou geradores de formulário usam esses nomes. Um text ausente, um valor que não é cadeia, uma cadeia de comprimento zero ou uma cadeia só de espaços elevam invalid_input com uma mensagem que nomeia o problema, e essas falhas não são cobradas na API pré-paga. O comprimento é limitado a cem mil caracteres para manter a varredura limitada no navegador e no Worker; o excesso também é invalid_input. Em caso de sucesso a resposta inclui numbers como lista ordenada de tokens superficiais para que 1,234.50 e 007 continuem legíveis, values como os mesmos tokens interpretados em números IEEE finitos sem vírgulas de milhar, count como o comprimento compartilhado, integer_count para tokens sem ponto decimal nem expoente, decimal_count para os que têm, original ecoando a entrada exata para tabelas de interface, e method sempre extract_numbers para que o código seguinte ramifique sem farejar formas.
Uso da API, preços, fluxos de trabalho e o que esta ferramenta não é
Chame a ferramenta gratuita no navegador para extrair números de um texto em deveres, trechos de fatura, cadernos de laboratório e auditorias rápidas, sem escrever uma expressão regular em cada linguagem. Um fluxo típico cola um parágrafo trimestral, lista as cifras e copia values para uma planilha. Não espere que esta página classifique se um número é preço, quantidade ou ano — essa é outra intenção de busca, atendida por extratores estruturados. Quem publica SDKs pode documentar text como único campo obrigatório, mostrar um exemplo de sucesso com inteiros e decimais misturados e um exemplo de erro de cadeia vazia para que quem integra veja os dois lados do contrato. Use a API pré-paga do KIT quando um CMS, um pipeline de conteúdo, um harness de QA, um aplicativo de tutoria ou um cliente móvel precisarem do mesmo contrato sob saldo a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo depois que o motor recusa o pedido. Combine este endpoint com um extrator de importes quando o próximo passo forem moedas, impostos e totais rotulados, ou com um extrator de datas quando precisar de datas de calendário normalizadas em vez dos dígitos crus de uma cadeia de data.
Casos de integração
Fixtures de CI para analisadores numéricos
Scripts de build fixam números extraídos e valores interpretados para que regressões de sinal, milhares e notação científica falhem de imediato na integração contínua.
Perguntas técnicas
O que acontece se text estiver vazio?
O pedido falha com invalid_input. Entrada vazia ou só de espaços não é permitida; falhas de validação não são cobradas na API pré-paga.