Busca semântica
Quem digita «esqueci minha senha» encontra o artigo chamado «redefinir suas credenciais de acesso»: os resultados são ordenados pela proximidade de significado, não por palavras em comum, no seu catálogo, wiki ou arquivo. Pague por uso, sem mensalidade.
Rode online
Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.
Busca que compara significado, não letras: a consulta vira um vetor e é confrontada com os trechos do seu índice, devolvendo os mais próximos em sentido — mesmo sem nenhuma palavra em comum. Para lojas, portais e sistemas internos onde a busca atual só acha o que foi digitado exatamente igual.
O problema da busca literal
A busca tradicional é um jogo de adivinhação invertido: o cliente precisa acertar a palavra que você usou no cadastro. Ele procura “sandália de dedo” e a loja escreveu “chinelo”; ele digita “nota retida na Sefaz” e o artigo diz “rejeição 539”. O resultado vazio não significa que a resposta não existe — significa que ninguém combinou o vocabulário antes.
É exatamente essa fricção que a comparação por significado elimina.
O que acontece a cada consulta
A consulta é transformada em vetor e comparada com todos os trechos do seu índice; os mais próximos em significado voltam ordenados por relevância. Erro de digitação leve, sinônimo regional, pergunta formulada de outro jeito — nada disso derruba a busca, porque a comparação acontece no plano do sentido.
Antes de buscar, indexe
A busca semântica consulta um índice seu — ela não sai vasculhando a internet. O primeiro passo é indexar o conteúdo com as tarefas de indexação do KIT: texto puro, documentos PDF ou as páginas do seu site. Montado o índice (até 10.000 trechos), cada consulta é uma chamada simples: pergunta entra, trechos relevantes saem.
O mesmo índice atende quantas consultas você precisar.
Casos de uso
E-commerce que fala a língua do cliente
Uma loja de eletrodomésticos indexou o catálogo. “Frigobar para kitnet” agora encontra a geladeira compacta de 93 litros — antes, a busca devolvia zero resultados e o cliente comprava no concorrente.
Ajuda que evita chamado
A central de ajuda da TecnoSul Soluções Digitais responde “boleto sumiu do e-mail” com o artigo sobre reenvio de faturas. O cliente resolve sozinho e o suporte respira.
Intranet que acha a política certa
Juliana Nascimento, do RH, pesquisa “posso emendar o feriado?” na intranet e recebe o trecho da política de ponto que trata de dias-ponte — um documento que jamais usa a palavra “emendar”.
Perguntas frequentes
Qual a diferença para a busca que já existe no meu site?
A busca típica de site compara palavras; esta compara significados. Na prática: menos “nenhum resultado encontrado”, mais respostas certas para perguntas mal digitadas, com sinônimo ou em linguagem coloquial.
Preciso indexar antes de buscar?
Sim. A consulta roda sobre o seu índice, montado com as tarefas de indexação de texto, de documentos ou de URLs. Sem índice, não há onde buscar.
E quando a palavra exata importa, tipo código de produto?
Aí a semântica pura pode não ser a melhor arma. Para bases com códigos, SKUs e termos técnicos, o KIT tem a busca híbrida, que combina correspondência exata com significado na mesma consulta.
Quanto custam 1.000 buscas por mês?
Se os usuários buscarem menos, você paga menos.
As buscas dos meus usuários ficam registradas?
Cada consulta é processada para devolver o resultado, que fica disponível na tarefa para o seu sistema consumir. Como integrador, evite embutir dados pessoais desnecessários no texto da consulta — a busca não precisa deles.
Vocês emitem nota fiscal?
Não emitimos nota fiscal brasileira: o serviço é contratado do exterior e pago em dólares via PayPal. O recibo do PayPal documenta a despesa para a sua contabilidade, como qualquer software estrangeiro.
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/search/semantic \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"¿dónde está el gato?"}'const res = await fetch("https://api.kit.forhosting.com/search/semantic", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"query": "¿dónde está el gato?"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/search/semantic",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"query": "¿dónde está el gato?"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/semantic", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"query":"¿dónde está el gato?"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"query":"¿dónde está el gato?"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/semantic", 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
{
"query": "¿dónde está el gato?"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.semantic",
"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_chunks | 10000 |
max_tokens | 20000 |
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 acontece a cada consulta
O retorno vem pela tarefa, em JSON, pronto para o seu sistema montar a página de resultados do jeito que quiser.
Preço por consulta, sem mensalidade
Para um e-commerce, vale comparar com o custo de um cliente que não achou o produto e foi embora: a conta se paga na primeira venda recuperada. Cada busca custa US$ 0,002 de chamada mais US$ 0,0015 de consulta: US$ 0,0035, tudo somado. Mil buscas saem por US$ 3,50 — e você paga só o que os seus usuários realmente pesquisarem, sem plano fixo nem franquia que expira.