{"openapi":"3.1.0","info":{"title":"众推公开只读榜单 API","version":"1.0.0","description":"众推付费竞价排名：按所选范围内已确认付款减退款的有效净额排序，同额按先达到该余额的账本顺序排序。名次是核对时间的快照，会随付款、退款及内容状态变化；付费排名不代表质量、口碑或平台认证。未竞价内容及演示内容不在此结果中。"},"servers":[{"url":"https://siliconvalleyedu.com/api/public/v1"}],"paths":{"/regions":{"get":{"summary":"有效城市代码与名称","parameters":[],"responses":{"200":{"description":"公开只读结果；无缓存，每个IP共用每分钟60次的请求限制。","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","name"],"properties":{"code":{"type":"string"},"name":{"type":"string"}}}}}}},"400":{"description":"参数无效"},"404":{"description":"城市不可查看"},"429":{"description":"请求频率受限"}}}},"/categories":{"get":{"summary":"公开品类代码与名称","parameters":[],"responses":{"200":{"description":"公开只读结果；无缓存，每个IP共用每分钟60次的请求限制。","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","label"],"properties":{"code":{"type":"string"},"label":{"type":"string"}}}}}}},"400":{"description":"参数无效"},"404":{"description":"城市不可查看"},"429":{"description":"请求频率受限"}}}},"/rankings":{"get":{"summary":"公开付费排名快照","parameters":[{"name":"regionCode","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,32}$"},"description":"城市代码；日榜与本期榜必填。"},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["product","shop","place","fun","event"]},"description":"省略为综合榜。"},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["all-time","today","period"],"default":"all-time"},"description":"历史有效净额、北京时间日榜或本期榜。"},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"仅日榜可用，不得晚于北京时间今天。"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":10},"description":"最多10条；不提供翻页、偏移或批量导出。"}],"responses":{"200":{"description":"公开只读结果；无缓存，每个IP共用每分钟60次的请求限制。","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","attribution","sourceUrl","checkedAt","revision","scope","window","regionCode","category","period","definition","items"],"properties":{"schemaVersion":{"const":"1.0"},"attribution":{"const":"众推"},"sourceUrl":{"type":"string","format":"uri"},"checkedAt":{"type":"string","format":"date-time"},"revision":{"type":"string"},"scope":{"enum":["national","city"]},"window":{"enum":["all-time","today","period"]},"regionCode":{"type":["string","null"]},"category":{"type":["string","null"],"enum":["product","shop","place","fun","event",null]},"period":{"type":"object","additionalProperties":false,"required":["date","startsAt","endsAt"],"properties":{"date":{"type":["string","null"]},"startsAt":{"type":["string","null"]},"endsAt":{"type":["string","null"]}}},"definition":{"type":"string"},"items":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["id","title","merchantName","city","category","rank","url","isSponsored"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"merchantName":{"type":["string","null"]},"city":{"type":"object","additionalProperties":false,"required":["code","name"],"properties":{"code":{"type":"string"},"name":{"type":"string"}}},"category":{"type":"object","additionalProperties":false,"required":["code","label"],"properties":{"code":{"type":"string"},"label":{"type":"string"}}},"rank":{"type":"integer","minimum":1},"url":{"type":"string","format":"uri"},"isSponsored":{"const":true}}}}}}}}},"400":{"description":"参数无效"},"404":{"description":"城市不可查看"},"429":{"description":"请求频率受限"}}}},"/rankings.jsonld":{"get":{"summary":"相同快照的 Schema.org ItemList","parameters":[{"name":"regionCode","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,32}$"},"description":"城市代码；日榜与本期榜必填。"},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["product","shop","place","fun","event"]},"description":"省略为综合榜。"},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["all-time","today","period"],"default":"all-time"},"description":"历史有效净额、北京时间日榜或本期榜。"},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"仅日榜可用，不得晚于北京时间今天。"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":10},"description":"最多10条；不提供翻页、偏移或批量导出。"}],"responses":{"200":{"description":"公开只读结果；无缓存，每个IP共用每分钟60次的请求限制。","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/ld+json":{"schema":{"type":"object"}}}},"400":{"description":"参数无效"},"404":{"description":"城市不可查看"},"429":{"description":"请求频率受限"}}}},"/rankings.html":{"get":{"summary":"无需 JavaScript 的公开付费排名页面","parameters":[{"name":"regionCode","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,32}$"},"description":"城市代码；日榜与本期榜必填。"},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["product","shop","place","fun","event"]},"description":"省略为综合榜。"},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["all-time","today","period"],"default":"all-time"},"description":"历史有效净额、北京时间日榜或本期榜。"},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"仅日榜可用，不得晚于北京时间今天。"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":10},"description":"最多10条；不提供翻页、偏移或批量导出。"}],"responses":{"200":{"description":"公开只读结果；无缓存，每个IP共用每分钟60次的请求限制。","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"400":{"description":"参数无效"},"404":{"description":"城市不可查看"},"429":{"description":"请求频率受限"}}}},"/openapi.json":{"get":{"summary":"本 API 说明","parameters":[],"responses":{"200":{"description":"公开只读结果；无缓存，每个IP共用每分钟60次的请求限制。","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"参数无效"},"404":{"description":"城市不可查看"},"429":{"description":"请求频率受限"}}}}}}