Recomendação de produtos
Gera recomendações a partir do conteúdo do seu catálogo: quem está vendo um item recebe sugestões do que é parecido ou complementar em significado. Não precisa de histórico de navegação nem de regras cadastradas à mão — funciona desde o primeiro dia, inclusive para produto recém-cadastrado. Para lojas, blogs e catálogos de cursos.
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.
Recomendação sem big data
Os grandes marketplaces recomendam com base em milhões de cliques — volume que uma loja média nunca terá. A alternativa honesta é recomendar pelo conteúdo: se as descrições de dois produtos são próximas em significado, um é boa sugestão na página do outro. Nada de esperar seis meses de tráfego para “treinar” alguma coisa, nada de cadastrar relação produto a produto na mão.
Do catálogo indexado à sugestão na tela
O caminho tem duas etapas. Primeiro, o catálogo entra num índice — descrições, títulos, categorias — usando as tarefas de indexação do KIT. Depois, cada pedido de recomendação indica um item e recebe os vizinhos mais próximos em significado, ordenados, em JSON. Seu sistema decide a vitrine: “produtos parecidos”, “complete o look”, “leia também”. A tarefa entrega a matéria-prima ordenada; a curadoria de exibição é sua.
Produto novo nunca fica órfão
Recomendadores baseados em cliques têm um ponto cego famoso: o item recém-cadastrado, que ninguém clicou ainda, não é recomendado — e por não ser recomendado, ninguém clica. Recomendando por conteúdo, o produto que entrou no catálogo hoje já aparece como sugestão nos produtos parecidos hoje mesmo, porque a semelhança vem da descrição, não do histórico.
Uma conta que cabe no bolso da loja
Cada consulta custa US$ 0,002 de chamada mais US$ 0,0015: US$ 0,0035. E tem um atalho que barateia tudo: como a recomendação depende do catálogo, não do visitante, você pode gerá-la uma vez por produto e guardar no seu banco. Um catálogo de 3.000 produtos custa US$ 10,50 por rodada completa — refeita quando o catálogo mudar, não a cada visita.
Casos de uso
Loja de suplementos
Na página do whey protein, a vitrine “quem treina também leva” mostra creatina e coqueteleira — sugestões vindas da semelhança de descrição, geradas no dia em que o catálogo foi indexado, sem um clique de histórico.
Blog que segura o leitor
Um portal de receitas gera o bloco “você também vai gostar” para 1.200 posts. Quem termina a receita de pão de queijo recebe chipa e biscoito de polvilho — parentesco que nenhuma tag manual tinha registrado.
Plataforma de cursos livres
Uma escola online recomenda o próximo curso pelo conteúdo da ementa. Quem concluiu “Excel para financeiro” vê “planilhas de fluxo de caixa” — e a taxa de matrícula em segundo curso agradece.
Perguntas frequentes
Preciso de histórico de cliques ou de vendas?
Não — essa é a diferença central. A semelhança vem do conteúdo do catálogo, então a recomendação funciona desde o primeiro dia, mesmo numa loja recém-lançada.
Funciona para produto que acabou de ser cadastrado?
Sim: assim que o item entra no índice, ele passa a receber e a gerar recomendações. O problema clássico do “item novo invisível” simplesmente não existe aqui.
Pago por cada visita na página do produto?
Não precisa: gere as recomendações uma vez por produto, grave no seu banco e sirva localmente. Refaça a rodada quando o catálogo mudar — é assim que a conta fica pequena.
Quanto custa uma rodada completa no meu catálogo?
Uma consulta por produto: um catálogo de 3.000 itens custa US$ 10,50 (3.000 × US$ 0,0035). Catálogo de 500 itens, US$ 1,75. Sem mensalidade.
Preciso mandar dados dos meus clientes?
Não: a recomendação usa o catálogo, não o comportamento de quem navega. Nenhum dado pessoal de cliente é necessário — um desenho que já nasce confortável para a LGPD.
E se eu quiser falar com alguém antes de integrar?
Chama no WhatsApp ou manda e-mail para [email protected]. Quem responde é gente de verdade, em espanhol ou inglês — escrevendo em português, a gente se entende do mesmo jeito.
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/recommend \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/search/recommend", {
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/recommend",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/recommend", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/recommend", 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.recommend",
"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. |