{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/application:app-store/app":{"get":{"operationId":"application_app_store_app","summary":"App","description":"App details by App Store id or bundle id.","tags":["application"],"parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string"},"example":"284882215"},{"name":"bundleId","in":"query","required":false,"schema":{"type":"string"},"example":"com.facebook.Facebook"},{"name":"country","in":"query","required":false,"description":"Two-letter storefront country code","schema":{"type":"string","default":"us","description":"Two-letter storefront country code"},"example":"us"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/application:app-store/search":{"get":{"operationId":"application_app_store_search","summary":"Search","description":"Search the App Store.","tags":["application"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"photo editor"},{"name":"country","in":"query","required":false,"description":"Two-letter storefront country code","schema":{"type":"string","default":"us","description":"Two-letter storefront country code"},"example":"us"},{"name":"entity","in":"query","required":false,"schema":{"type":"string","enum":["software","iPadSoftware","macSoftware","tvSoftware"],"default":"software"}},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":20,"description":"1-based page number"}},{"name":"count","in":"query","required":false,"description":"Items per page","schema":{"type":"integer","default":25,"minimum":1,"maximum":200,"description":"Items per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/application:app-store/developer":{"get":{"operationId":"application_app_store_developer","summary":"Developer","description":"All apps published by a developer (artist) id.","tags":["application"],"parameters":[{"name":"developerId","in":"query","required":true,"schema":{"type":"string"},"example":"284882218"},{"name":"country","in":"query","required":false,"description":"Two-letter storefront country code","schema":{"type":"string","default":"us","description":"Two-letter storefront country code"},"example":"us"},{"name":"entity","in":"query","required":false,"schema":{"type":"string","enum":["software","iPadSoftware","macSoftware","tvSoftware"],"default":"software"}},{"name":"count","in":"query","required":false,"description":"Items per page","schema":{"type":"integer","default":50,"minimum":1,"maximum":200,"description":"Items per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/application:app-store/reviews":{"get":{"operationId":"application_app_store_reviews","summary":"Reviews","description":"Customer reviews from Apple's review RSS feed (up to 10 pages of 50).","tags":["application"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"284882215"},{"name":"country","in":"query","required":false,"description":"Two-letter storefront country code","schema":{"type":"string","default":"us","description":"Two-letter storefront country code"},"example":"us"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["mostrecent","mosthelpful"],"default":"mostrecent"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1,"maximum":10}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/application:app-store/charts":{"get":{"operationId":"application_app_store_charts","summary":"Top Charts","description":"App Store top charts (free, paid, grossing, iPad, new) per country, optionally per genre id.","tags":["application"],"parameters":[{"name":"feed","in":"query","required":false,"schema":{"type":"string","enum":["topfreeapplications","toppaidapplications","topgrossingapplications","topfreeipadapplications","toppaidipadapplications","topgrossingipadapplications","newapplications","newfreeapplications","newpaidapplications"],"default":"topfreeapplications"}},{"name":"country","in":"query","required":false,"description":"Two-letter storefront country code","schema":{"type":"string","default":"us","description":"Two-letter storefront country code"},"example":"us"},{"name":"genre","in":"query","required":false,"description":"App Store genre id, e.g. 6014 = Games","schema":{"type":"string","description":"App Store genre id, e.g. 6014 = Games"},"example":"6014"},{"name":"count","in":"query","required":false,"description":"Items per page","schema":{"type":"integer","default":50,"minimum":1,"maximum":200,"description":"Items per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}