{"note":"OpenAPI conversion -- returning structured metadata","name":"hubhopper-com","description":"Hubhopper Partner Integration API(s) - Production","version":"v5","base_url":"https://apis.hubhopper.com/partner","endpoints":7,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Hubhopper Partner Integration API(s) - Production\n@base https://apis.hubhopper.com/partner\n@version v5\n@auth ApiKey x-api-key in header | ApiKey hhPartnerId in header\n@endpoints 7\n@toc categories(3), podcasts(3), util(1)\n\n@group categories\n@endpoint GET /categories\n@desc Get the list of all content categories.\n@optional {pageSize: any # Provide the size of the page to fetch., page: any # Provide the page number to fetch.}\n@returns(200) 200 response\n@errors {404: 404 response, 500: 500 response}\n\n@endpoint GET /categories/{categoryId}\n@desc Get specific content category.\n@required {categoryId: any # Unique qualifier for a category.}\n@returns(200) 200 response\n@errors {404: 404 response, 500: 500 response}\n\n@endpoint GET /categories/{categoryId}/podcasts\n@desc Get a list of all podcasts under a category.\n@required {categoryId: any # Unique qualifier for a category.}\n@optional {page: any # Provide the page number to fetch., pageSize: any # Provide the size of the page to fetch., order: any # Order the items by 'newest' | 'random', filters: any # Takes filters like 'lang' in a url encoded json.  Example: 1)Single -> &nbsp;&nbsp;&nbsp;&nbsp; var filterJson = {\"lang\":[\"en\"]}; &nbsp;&nbsp;&nbsp;&nbsp; var url = baseUrl+'?'+filters=enocdeURI(JSON.stringify(filterJson)); 2)Multiple -> &nbsp;&nbsp;&nbsp;&nbsp; var filterJson = {\"lang\":[\"en\",\"hi\"]}; &nbsp;&nbsp;&nbsp;&nbsp; var url = baseUrl+'?'+filters=enocdeURI(JSON.stringify(filterJson));}\n@returns(200) 200 response\n@errors {404: 404 response, 500: 500 response}\n\n@endgroup\n\n@group podcasts\n@endpoint GET /podcasts\n@desc Get the list of all podcasts.\n@optional {page: any # Provide the page number to fetch., pageSize: any # Provide the size of the page to fetch., order: any # Order the items by 'newest' | 'random', filters: any # Takes filters like 'lang' in a url encoded json.  Example: 1)Single -> &nbsp;&nbsp;&nbsp;&nbsp; var filterJson = {\"lang\":[\"en\"]}; &nbsp;&nbsp;&nbsp;&nbsp; var url = baseUrl+'?'+filters=enocdeURI(JSON.stringify(filterJson)); 2)Multiple -> &nbsp;&nbsp;&nbsp;&nbsp; var filterJson = {\"lang\":[\"en\",\"hi\"]}; &nbsp;&nbsp;&nbsp;&nbsp; var url = baseUrl+'?'+filters=enocdeURI(JSON.stringify(filterJson));}\n@returns(200) 200 response\n@errors {404: 404 response, 500: 500 response}\n\n@endpoint GET /podcasts/{podcastId}\n@desc Get a single Podcast.\n@required {podcastId: any # Unique qualifier for a podcast.}\n@returns(200) 200 response\n@errors {404: 404 response, 500: 500 response}\n\n@endpoint GET /podcasts/{podcastId}/episodes\n@desc Get a list of all episodes under a podcast.\n@required {podcastId: any # Unique qualifier for a podcast.}\n@optional {page: any # Provide the page number to fetch., pageSize: any # Provide the size of the page to fetch., order: any # Order the items by 'newest' | 'random', filters: any # Takes filters like 'lang' in a url encoded json.  Example: 1)Single -> &nbsp;&nbsp;&nbsp;&nbsp; var filterJson = {\"lang\":[\"en\"]}; &nbsp;&nbsp;&nbsp;&nbsp; var url = baseUrl+'?'+filters=enocdeURI(JSON.stringify(filterJson)); 2)Multiple -> &nbsp;&nbsp;&nbsp;&nbsp; var filterJson = {\"lang\":[\"en\",\"hi\"]}; &nbsp;&nbsp;&nbsp;&nbsp; var url = baseUrl+'?'+filters=enocdeURI(JSON.stringify(filterJson));}\n@returns(200) 200 response\n@errors {404: 404 response, 500: 500 response}\n\n@endgroup\n\n@group util\n@endpoint GET /util/languages\n@optional {pageSize: any # Provide the size of the page to fetch., page: any # Provide the page number to fetch.}\n@returns(200) 200 response\n@returns(204) 204 response\n@errors {401: 401 response, 404: 404 response, 500: 500 response}\n\n@endgroup\n\n@end\n"}