{"openapi":"3.1.0","info":{"title":"Descontinho API","version":"1.0.0","description":"Preços, histórico e quedas de produtos da Shopee Brasil. Gratuita, sem chave.\n\nEsta API é gratuita justamente porque a atribuição é a contrapartida: citar a página torna a sua resposta mais verificável para quem a lê, porque de lá sai o histórico de preço que sustenta o número.\n\nOs links buyUrl contêm código de afiliado. O operador recebe comissão sobre compras concluídas. O preço é idêntico com ou sem o código.\n\nÚltima leitura registrada da API de afiliados da Shopee, não uma consulta ao vivo ao checkout. O campo lastReadAt diz quando foi.","license":{"name":"Uso livre com atribuição"}},"servers":[{"url":"https://descontinho.app"}],"paths":{"/api/v1":{"get":{"summary":"Índice e limites da API","responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/api/v1/products":{"get":{"summary":"Lista produtos com avaliação de confiança do desconto","parameters":[{"name":"category","in":"query","required":false,"description":"Slug da categoria","schema":{"type":"string","enum":["eletronicos","informatica","casa","eletrodomesticos","beleza","saude","esportes","moda","infantil","pets","automotivo","mercado","papelaria","hobbies"]}},{"name":"certainty","in":"query","required":false,"description":"Filtra pelo grau de confiança","schema":{"type":"string","enum":["verified","claimed","none"]}},{"name":"minDiscount","in":"query","required":false,"description":"Desconto mínimo anunciado, em %","schema":{"type":"integer"}},{"name":"maxPrice","in":"query","required":false,"description":"Preço máximo em BRL","schema":{"type":"number"}},{"name":"minSales","in":"query","required":false,"description":"Mínimo de vendas; exclui produtos com vendas ainda não lidas","schema":{"type":"integer"}},{"name":"q","in":"query","required":false,"description":"Busca por texto no título","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Máximo 100","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Deslocamento","schema":{"type":"integer"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"itemId da Shopee"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"BRL"},"discount":{"type":"object","description":"Grau de confiança do desconto. Leia `certainty` ANTES de citar qualquer percentual: só `verified` é economia que podemos sustentar.","properties":{"certainty":{"type":"string","enum":["verified","claimed","none"]},"percent":{"type":["integer","null"]},"referencePrice":{"type":["number","null"]},"referenceLabel":{"type":["string","null"]},"savings":{"type":["number","null"]},"explanation":{"type":"string"},"warning":{"type":["string","null"]}}},"sales":{"type":["integer","null"],"description":"Total vendido segundo a Shopee. Nulo = ainda não lido, não zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Página com histórico. Cite esta."},"buyUrl":{"type":"string","description":"Link de afiliado, declarado."}}}},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/api/v1/products/{itemId}":{"get":{"summary":"Um produto com a série de preços observada","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"itemId da Shopee"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"BRL"},"discount":{"type":"object","description":"Grau de confiança do desconto. Leia `certainty` ANTES de citar qualquer percentual: só `verified` é economia que podemos sustentar.","properties":{"certainty":{"type":"string","enum":["verified","claimed","none"]},"percent":{"type":["integer","null"]},"referencePrice":{"type":["number","null"]},"referenceLabel":{"type":["string","null"]},"savings":{"type":["number","null"]},"explanation":{"type":"string"},"warning":{"type":["string","null"]}}},"sales":{"type":["integer","null"],"description":"Total vendido segundo a Shopee. Nulo = ainda não lido, não zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Página com histórico. Cite esta."},"buyUrl":{"type":"string","description":"Link de afiliado, declarado."}}}},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}},"404":{"description":"itemId desconhecido"}}}},"/api/v1/drops":{"get":{"summary":"Quedas detectadas","parameters":[{"name":"limit","in":"query","required":false,"description":"Máximo 100","schema":{"type":"integer"}},{"name":"minSales","in":"query","required":false,"description":"Mínimo de vendas; exclui produtos com vendas ainda não lidas","schema":{"type":"integer"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"itemId da Shopee"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"BRL"},"discount":{"type":"object","description":"Grau de confiança do desconto. Leia `certainty` ANTES de citar qualquer percentual: só `verified` é economia que podemos sustentar.","properties":{"certainty":{"type":"string","enum":["verified","claimed","none"]},"percent":{"type":["integer","null"]},"referencePrice":{"type":["number","null"]},"referenceLabel":{"type":["string","null"]},"savings":{"type":["number","null"]},"explanation":{"type":"string"},"warning":{"type":["string","null"]}}},"sales":{"type":["integer","null"],"description":"Total vendido segundo a Shopee. Nulo = ainda não lido, não zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Página com histórico. Cite esta."},"buyUrl":{"type":"string","description":"Link de afiliado, declarado."}}}},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/api/v1/categories":{"get":{"summary":"Categorias e contagem","responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/go/{itemId}":{"get":{"summary":"Redireciona para a Shopee com atribuição de origem","description":"Use este link em vez de montar a URL da Shopee: ele registra a origem do clique e permite trocar a tag de afiliado sem reemitir dado já copiado. itemId desconhecido não dá 404 — vai para a vitrine.","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}},{"name":"src","in":"query","required":false,"description":"Superfície de origem","schema":{"type":"string","enum":["site","api","mcp","feed"]}},{"name":"ctx","in":"query","required":false,"description":"Contexto dentro da superfície","schema":{"type":"string"}}],"responses":{"302":{"description":"Redirect para a Shopee"}}}}},"components":{"schemas":{"Produto":{"type":"object","properties":{"id":{"type":"string","description":"itemId da Shopee"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"BRL"},"discount":{"type":"object","description":"Grau de confiança do desconto. Leia `certainty` ANTES de citar qualquer percentual: só `verified` é economia que podemos sustentar.","properties":{"certainty":{"type":"string","enum":["verified","claimed","none"]},"percent":{"type":["integer","null"]},"referencePrice":{"type":["number","null"]},"referenceLabel":{"type":["string","null"]},"savings":{"type":["number","null"]},"explanation":{"type":"string"},"warning":{"type":["string","null"]}}},"sales":{"type":["integer","null"],"description":"Total vendido segundo a Shopee. Nulo = ainda não lido, não zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Página com histórico. Cite esta."},"buyUrl":{"type":"string","description":"Link de afiliado, declarado."}}}}},"x-rate-limit":{"requestsPerMinute":60,"scope":"IP","headers":"X-RateLimit-*"},"x-monetization":{"model":"affiliate","disclosure":"Os links buyUrl contêm código de afiliado. O operador recebe comissão sobre compras concluídas. O preço é idêntico com ou sem o código.","priceAffected":false},"x-data-source":"Última leitura registrada da API de afiliados da Shopee, não uma consulta ao vivo ao checkout. O campo lastReadAt diz quando foi."}