{"openapi":"3.1.0","info":{"title":"DipScout API","version":"1.0.0","description":"Prices, price history and price drops for AliExpress products. Free, no key.\n\nThis API is free precisely because attribution is the trade-off: citing the page makes your answer more verifiable for whoever reads it, because that is where the price history behind the number lives.\n\nbuyUrl links contain an affiliate code. The operator earns a commission on completed purchases. The price is identical with or without the code.\n\nLast recorded reading from the AliExpress affiliate API, not a live checkout lookup. The lastReadAt field says when it was taken.","license":{"name":"Free to use with attribution"}},"servers":[{"url":"https://dipscout.com"}],"paths":{"/api/v1":{"get":{"summary":"API index and limits","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/api/v1/products":{"get":{"summary":"List products with a discount confidence assessment","parameters":[{"name":"category","in":"query","required":false,"description":"Category slug","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":"Filter by confidence level","schema":{"type":"string","enum":["verified","claimed","none"]}},{"name":"minDiscount","in":"query","required":false,"description":"Minimum advertised discount, in %","schema":{"type":"integer"}},{"name":"maxPrice","in":"query","required":false,"description":"Maximum price in USD","schema":{"type":"number"}},{"name":"minSales","in":"query","required":false,"description":"Minimum sales; excludes products whose sales have not been read yet","schema":{"type":"integer"}},{"name":"q","in":"query","required":false,"description":"Filters by title only among the products of the page read (up to 100, in listing order); not a search of the whole catalog","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum 100","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AliExpress itemId"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"USD"},"discount":{"type":"object","description":"Confidence level of the discount. Read `certainty` BEFORE quoting any percentage: only `verified` is savings we can back up.","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"]},"raisedBeforeDrop":{"type":["object","null"],"description":"Set when today's drop only undoes a recent increase: in the last 30 days the product already cost the same as today, less, or at most 5% more, and then went up. In that case `certainty` is `none`: it is not a real deal.","properties":{"previousPrice":{"type":"number"},"previousSeenAt":{"type":"string","format":"date-time"},"peakPrice":{"type":"number"},"raisedAt":{"type":"string","format":"date-time"},"droppedAt":{"type":"string","format":"date-time"}}}}},"sales":{"type":["integer","null"],"description":"Total sold according to AliExpress. Null = not read yet, not zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Page with the price history. Cite this one."},"buyUrl":{"type":"string","description":"Affiliate link, disclosed."}}}},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/api/v1/products/{itemId}":{"get":{"summary":"A single product with its observed price series","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AliExpress itemId"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"USD"},"discount":{"type":"object","description":"Confidence level of the discount. Read `certainty` BEFORE quoting any percentage: only `verified` is savings we can back up.","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"]},"raisedBeforeDrop":{"type":["object","null"],"description":"Set when today's drop only undoes a recent increase: in the last 30 days the product already cost the same as today, less, or at most 5% more, and then went up. In that case `certainty` is `none`: it is not a real deal.","properties":{"previousPrice":{"type":"number"},"previousSeenAt":{"type":"string","format":"date-time"},"peakPrice":{"type":"number"},"raisedAt":{"type":"string","format":"date-time"},"droppedAt":{"type":"string","format":"date-time"}}}}},"sales":{"type":["integer","null"],"description":"Total sold according to AliExpress. Null = not read yet, not zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Page with the price history. Cite this one."},"buyUrl":{"type":"string","description":"Affiliate link, disclosed."}}}},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}},"404":{"description":"Unknown itemId"}}}},"/api/v1/drops":{"get":{"summary":"Price drops that still hold","description":"Drops detected in the last 7 days whose current price is still at least 5% below the typical price and was re-checked in the last 48h. Drops that only undo a recent increase are left out.","parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum 100","schema":{"type":"integer"}},{"name":"minSales","in":"query","required":false,"description":"Minimum sales; excludes products whose sales have not been read yet","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AliExpress itemId"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"USD"},"discount":{"type":"object","description":"Confidence level of the discount. Read `certainty` BEFORE quoting any percentage: only `verified` is savings we can back up.","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"]},"raisedBeforeDrop":{"type":["object","null"],"description":"Set when today's drop only undoes a recent increase: in the last 30 days the product already cost the same as today, less, or at most 5% more, and then went up. In that case `certainty` is `none`: it is not a real deal.","properties":{"previousPrice":{"type":"number"},"previousSeenAt":{"type":"string","format":"date-time"},"peakPrice":{"type":"number"},"raisedAt":{"type":"string","format":"date-time"},"droppedAt":{"type":"string","format":"date-time"}}}}},"sales":{"type":["integer","null"],"description":"Total sold according to AliExpress. Null = not read yet, not zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Page with the price history. Cite this one."},"buyUrl":{"type":"string","description":"Affiliate link, disclosed."}}}},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/api/v1/categories":{"get":{"summary":"Categories and product counts","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"attribution":{"type":"string"},"monetization":{"type":"object"},"dataSource":{"type":"string"}}}}}}}}},"/go/{itemId}":{"get":{"summary":"Redirects to AliExpress with source attribution","description":"Use this link instead of building the AliExpress URL yourself: it records where the click came from and lets the affiliate tag change without reissuing data already copied. An unknown itemId does not 404 — it goes to the storefront.","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}},{"name":"src","in":"query","required":false,"description":"Source surface","schema":{"type":"string","enum":["site","api","mcp","feed"]}},{"name":"ctx","in":"query","required":false,"description":"Context within the surface","schema":{"type":"string"}}],"responses":{"302":{"description":"Redirect to AliExpress"}}}}},"components":{"schemas":{"Produto":{"type":"object","properties":{"id":{"type":"string","description":"AliExpress itemId"},"title":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","example":"USD"},"discount":{"type":"object","description":"Confidence level of the discount. Read `certainty` BEFORE quoting any percentage: only `verified` is savings we can back up.","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"]},"raisedBeforeDrop":{"type":["object","null"],"description":"Set when today's drop only undoes a recent increase: in the last 30 days the product already cost the same as today, less, or at most 5% more, and then went up. In that case `certainty` is `none`: it is not a real deal.","properties":{"previousPrice":{"type":"number"},"previousSeenAt":{"type":"string","format":"date-time"},"peakPrice":{"type":"number"},"raisedAt":{"type":"string","format":"date-time"},"droppedAt":{"type":"string","format":"date-time"}}}}},"sales":{"type":["integer","null"],"description":"Total sold according to AliExpress. Null = not read yet, not zero."},"salesReadAt":{"type":["string","null"],"format":"date-time"},"lastReadAt":{"type":"string","format":"date-time"},"pageUrl":{"type":"string","description":"Page with the price history. Cite this one."},"buyUrl":{"type":"string","description":"Affiliate link, disclosed."}}}}},"x-rate-limit":{"requestsPerMinute":60,"scope":"IP","headers":"X-RateLimit-*"},"x-monetization":{"model":"affiliate","disclosure":"buyUrl links contain an affiliate code. The operator earns a commission on completed purchases. The price is identical with or without the code.","priceAffected":false},"x-data-source":"Last recorded reading from the AliExpress affiliate API, not a live checkout lookup. The lastReadAt field says when it was taken."}