Welcome to the InsightTube!
InsightTube allows you to create a custom video player with advanced features for your private/unlisted YouTube videos. This API enables you to configure various settings for your video player, providing a personalized and engaging viewing experience without the “YouTube Appearance”.
To use the InsightTube API, include your API key in the headers of your requests and use Rapid API Auth(auto add the headers):
X-RapidAPI-Key: Your-API-Key
Replace Your-API-Key
with the key provided by Rapid API.
The base URL for all InsightTube API endpoints is:
https://insight-tube.p.rapidapi.com
Create a new custom video player with the provided parameters.
The POST
request to create a new custom video player requires the following parameters in the request body:
{
"url": "string",
"autoPlay": "boolean",
"privacy": "boolean",
"pixelName": "string",
"width": "number",
"borderRadius": "number",
"borderWidth": "number",
"borderColor": "string",
"shadowWidth": "number",
"shadowColor": "string",
"liveMode": "boolean",
"progressBarColor": "string",
"progressBar": "boolean",
"progressBarHeight": "number",
"progressBarControl": "boolean",
"fakeProgressBar": "boolean",
"fakeProgressBarTime": "number",
"actionColor": "string",
"openScreenURL": "string",
"pauseScreenURL": "string",
"endScreenURL": "string",
"endScreenText": "string",
"showElementByTime": "string",
"showTime": "number",
"fullscreen": "boolean",
"timer": "boolean",
"mute": "boolean",
"buttonType": "number",
"introText1": "string",
"introText2": "string"
}
url (string, required):
autoPlay (boolean, optional):
privacy (boolean, optional):
liveMode (boolean, optional):
mute (boolean, optional):
timer (boolean, optional):
progressBar (boolean, optional):
openScreenURL/endScreenURL/pauseScreenURL (string, optional):
showTime (number, optional):
showElementByTime (string, optional):
buttonType (number, optional):
0
: A play icon button1
: An image with introText1 and introText22
: No buttonPixelName (string, optional):
Description: If Facebook, Google Ads + Analytics, Taboola, Outbrains, TikTok, and Kwai pixels are installed on your pages, we will send markers for users who watched the video at 25%, 50%, 75%, 95%, and Call to Action (CTA). Use these event names for more effective remarketing campaigns:
Facebook Ads:
fbq('trackCustom', 'insight-tube', {percentage: '25'});
// or your CTA: fbq('trackCustom', 'insight-tube', {cta: '1'});
Google Ads + Analytics:
gtag('event','insight-tube', { "percentage":"25" });
// or your CTA: gtag('event','insight-tube', { "cta":"1" });
Taboola:
_tfa.push({notify: 'event', name: 'insight-tube', id: 25});
// or your CTA: _tfa.push({notify: 'event', name: 'insight-tube-cta', id: 1});
Outbrains:
obApi('track', 'insight-tube-25');
// or your CTA: obApi('track', 'insight-tube-cta');
TikTok:
ttq.track('ViewContent', {content_name: 'insight-tube', value: 25});
// or your CTA: ttq.track('ViewContent', {content_name: 'insight-tube-cta', value: 1});
Kwai:
kwaiq.track("contentView", { content_name: "insight-tube", value: 25 });
// or your CTA: kwaiq.track("contentView", { content_name: "insight-tube-cta", value: 1 });
Success:
{
"success": true,
"data": {
"url": "string",
"iframe": "string"
}
}
Error:
{
"success": false,
"error": "string"
}
curl --request POST \
--url https://insight-tube.vercel.app/api/youtube \
--header 'Content-Type: application/json' \
--header 'X-RapidAPI-Key: YOUR_RAPID_API_KEY \
--data '{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"autoPlay": true,
"privacy": false,
"pixelName": "YOUR_PIXEL_NAME",
"borderRadius": 20,
"borderWidth": 5,
"borderColor": "#3d3d3d",
"shadowWidth": 15,
"shadowColor": "red",
"liveMode": false,
"progressBarColor": "red",
"progressBar": true,
"progressBarHeight": 20,
"progressBarControl": true,
"fakeProgressBar": false,
"fakeProgressBarTime": 5000,
"actionColor": "#ff0000",
"endScreenText": "Thanks for watching!",
"showElementByTime": "elementID",
"showTime": 10,
"fullscreen": true,
"timer": true,
"mute": true,
"buttonType": 1,
"introText1": "Welcome to InsightTube!",
"introText2": "Enhance your video experience."
}'
The API uses standard HTTP status codes to indicate the success or failure of a request. Check the success
field or http status in the response to determine the status of the request.
If you have any questions or issues, please contact our support team at [pantano-nirico0f@icloud.com].
The current version of the InsightTube API is 1.0. Check the documentation for any updates or changes.