A documentação pública para desenvolvedores do RizzitGO registra uma mudança relevante em setembro de 2026: a versão 2.10 adicionou um endpoint de busca por palavra-chave voltado a parceiros. Isso não equivale a uma nova página pública de busca, mas mostra como a descoberta de produtos agora pode ser solicitada e devolvida como dados estruturados.
A mudança oficial é específica — e mais limitada do que algumas manchetes sugerem
O histórico da Open API informa que a versão 2.10 introduziu POST /open-api/goods/search no escopo goods:search:read. A solicitação contém uma palavra-chave, o número da página e o código da fonte, além de um valor opcional de ordenação. Os modos documentados são relevância, maior preço, menor preço e maior número de vendas.
Trata-se de uma API para parceiros, protegida por credenciais OAuth2, isolamento entre locatários e escopos concedidos. Ela não deve ser descrita como um feed público anônimo nem como prova de que todas as interfaces do RizzitGO oferecem os mesmos controles. A afirmação segura é que aplicativos parceiros aprovados podem solicitar resultados estruturados por palavra-chave usando o endpoint documentado.
Um resultado de busca agora contém mais do que um link de destino
O modelo de resposta inclui ID do produto, título, URL de detalhes, imagem principal, fonte, preço, preço original, número de vendas e campos de desconto. A paginação acrescenta página atual, tamanho da página, total de páginas e total de resultados. Esses campos dão a um índice de catálogo estrutura suficiente para agrupar e comparar resultados sem reduzir cada linha a um link colado de marketplace.
O campo de fonte é especialmente importante. O endpoint documenta Taobao, 1688, Weidian e Xianyu como fontes distintas. Um item de aparência semelhante pode, portanto, surgir em marketplaces, vendedores ou registros diferentes. Um índice responsável deve preservar esse contexto, em vez de apresentar resultados visualmente parecidos como um único produto verificado.
- Os resultados expõem títulos, imagens, preços e identificadores de origem
- A ordenação é uma escolha da solicitação à API, não uma nota de qualidade
- Vendas e descontos descrevem o anúncio de origem, não a aprovação da comunidade
O que muda para a descoberta no estilo planilha
Planilhas compartilhadas tradicionais são fáceis de distribuir, mas suas linhas envelhecem rapidamente. Um endpoint estruturado permite que uma integração aprovada atualize títulos, imagens e preços sem perder a capacidade de busca. Isso também torna a data da captura mais importante: quando um resultado é copiado para um diretório independente, a cópia pode se afastar da fonte.
Por isso, contagens de produtos devem ser tratadas como medições datadas, e não como afirmações permanentes. Um índice pode remover duplicatas, excluir registros incompletos ou atualizar um anúncio alterado e, de forma legítima, mostrar um total diferente de outro diretório que use outro horário de coleta ou método de normalização.
A paginação muda a forma de montar um conjunto completo de resultados
O endpoint não devolve um catálogo ilimitado em uma única resposta. O modelo informa a página atual, a quantidade retornada, o total de páginas e o total de itens. Um aplicativo parceiro que busca uma cobertura maior precisa continuar solicitando páginas e decidir como agir se uma página posterior mudar durante a mesma coleta.
Isso importa porque a busca de um marketplace não é uma exportação congelada de banco de dados. Novos anúncios podem surgir, preços podem mudar e a ordem pode se alterar durante a coleta. Se um índice atualizar várias páginas em horários diferentes, o diretório final poderá misturar momentos distintos, a menos que o publicador registre uma janela clara de coleta e repita páginas que falharam de maneira consistente.
A paginação também explica por que a contagem em destaque pode divergir do número de cartões visíveis. O total da API descreve a resposta da fonte para aquela consulta e aquele marketplace; o índice publicado pode exibir somente registros aprovados nas verificações de imagem, título, categoria e duplicidade.
A ordem dos resultados não é uma recomendação editorial
Os quatro modos documentados respondem a perguntas diferentes. Relevância tenta ordenar pelos termos digitados, preço reorganiza a mesma busca por um campo numérico e vendas prioriza o valor informado pelo marketplace de origem. Nenhuma dessas opções é apresentada como classificação de qualidade, autenticidade ou confiabilidade.
Essa diferença se perde facilmente em um site de planilha. Uma linha no topo pode parecer recomendada apenas por estar em destaque. Um diretório transparente deve informar se a ordem vem da fonte, do modo de ordenação escolhido ou das próprias regras de normalização, em vez de chamar o primeiro resultado de melhor achado.
O histórico de versões é útil pelo mesmo motivo. Ele documenta quando a busca por palavra-chave entrou na API de parceiros, mas não afirma que todas as planilhas antigas foram reconstruídas nem que toda interface voltada ao consumidor mudou naquela data.
O que a atualização não comprova
A resposta de busca não autentica produtos, não garante estoque e não certifica a qualidade que será entregue. A documentação também informa que o estado de coleções de cada membro e links personalizados de compartilhamento não são retornados. Os campos públicos ajudam na descoberta, mas não substituem a página atual do produto, os termos do vendedor ou as evidências do armazém.
Este buscador independente usa atualmente sua própria captura salva do catálogo; ele não está conectado à Open API do RizzitGO. A documentação do RizzitGO é analisada aqui por ser uma fonte primária sobre o modelo de dados publicado pela plataforma — não porque os dois conjuntos de dados sejam intercambiáveis.
Fontes e referências2 revisadas+
Estes links documentam os fatos usados acima. A redação e a análise desta página são originais deste site independente.
Recurso relacionado do site
Buscar no catálogo independente atual →