{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"68359411-b3fe-4bcf-915a-026646a07d76","name":"Powerbeans Publisher API","description":"# **1\\. Introduction**\n\n<img src=\"https://lh7-us.googleusercontent.com/FkFTYC06AAQUn2_cUYnjYwDckDLYYAxw2XmkrRUW6b7TPS0krypXivE0BpFLZUAnMf2UMd54nc5qCJQ7TiKNt-FBT-9faCI9T5MPyKVfpL8_bK3eMmETzfS5tsFFhH0LtbSNylDxgRHeh7_G-M2CSOE\">\n\nThe Powerbeans player is the flagship product of Powerbeans. It consists of an AI solution for any editorial online publisher to transform their already existing content into Audio in a simple way, while providing the user with the option to consume the full content or a summary.\n\nThe player was conceived with an API-first approach to allow the developers around the world to make the most out of it.\n\nThe main concepts to learn before getting started are:\n\n- **Publisher**: The entity behind a website where the player will be implemented. (Example: CNN)\n    \n- **Site**: The entity that represents the website itself, a domain or subdomain. (Example: [https://cnnespanol.cnn.com](https://cnnespanol.cnn.com) )\n    \n- **Content**: Any article that the player is implemented on. The content should be unique based on its URL. (Example: [https://cnnespanol.cnn.com/2024/01/11/estados-unidos-ataques-aereos-hutes-iran-yemen-trax/](https://cnnespanol.cnn.com/2024/01/11/estados-unidos-ataques-aereos-hutes-iran-yemen-trax/))\n    \n\nPowerbeans Publisher API gives the publisher different endpoints to manage their content, including creating new audios, retreive generated summaries and full-article audios, regenerate content texts and summaries.\n\nBase URL of the API:\n\n```\nhttps://api.powerbeans-ai.com/private\n\n ```\n\n# **2\\. Authorization**\n\nThe Powerbeans team will generate and provide you with a PRIVATE API KEY for each site where the player is set up.\n\nThe API KEY is tied to the publisher and a site. This means that the scope of the requests is limited to that site.\n\n> It's important not to confuse this key with the PUBLIC API KEY provided to be used in the player. \n  \n\nThere are two ways of adding the API KEY to the API calls:\n\n1. Query parameter: [<b>https://api.powerbeans-ai.com/private/...?apiKey={{API_KEY}}</b>](https://api.powerbeans-ai.com/private/...?apiKey=%7B%7BAPI_KEY%7D%7D)\n    \n2. Header: add a header **x-api-key** with the API KEY as the value.\n    \n\n# **3\\. Rate limit**\n\nRate limits are restrictions that our API imposes on the number of times you can access our services within a specified period of time.\n\nRate limits are imposed at the API KEY level, not publisher level.\n\nThe current rate limit is 500 req/sec.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"33953332","collectionId":"68359411-b3fe-4bcf-915a-026646a07d76","publishedId":"2sA35HXMFC","public":true,"publicUrl":"https://documenter-api.postman.tech/view/33953332/2sA35HXMFC","privateUrl":"https://go.postman.co/documentation/33953332-68359411-b3fe-4bcf-915a-026646a07d76","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"19E852"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/ffa16e59-acf5-4a31-85b8-37e94d5d4f7c/UEJfTG9nb19HcmVlbi5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"19E852"}},{"name":"light","logo":"https://content.pstmn.io/ffa16e59-acf5-4a31-85b8-37e94d5d4f7c/UEJfTG9nb19HcmVlbi5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"19E852"}}]}},"version":"8.10.1","publishDate":"2024-04-11T12:00:49.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/ffa16e59-acf5-4a31-85b8-37e94d5d4f7c/UEJfTG9nb19HcmVlbi5wbmc=","logoDark":"https://content.pstmn.io/ffa16e59-acf5-4a31-85b8-37e94d5d4f7c/UEJfTG9nb19HcmVlbi5wbmc="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/4243ca62d872e2fc1ce728f16875dccfd60f4d13b1bc7ee9e1660b695d2a2d4d","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sA35HXMFC"}