{"openapi":"3.1.0","info":{"title":"MPH PUBLIC API","version":"1.0","description":"API pública somente leitura de inteligência comercial do MPH IA. Ofertas atuais, histórico, futuro, produtos, mercados e comparações."},"servers":[{"url":"https://api.menorprecohoje.com.br/v1"}],"paths":{"/status":{"get":{"operationId":"getStatus","summary":"Status da MPH PUBLIC API"}},"/capabilities":{"get":{"operationId":"getCapabilities","summary":"Descobre capacidades da API"}},"/offers":{"get":{"operationId":"listOffers","summary":"Lista ofertas vigentes","parameters":[{"name":"market","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"max_price","in":"query","schema":{"type":"number"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/search":{"get":{"operationId":"searchOffers","summary":"Busca ofertas vigentes por texto","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/products":{"get":{"operationId":"listProducts","summary":"Lista produtos vigentes agrupados","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/product":{"get":{"operationId":"getProductOffers","summary":"Consulta produto por MPH_ID ou nome","parameters":[{"name":"id","in":"query","schema":{"type":"string"}},{"name":"product","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/best-price":{"get":{"operationId":"findBestPrice","summary":"Encontra o menor preço vigente","parameters":[{"name":"product","in":"query","schema":{"type":"string"}},{"name":"id","in":"query","schema":{"type":"string"}}]}},"/compare":{"get":{"operationId":"compareMarkets","summary":"Compara o melhor preço do produto entre mercados","parameters":[{"name":"product","in":"query","schema":{"type":"string"}},{"name":"id","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/markets":{"get":{"operationId":"listMarkets","summary":"Lista indicadores dos mercados","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/stores":{"get":{"operationId":"listStores","summary":"Lista lojas ativas e geolocalização cadastrada","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/ranking":{"get":{"operationId":"getRanking","summary":"Ranking contextual","parameters":[{"name":"criterio","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/future":{"get":{"operationId":"listFutureOffers","summary":"Ofertas programadas","parameters":[{"name":"market","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"max_price","in":"query","schema":{"type":"number"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/history":{"get":{"operationId":"listHistoricalOffers","summary":"Histórico por período","parameters":[{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}},{"name":"market","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"max_price","in":"query","schema":{"type":"number"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/analytics":{"get":{"operationId":"getAnalytics","summary":"Analytics históricos","parameters":[{"name":"metric","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}}]}},"/top30":{"get":{"operationId":"getTop30","summary":"Top 30 vigente","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/top30-audited":{"get":{"operationId":"getTop30Audited","summary":"Top 30 auditado para publicação B2C","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}]}},"/snapshot-status":{"get":{"operationId":"getSnapshotStatus","summary":"Estado do snapshot FAST publicado"}}}}