Skip to content

Add universal endpoints #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rafalzawadzki merged 4 commits into from
Nov 23, 2025
Merged

Add universal endpoints #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
e004aba
Update API endpoints to support multi-platform functionality
claude Nov 23, 2025
11333d0
Fix API endpoint parameters to match OpenAPI specification
claude Nov 23, 2025
e343235
Add Media resource and language support for multi-platform operations
claude Nov 23, 2025
e4fa33d
Add documentation URL to node configuration
claude Nov 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
224 changes: 198 additions & 26 deletions nodes/Supadata/Supadata.node.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@ export class Supadata implements INodeType {
icon: 'file:supadata.svg',
group: ['input'],
version: 1,
description: 'Access Supadata API to fetch YouTube and web data',
description: 'Access Supadata API to fetch video metadata, transcripts, and web data from multiple platforms',
subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
documentationUrl: 'https://docs.supadata.ai',
defaults: {
name: 'Supadata',
},
Expand All @@ -39,10 +40,115 @@ export class Supadata implements INodeType {
type: 'options',
noDataExpression: true,
options: [
{ name: 'Media', value: 'media' },
{ name: 'YouTube', value: 'youtube' },
{ name: 'Web', value: 'webScrape' },
],
default: 'youtube',
default: 'media',
},

// --------------------------------------------------------------------------------------------------------
// Media Operations (Universal - works across platforms)
// --------------------------------------------------------------------------------------------------------
{
displayName: 'Operation',
name: 'operation',
type: 'options',
noDataExpression: true,
displayOptions: {
show: {
resource: ['media'],
},
},
options: [
{
name: 'Get Metadata',
value: 'getMetadata',
description: 'Get metadata of a video from multiple platforms (YouTube, TikTok, Instagram, Twitter)',
action: 'Get metadata',
},
{
name: 'Get Transcript',
value: 'getTranscript',
description: 'Get the transcript of a video from multiple platforms (YouTube, TikTok, etc.)',
action: 'Get transcript',
},
],
default: 'getMetadata',
},

// Media Fields
{
displayName: 'Video URL',
name: 'videoUrl',
type: 'string',
default: '',
required: true,
displayOptions: {
show: {
resource: ['media'],
operation: ['getMetadata', 'getTranscript'],
},
},
placeholder: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
description: 'The URL of the video (supports YouTube, TikTok, Instagram, Twitter, and other platforms)',
},
{
displayName: 'Return as Plain Text',
name: 'text',
type: 'boolean',
default: false,
displayOptions: {
show: {
resource: ['media'],
operation: ['getTranscript'],
},
},
description: 'Whether to return the transcript as plain text',
},
{
displayName: 'Language',
name: 'lang',
type: 'string',
default: '',
displayOptions: {
show: {
resource: ['media'],
operation: ['getTranscript'],
},
},
placeholder: 'en',
description: 'Preferred language code (ISO 639-1). If not provided or unavailable, defaults to first available language.',
},
{
displayName: 'Mode',
name: 'mode',
type: 'options',
options: [
{
name: 'Auto',
value: 'auto',
description: 'Try native transcript, fallback to AI generation if unavailable',
},
{
name: 'Native',
value: 'native',
description: 'Only fetch existing transcript from the platform',
},
{
name: 'Generate',
value: 'generate',
description: 'Always generate transcript using AI',
},
],
default: 'auto',
displayOptions: {
show: {
resource: ['media'],
operation: ['getTranscript'],
},
},
description: 'The mode to use for transcript extraction',
},

// --------------------------------------------------------------------------------------------------------
Expand Down Expand Up @@ -83,23 +189,11 @@ export class Supadata implements INodeType {
description: 'Get videos of a YouTube playlist',
action: 'Get playlist videos',
},
{
name: 'Get Transcript',
value: 'getTranscript',
description: 'Get the transcript of a YouTube video',
action: 'Get video transcript',
},
{
name: 'Get Video',
value: 'getVideo',
description: 'Get details of a YouTube video',
action: 'Get video details',
},
],
default: 'getVideo',
default: 'getChannel',
},

