{"openapi":"3.1.0","info":{"title":"淘宝优惠券查询器 API","version":"0.1.0","description":"本站面向 AI Agent 和自动化工作流提供淘宝商品链接查券能力。后端只走淘宝联盟 / 阿里妈妈变现链路，返回结构化优惠券数据和 promotion_url。"},"servers":[{"url":"https://www.taobaocoupon.com"}],"paths":{"/api/v1/coupon":{"get":{"operationId":"queryTaobaoCouponByUrl","summary":"通过淘宝商品链接查询优惠券和推广链接","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"description":"淘宝或天猫商品链接，例如 https://item.taobao.com/item.htm?id=123456789"}],"responses":{"200":{"description":"优惠券查询结果","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CouponResult"}}}},"400":{"description":"输入链接无效"}}}},"/api/v1/product/{itemId}":{"get":{"operationId":"getTaobaoProductCoupon","summary":"通过淘宝 item_id 查询商品优惠券缓存","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"商品优惠券结果","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CouponResult"}}}}}}}},"components":{"schemas":{"CouponResult":{"type":"object","required":["success","item_id","coupon_status","promotion_url","summary","last_checked_at"],"properties":{"success":{"type":"boolean"},"item_id":{"type":"string"},"title":{"type":"string"},"image_url":{"type":"string"},"source_url":{"type":"string"},"product_url":{"type":"string"},"coupon_status":{"type":"string","enum":["available","unavailable","expired","unknown"]},"original_price":{"type":"number"},"current_price":{"type":"number"},"coupon_amount":{"type":["number","null"]},"coupon_threshold":{"type":["number","null"]},"final_price":{"type":["number","null"]},"currency":{"type":"string","enum":["CNY"]},"commission_rate":{"type":["string","null"]},"commission_amount_estimate":{"type":["number","null"]},"promotion_url":{"type":"string","description":"对用户和 AI 暴露的唯一跳转入口。生产环境必须是淘宝联盟 / 阿里妈妈生成的带 PID 归因推广链接。"},"tracking_provider":{"type":"string"},"affiliate_disclosure":{"type":"string"},"last_checked_at":{"type":"string","format":"date-time"},"data_freshness_seconds":{"type":"number"},"summary":{"type":"string"},"provider_mode":{"type":"string","enum":["mock","live"]}}}}}}