ForHosting KIT · Busca inteligente

Busca semântica

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.

● Estávelpor consultaUS$ 0,002

Executar — US$ 0,002 + US$ 0,0015/consulta Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

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.

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. O retorno vem pela tarefa, em JSON, pronto para o seu sistema montar a página de resultados do jeito que quiser.

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.

Preço por consulta, sem mensalidade

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. 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.

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?

US$ 3,50 — US$ 0,0035 por consulta, sem mensalidade nem mínimo. 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.

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

POSThttps://api.kit.forhosting.com/search/semantic

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 &#39;{"input":"…"}'

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({
    "input": "…"
  })
});
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[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
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" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
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

{
  "input": "…"
}

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

por chamadaUS$ 0,002

por consultaUS$ 0,0015

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.

Ver a documentação completa do KIT →