{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources. Success responses include a `source` block to cite. Apizie Finance endpoints (SEC EDGAR, FRED, ECB, U.S. Treasury, GLEIF, World Bank, official:*) need a Finance plan."},"servers":[{"url":"https://apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/entertainment:hubhopper/get-categories":{"get":{"operationId":"entertainment_hubhopper_get_categories","summary":"Get the list of all content categories.","description":"GET /categories","tags":["entertainment"],"x-apizie-access":"read","parameters":[{"name":"pageSize","in":"query","required":false,"description":"Provide the size of the page to fetch.","schema":{"type":"string","description":"Provide the size of the page to fetch."}},{"name":"page","in":"query","required":false,"description":"Provide the page number to fetch.","schema":{"type":"string","description":"Provide the page number to fetch."}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/entertainment:hubhopper/get-categories-category-id":{"get":{"operationId":"entertainment_hubhopper_get_categories_category_id","summary":"Get specific content category.","description":"GET /categories/{categoryId}","tags":["entertainment"],"x-apizie-access":"read","parameters":[{"name":"categoryId","in":"query","required":true,"description":"Unique qualifier for a category.","schema":{"type":"string","description":"Unique qualifier for a category."}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/entertainment:hubhopper/get-categories-category-id-podcasts":{"get":{"operationId":"entertainment_hubhopper_get_categories_category_id_podcasts","summary":"Get a list of all podcasts under a category.","description":"GET /categories/{categoryId}/podcasts","tags":["entertainment"],"x-apizie-access":"read","parameters":[{"name":"categoryId","in":"query","required":true,"description":"Unique qualifier for a category.","schema":{"type":"string","description":"Unique qualifier for a category."}},{"name":"page","in":"query","required":false,"description":"Provide the page number to fetch.","schema":{"type":"string","description":"Provide the page number to fetch."}},{"name":"pageSize","in":"query","required":false,"description":"Provide the size of the page to fetch.","schema":{"type":"string","description":"Provide the size of the page to fetch."}},{"name":"order","in":"query","required":false,"description":"Order the items by 'newest' | 'random'","schema":{"type":"string","description":"Order the items by 'newest' | 'random'"}},{"name":"filters","in":"query","required":false,"description":"Takes filters like 'lang' in a url encoded json. Example: 1)Single ->      var filterJson = {\"lang\":[\"en\"]};…","schema":{"type":"string","description":"Takes filters like 'lang' in a url encoded json. Example: 1)Single ->      var filterJson = {\"lang\":[\"en\"]};…"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/entertainment:hubhopper/get-podcasts":{"get":{"operationId":"entertainment_hubhopper_get_podcasts","summary":"Get the list of all podcasts.","description":"GET /podcasts","tags":["entertainment"],"x-apizie-access":"read","parameters":[{"name":"page","in":"query","required":false,"description":"Provide the page number to fetch.","schema":{"type":"string","description":"Provide the page number to fetch."}},{"name":"pageSize","in":"query","required":false,"description":"Provide the size of the page to fetch.","schema":{"type":"string","description":"Provide the size of the page to fetch."}},{"name":"order","in":"query","required":false,"description":"Order the items by 'newest' | 'random'","schema":{"type":"string","description":"Order the items by 'newest' | 'random'"}},{"name":"filters","in":"query","required":false,"description":"Takes filters like 'lang' in a url encoded json. Example: 1)Single ->      var filterJson = {\"lang\":[\"en\"]};…","schema":{"type":"string","description":"Takes filters like 'lang' in a url encoded json. Example: 1)Single ->      var filterJson = {\"lang\":[\"en\"]};…"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/entertainment:hubhopper/get-podcasts-podcast-id":{"get":{"operationId":"entertainment_hubhopper_get_podcasts_podcast_id","summary":"Get a single Podcast.","description":"GET /podcasts/{podcastId}","tags":["entertainment"],"x-apizie-access":"read","parameters":[{"name":"podcastId","in":"query","required":true,"description":"Unique qualifier for a podcast.","schema":{"type":"string","description":"Unique qualifier for a podcast."}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/entertainment:hubhopper/get-podcasts-podcast-id-episodes":{"get":{"operationId":"entertainment_hubhopper_get_podcasts_podcast_id_episodes","summary":"Get a list of all episodes under a podcast.","description":"GET /podcasts/{podcastId}/episodes","tags":["entertainment"],"x-apizie-access":"read","parameters":[{"name":"page","in":"query","required":false,"description":"Provide the page number to fetch.","schema":{"type":"string","description":"Provide the page number to fetch."}},{"name":"pageSize","in":"query","required":false,"description":"Provide the size of the page to fetch.","schema":{"type":"string","description":"Provide the size of the page to fetch."}},{"name":"order","in":"query","required":false,"description":"Order the items by 'newest' | 'random'","schema":{"type":"string","description":"Order the items by 'newest' | 'random'"}},{"name":"filters","in":"query","required":false,"description":"Takes filters like 'lang' in a url encoded json. Example: 1)Single ->      var filterJson = {\"lang\":[\"en\"]};…","schema":{"type":"string","description":"Takes filters like 'lang' in a url encoded json. Example: 1)Single ->      var filterJson = {\"lang\":[\"en\"]};…"}},{"name":"podcastId","in":"query","required":true,"description":"Unique qualifier for a podcast.","schema":{"type":"string","description":"Unique qualifier for a podcast."}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/entertainment:hubhopper/get-util-languages":{"get":{"operationId":"entertainment_hubhopper_get_util_languages","summary":"GET /util/languages","description":"GET /util/languages","tags":["entertainment"],"x-apizie-access":"read","parameters":[{"name":"pageSize","in":"query","required":false,"description":"Provide the size of the page to fetch.","schema":{"type":"string","description":"Provide the size of the page to fetch."}},{"name":"page","in":"query","required":false,"description":"Provide the page number to fetch.","schema":{"type":"string","description":"Provide the page number to fetch."}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"official:company"},"data":{},"source":{"type":"object","description":"Where the data came from. Cite it.","properties":{"official":{"type":"boolean"},"provider":{"type":"string","example":"SEC EDGAR"},"publisher":{"type":"string","example":"U.S. Securities and Exchange Commission"},"url":{"type":"string","format":"uri","description":"A page a person can open to check the value"},"apiUrl":{"type":"string","format":"uri","description":"The official API URL that was called (credentials removed)"},"retrievedAt":{"type":"string","format":"date-time"},"license":{"type":"string"},"licenseUrl":{"type":"string","format":"uri"},"attribution":{"type":"string"},"notice":{"type":"string"}}},"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"}}}}}}}