search_offers
Buscar ofertas
Busca ofertas por produto, categoria, mercado, preço máximo ou vencimento hoje, com paginação; passe o mercado em market, não no texto.
Devolve só ofertas vigentes hoje, salvo include_expired=true.
sort: relevance (padrão com texto), price (menor preço), savings (maior economia) ou recent (mais recentes).
Exemplos: "ofertas de café", "arroz 5 kg até R$ 25 no Fort", "o que vence hoje"
Parameterssortquerycursormarketregioncategorymax_pricepage_sizeending_todayinclude_expired
find_cheapest
Onde está mais barato
Encontra o menor preço de um produto ou tipo de produto, agrupado por produto, com alternativas em outros mercados.
Considera só ofertas vigentes hoje.
Exemplos: "onde comprar carne mais barato hoje", "menor preço do leite"
Parameterslimitqueryrequiredregioncategoryalternatives
compare_product
Comparar produto entre mercados
Compara um produto específico (slug, id ou texto) entre os mercados, do mais barato ao mais caro, com a média e os últimos preços conhecidos.
Ofertas vigentes hoje; last_known traz vencidas há até 30 dias de mercados sem oferta vigente.
Exemplos: "compare o óleo Coamo 900 ml entre mercados", "preço do leite Tirol"
Parametersmarketregionproductrequired
top_deals
Melhores ofertas
Lista as melhores ofertas pela economia em relação à média, no geral, por categoria ou por mercado.
Considera só ofertas vigentes hoje.
Exemplos: "melhores ofertas agora", "melhores ofertas de bebidas", "o que o Giassi tem de bom hoje"
Parameterslimitmarketregioncategoryending_today
list_markets
Mercados cobertos
Lista os mercados cobertos com endereços e quantidade de ofertas; use query para confirmar o nome de um mercado.
Sem query, por padrão só mercados com oferta vigente hoje (with_active_only=true); com query, devolve o mercado mesmo sem oferta vigente e avisa em meta.notices.
Exemplos: "quais mercados vocês cobrem", "endereço do Fort"
Parametersqueryregionwith_active_only
get_market
Ofertas de um mercado
Mostra um mercado (slug, id ou nome): endereços, destaques, categorias e ofertas paginadas.
Considera só ofertas vigentes hoje. sort: relevance, price (menor preço), savings (maior economia) ou recent (padrão, mais recentes).
Exemplos: "ofertas do Angeloni", "o que tem no Cooper"
Parameterssortcursormarketrequiredregioncategorypage_size
list_categories
Categorias de produto
Lista as categorias de produto com a quantidade de ofertas e de mercados.
Conta só ofertas vigentes hoje.
Exemplos: "que tipos de produto existem", "quais categorias têm ofertas"
Parametersregion
basic_basket
Cesta básica por mercado
Calcula o custo da cesta básica por mercado; com market, detalha os itens daquele mercado.
Usa os preços vigentes do último cálculo (computed_at).
Exemplos: "cesta básica mais barata", "quanto custa a cesta no Bistek"
Parametersmarketregion
get_offer
Detalhe de uma oferta
Mostra o detalhe completo de uma oferta já devolvida por outra ferramenta, com o encarte de origem.
Exemplos: "mais detalhes dessa oferta", "qual o encarte dessa oferta"
Parametersoffer_idrequired
search
Buscar ofertas (conector do ChatGPT)
Busca ofertas vigentes e devolve até 20 resultados com id, título (preço, mercado e validade) e url; segue o contrato do conector do ChatGPT.
Considera só ofertas vigentes hoje.
Exemplos: "ofertas de café", "cerveja em promoção"
Parametersqueryrequired
fetch
Detalhe da oferta (conector do ChatGPT)
Devolve o texto completo de uma oferta pelo id vindo de search; segue o contrato do conector do ChatGPT.
Exemplos: "detalhe da oferta", "endereço do mercado dessa oferta"
Parametersidrequired