{"openapi":"3.1.0","info":{"title":"Amazon CD & Vinyl Best Sellers API","description":"\nPrivate API for cached Amazon CDs & Vinyl Best Sellers chart data.\n\nProtected endpoints require the `X-API-Key` header.\n\nMain endpoint:\n\n`GET /amazon-cd/best-sellers/latest?category=all&limit=100`\n","version":"1.0.0"},"servers":[{"url":"/amazon-cd"}],"paths":{"/":{"get":{"tags":["system"],"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["system"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/categories":{"get":{"tags":["amazon-cd"],"summary":"Categories","operationId":"categories_amazon_cd_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/best-sellers/latest":{"get":{"tags":["amazon-cd"],"summary":"Latest Best Sellers","operationId":"latest_best_sellers_amazon_cd_best_sellers_latest_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}},{"name":"include_raw","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Raw"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/best-sellers/rank/{rank}":{"get":{"tags":["amazon-cd"],"summary":"Get By Rank","operationId":"get_by_rank_amazon_cd_best_sellers_rank__rank__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"rank","in":"path","required":true,"schema":{"type":"integer","title":"Rank"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Category"}},{"name":"include_raw","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Raw"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/best-sellers/snapshots":{"get":{"tags":["amazon-cd"],"summary":"List Snapshots","operationId":"list_snapshots_amazon_cd_best_sellers_snapshots_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/{asin}/history":{"get":{"tags":["amazon-cd"],"summary":"Product History","operationId":"product_history_amazon_cd_products__asin__history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"asin","in":"path","required":true,"schema":{"type":"string","title":"Asin"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"Enter your private API key from the .env file.","in":"header","name":"X-API-Key"}}}}