// YouTube Video Fields
// YouTube Video Fields (kept for backward compatibility)
{
displayName: 'Video',
name: 'videoId',
Expand All @@ -113,7 +207,7 @@ export class Supadata implements INodeType {
},
},
placeholder: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
description: 'The ID or URL of the YouTube video',
description: 'The ID or URL of the video (supports YouTube, TikTok, and other platforms)',
},
{
displayName: 'Return as Plain Text',
Expand All @@ -128,6 +222,50 @@ export class Supadata implements INodeType {
},
description: 'Whether to return the transcript as plain text',
},
{
displayName: 'Language',
name: 'lang',
type: 'string',
default: '',
displayOptions: {
show: {
resource: ['youtube'],
operation: ['getTranscript'],
},
},
placeholder: 'en',
description: 'Preferred language code (ISO 639-1). If not provided or unavailable, defaults to first available language.',
},
{
displayName: 'Mode',
name: 'mode',
type: 'options',
options: [
{
name: 'Auto',
value: 'auto',
description: 'Try native transcript, fallback to AI generation if unavailable',
},
{
name: 'Native',
value: 'native',
description: 'Only fetch existing transcript from the platform',
},
{
name: 'Generate',
value: 'generate',
description: 'Always generate transcript using AI',
},
],
default: 'auto',
displayOptions: {
show: {
resource: ['youtube'],
operation: ['getTranscript'],
},
},
description: 'The mode to use for transcript extraction',
},

// YouTube Channel Fields
{
Expand Down Expand Up @@ -247,33 +385,67 @@ export class Supadata implements INodeType {
const operation = this.getNodeParameter('operation', i) as string;
let responseData;

if (resource === 'youtube') {
if (resource === 'media') {
if (operation === 'getMetadata') {
const videoUrl = this.getNodeParameter('videoUrl', i) as string;
responseData = await supadataApiRequest.call(
this,
'GET' as IHttpRequestMethods,
'/metadata',
{},
{ url: videoUrl },
);
} else if (operation === 'getTranscript') {
const videoUrl = this.getNodeParameter('videoUrl', i) as string;
const qs: IDataObject = {
url: videoUrl,
text: this.getNodeParameter('text', i) as boolean,
mode: this.getNodeParameter('mode', i) as string,
};

// Add lang parameter if provided
const lang = this.getNodeParameter('lang', i) as string;
if (lang) {
qs.lang = lang;
}

responseData = await supadataApiRequest.call(
this,
'GET' as IHttpRequestMethods,
'/transcript',
{},
qs,
);
}
} else if (resource === 'youtube') {
// Backward compatibility for old YouTube operations
if (operation === 'getVideo') {
const videoIdentifier = this.getNodeParameter('videoId', i) as string;
responseData = await supadataApiRequest.call(
this,
'GET' as IHttpRequestMethods,
'/youtube/video',
'/metadata',
{},
{ id: videoIdentifier },
{ url: videoIdentifier },
);
} else if (operation === 'getTranscript') {
const videoInput = this.getNodeParameter('videoId', i) as string;
const qs: IDataObject = {
url: videoInput,
text: this.getNodeParameter('text', i) as boolean,
mode: this.getNodeParameter('mode', i) as string,
};

// Check if input is a URL or ID
if (videoInput.includes('youtube.com/') || videoInput.includes('youtu.be/')) {
qs.url = videoInput;
} else {
qs.videoId = videoInput;
// Add lang parameter if provided
const lang = this.getNodeParameter('lang', i) as string;
if (lang) {
qs.lang = lang;
}

responseData = await supadataApiRequest.call(
this,
'GET' as IHttpRequestMethods,
'/youtube/transcript',
'/transcript',
{},
qs,
);
Expand Down
2 changes: 1 addition & 1 deletion package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "n8n-nodes-supadata",
"version": "0.2.7",
"version": "0.3.0",
"description": "Tool for extracting content from YouTube videos and web pages",
"keywords": [
"n8n-community-node-package",
Expand Down
Loading