n8n node for ViralApp API - Video analytics for TikTok, Instagram, and YouTube
npm install n8n-nodes-viral-appThis is an n8n community node that lets you use ViralApp in your n8n workflows.
ViralApp is a comprehensive video analytics platform that provides insights and tracking for content across TikTok, Instagram, and YouTube. It helps creators and businesses monitor their social media performance, track competitors, and discover trending content.
n8n is a fair-code licensed workflow automation platform.
Follow the installation guide in the n8n community nodes documentation.
bash
npm install n8n-nodes-viral-app
`$3
1. Go to Settings > Community Nodes
2. Click Install
3. Enter n8n-nodes-viral-app
4. Click InstallOperations
The ViralApp node supports the following resources and operations:
$3
- Account and project pickers are searchable and accept direct IDs.
- Video picker is client-filtered over the first 100 items (platform + optional account filter); type to narrow results.$3
- Get Top Videos - Retrieve top performing videos for tracked accounts
- Get Top Accounts - Get top performing accounts from your tracked list
- Get KPIs - Fetch key performance indicators for accounts
- Get Interaction Metrics - Retrieve interaction metrics for accounts
- Export Daily Gains - Export daily gains data for accounts$3
- Get Top Videos - Retrieve top performing videos
- Get Top Accounts - Get accounts with top performing videos
- Get KPIs - Fetch video performance KPIs
- Get Interaction Metrics - Retrieve video interaction metrics
- Export Daily Gains - Export daily video gains data$3
- Create - Add a new tracked account
- Delete - Remove a tracked account
- Get - Retrieve details of a specific tracked account
- Get Many - List multiple tracked accounts with filtering
- Update - Modify tracked account settings
- Export Daily Gains - Export daily gains for tracked accounts$3
- Create - Add a new tracked video
- Delete - Remove a tracked video
- Get - Retrieve details of a specific tracked video
- Get Many - List multiple tracked videos
- Update - Modify tracked video settings$3
- Create - Create a new project
- Delete - Remove a project
- Get - Retrieve project details
- Get Many - List multiple projects
- Update - Modify project settings$3
- Create - Set up a new integration
- Delete - Remove an integration
- Get - Retrieve integration details
- Get Many - List integrations
- Update - Modify integration settings$3
- Get Categories - Retrieve available content categories
- Get Countries - Get list of supported countries
- Get Performance KPIs - Fetch performance KPIs
- Get Top Videos - Retrieve overall top performing videosCredentials
To use this node, you need to authenticate with the ViralApp API.
$3
1. Sign up for a ViralApp account at viral.app
2. Navigate to your account settings
3. Generate an API key$3
1. In n8n, go to Credentials > New
2. Select ViralApp API from the list
3. Enter your API key
4. Click SaveCompatibility
- Minimum n8n version: 1.0.0
- Tested with: n8n 1.0.0 and above
- Node.js: 18.10.0 or higher
Resources
* n8n community nodes documentation
* ViralApp API documentation
* ViralApp website
* Support
Development
To contribute to this node or run it locally for development:
`bash
Install dependencies
pnpm installBuild the node
pnpm buildRun in development mode
pnpm devRun linter
pnpm lintRun linter and auto-fix
pnpm lintfix
`License
Version History
$3
- Make all analytics account/project filters searchable via dropdown or direct ID.
- Centralize list searches with pagination and perPage=100; video picker still client-filters due to API limitations.
- Restore baseURL defaults for safer relative requests.$3
- Align all ViralApp node sort options with the ViralApp dashboard by adding the latest sortable columns for tracked videos, accounts, integrations, and analytics exports
- Verified the release with pnpm build and pnpm lint$3
- Add an Expand Related option to Video Analytics → Get Many, enabling Stripe-style expand=projects responses for richer project data
- Ensure Video Analytics requests pass expand arrays using standard query encoding$3
- Remove package installation hooks to meet n8n Cloud security guidelines
- Move internal tooling dependency to devDependencies to keep runtime footprint empty
- Link node outputs to their originating inputs using pairedItem` for improved workflow debugging