Logo

O que é Unefesta?

Documentação de Dados Unefesta para IA e Desenvolvedores

Esta página é o ponto oficial de integração para agentes, LLMs, buscadores e aplicações que precisam consumir dados estruturados do marketplace Unefesta. Os feeds públicos foram projetados para consulta sem autenticação, com paginação, filtros e payload consistente para cenários de descoberta, recomendação e automação. O objetivo é permitir que sistemas externos consigam interpretar rapidamente fornecedores, serviços, preços e disponibilidade, com metadados suficientes para decisão e roteamento inteligente.

Uso por IA e agentes

Os feeds da Unefesta podem ser utilizados por sistemas de IA para recomendação de fornecedores, planejamento automático de eventos, comparação de preços e verificação de disponibilidade por data. Em fluxos de recomendação, o agente pode combinar filtros de cidade e categoria para retornar opções mais relevantes para o contexto do usuário final. Em fluxos de planejamento, o campo de disponibilidade permite validar rapidamente datas viáveis e identificar alternativas quando um serviço não está disponível no dia desejado.

Para comparadores de orçamento, os campos de preço, categoria e subcategoria permitem organizar listas homogêneas e gerar comparativos por faixa de valor. Para assistentes conversacionais, a URL pública de cada item facilita o handoff para navegação humana, mantendo transparência da recomendação. Esse formato também foi pensado para indexação por crawlers e sistemas de resposta generativa, aumentando a chance de citação correta da origem.

Exemplos reais de requisição

GET /api/public-feed?page=1&pageSize=10
GET /api/ai-feed?city=campinas&category=buffet&date=2026-03-10

Exemplo real de resposta

{
  "id": "123",
  "title": "Buffet Infantil Completo",
  "category": "buffet",
  "price": 2500,
  "currency": "BRL",
  "location": {
    "city": "Campinas",
    "state": "SP",
    "country": "BR"
  },
  "availability": [
    {
      "date": "2026-03-10",
      "available": true,
      "price": 2500
    }
  ],
  "url": "https://www.unefesta.com.br/servico/123"
}

Guia técnico de consumo

O endpoint /api/public-feed atende cenários de descoberta ampla e indexação. O endpoint /api/ai-feed inclui disponibilidade por data para uso em agentes de planejamento e matching. Ambos aceitam page e pageSize, além de filtros por city, category e date. Também há compatibilidade com parâmetros legados, permitindo transição gradual de integrações existentes sem quebra imediata.

O payload foi desenhado para leitura confiável por modelos de linguagem: campos textuais são normalizados, as datas seguem padrão YYYY-MM-DD, a moeda é fixa em BRL e cada item contém dados suficientes para decisão sem depender de chamadas adicionais. Itens incompletos são descartados do feed para preservar qualidade de consumo, evitando que sistemas automáticos recebam registros sem título, sem preço, sem localização ou sem URL válida.