How to Use SociaVault with n8n: Complete Integration Guide

n8n is a powerful workflow automation tool that lets you connect APIs, databases, and services without writing much code.

Combined with SociaVault's social media data extraction API, you can build automated workflows for:

• Lead generation from social media
• Influencer discovery and tracking
• Competitor monitoring
• Content research and analysis

This guide shows you how to integrate SociaVault with n8n.

Prerequisites

• n8n account (cloud or self-hosted)
• SociaVault API key (free to start)
• Basic understanding of n8n workflows

Method 1: HTTP Request Node

The simplest way to use SociaVault in n8n is with the HTTP Request node.

Step 1: Add HTTP Request Node

1. Create a new workflow in n8n
2. Add an HTTP Request node
3. Configure it as follows:

Settings:

• Method: GET
• URL: https://api.sociavault.com/v1/scrape/tiktok/profile
• Authentication: Header Auth
• Header Name: x-api-key
• Header Value: YOUR_API_KEY

Step 2: Set Query Parameters

Under Query Parameters, add:

{
  "username": "{{ $json.username }}"
}

Or for a static username:

{
  "username": "charlidamelio"
}

Step 3: Test the Node

Click Execute Node to test. You should see TikTok profile data in the output.

Method 2: Using Credentials (Recommended)

For reusable credentials across multiple workflows:

Step 1: Create API Credentials

1. Go to Settings → Credentials
2. Click Add Credential
3. Select Header Auth
4. Configure:
   • Name: SociaVault API
   • Header Name: x-api-key
   • Header Value: YOUR_API_KEY

Step 2: Use in Workflows

Now in any HTTP Request node, select Header Auth and choose your saved credential.

Example Workflows

Workflow 1: TikTok Profile to Google Sheets

Automatically save TikTok profile data to a Google Sheet.

Nodes:

1. Schedule Trigger - Run daily
2. Google Sheets - Read usernames from column A
3. HTTP Request - Call SociaVault API for each username
4. Google Sheets - Write results back

HTTP Request Config:

URL: https://api.sociavault.com/v1/scrape/tiktok/profile
Method: GET
Query Params: { "username": "{{ $json.username }}" }

Workflow 2: Instagram Competitor Monitor

Track competitor Instagram accounts and alert on changes.

Nodes:

1. Schedule Trigger - Run every 6 hours
2. HTTP Request - Get competitor profile data
3. IF Node - Check if followers changed significantly
4. Slack - Send alert if threshold met

Workflow 3: Lead Enrichment

Enrich leads with social media data.

Nodes:

1. Webhook - Receive new lead data
2. HTTP Request - Get TikTok profile
3. HTTP Request - Get Instagram profile
4. Merge - Combine data
5. Airtable/CRM - Update lead record

Available Endpoints

Use these SociaVault endpoints in your n8n workflows:

TikTok

• GET /v1/scrape/tiktok/profile - Get profile data
• GET /v1/scrape/tiktok/videos - Get user videos
• GET /v1/scrape/tiktok/comments - Get video comments
• GET /v1/scrape/tiktok/followers - Get follower list
• GET /v1/scrape/tiktok/search/users - Search users

Instagram

• GET /v1/scrape/instagram/profile - Get profile data
• GET /v1/scrape/instagram/posts - Get user posts
• GET /v1/scrape/instagram/reels - Get user reels
• GET /v1/scrape/instagram/comments - Get post comments

YouTube

• GET /v1/scrape/youtube/channel - Get channel data
• GET /v1/scrape/youtube/channel-videos - Get channel videos
• GET /v1/scrape/youtube/video/comments - Get video comments

View all endpoints in our docs

Handling Pagination

Some endpoints return paginated results. Use the Loop Over Items node or SplitInBatches to process multiple pages:

// First request
{ "username": "creator", "cursor": "" }

// Next page
{ "username": "creator", "cursor": "{{ $json.nextCursor }}" }

Error Handling

Add error handling to your workflows:

1. Error Trigger node catches failures
2. Use IF node to check response status
3. Add Wait node for rate limit handling

Example error check:

{{ $json.error }} is not empty → Handle Error
{{ $json.error }} is empty → Continue

Rate Limits

SociaVault has generous rate limits, but for large workflows:

• Use SplitInBatches node (50 items per batch)
• Add Wait node (1 second between batches)
• Process in parallel where possible

Cost Optimization

Each SociaVault API call costs 1 credit. Optimize your workflows:

1. Cache results - Store in Google Sheets/Airtable, only refresh when needed
2. Conditional calls - Use IF nodes to skip unnecessary API calls
3. Batch processing - Some endpoints support multiple items per request

Complete Example: Influencer Database Builder

Here's a complete workflow that builds an influencer database:

Trigger: Manual or Schedule

Steps:

1. Read seed usernames from Google Sheets
2. For each username, call SociaVault TikTok profile API
3. Filter profiles with 10K+ followers
4. Get recent videos for qualified profiles
5. Calculate engagement rate
6. Save to Airtable with all metrics

Estimated cost: ~2 credits per influencer (profile + videos)

Debugging Tips

1. Use Console Log - Add Code nodes to log data
2. Test incrementally - Test each node before connecting
3. Check API response - Verify the response structure matches your expectations
4. Monitor credits - Check your SociaVault dashboard for usage

Next Steps

• Get your SociaVault API key
• Read the API documentation
• See more n8n workflow examples

---

Need help? Join our Discord community or email support@sociavault.com.