Use Pipedream MCP and workflows with TikTok and Instagram data
Updated
Virlo is social listening for TikTok and Instagram Reels. Pipedream can run code on a timer and reach thousands of APIs, but none of them tells it which short videos are breaking out right now. Point a Pipedream workflow at the Virlo API and each run returns trends, hooks, sounds and outlier videos from a database of 23.1M viral videos, ready for the next step. Pipedream is a developer automation platform for building event-driven workflows from triggers, prebuilt actions and Node.js or Python code steps.
- One Node.js step and an environment variable: no SDK to install
- An HTTP / Webhook trigger that Virlo calls the moment a tracked creator breaks out
- Pipedream MCP and Virlo MCP side by side in Claude or ChatGPT
Part of Virlo's AI assistant guides. Prefer a no-code builder? See Zapier or Make.
How do I connect Virlo to a Pipedream workflow?
Six steps in the Pipedream workflow builder, one optional. The finished workflow fetches this week's TikTok trends every Monday and hands them to an AI step that writes the brief.
Step 1: Create your Virlo account for free
Step 2: Save your Virlo key as a Pipedream environment variable
Generate a key on the API Keys page of the Virlo developer dashboard. In Pipedream, open Settings, then Environment Variables, and add it as VIRLO_API_KEY so code steps read it from process.env instead of holding it in plain text.
Step 3: Add a Schedule trigger
Create a workflow, click Add Trigger and choose Schedule. Use a cron expression with your timezone, such as 0 8 * * 1 for Mondays at 08:00, so the research lands before your planning meeting.
Step 4: Call Virlo from a Node.js step
Add a Node.js code step, name it virlo and paste the code below. It returns one clean object per trend, which later steps reach as steps.virlo.$return_value.
Node.js step: virloexport default defineComponent({ async run({ steps, $ }) { const res = await fetch( 'https://api.virlo.ai/v1/content-trends?platform=tiktok&sort=creators_7d&limit=5', { headers: { Authorization: 'Bearer ' + process.env.VIRLO_API_KEY } } ) const body = await res.json() return body.data.map((t) => ({ trend: t.name, stage: t.lifecycle, creators_7d: t.creators_7d, keep: t.constant_part, change: t.swapped_part, example: t.examples?.[0]?.url, })) }, })Step 5: Optional: let Virlo call a second workflow
Start another workflow with the HTTP / Webhook trigger and copy its endpoint. Register it with Virlo using the request below so tracked outliers arrive the moment they are found, with your secret header attached.
Register the endpointcurl -X POST https://api.virlo.ai/v1/webhooks \ -H "Authorization: Bearer virlo_tkn_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://YOUR_ENDPOINT.m.pipedream.net", "enabled_events": ["tracking.outlier_video.detected"], "headers": { "X-Webhook-Secret": "pick-a-long-random-string" } }'Step 6: Hand the rows to an AI step and ask
Add an Anthropic or OpenAI action after the code step, pass in the virlo step output, and give it the prompt below. Finish with a Slack or Gmail action, test the workflow and deploy it.
Your first promptHere are this week's top TikTok trends to copy: {{steps.virlo.$return_value}}. Pick the 2 that best fit [your brand] and write a 30-second script for each that keeps the part to keep.
Change the URL in the Node.js step to pull other data: /v1/sounds/breakout?platform=instagram for rising Reels sounds, or /v1/hooks/trending for opening lines that are winning now.
Schedule trigger vs HTTP / Webhook trigger vs Pipedream MCP: which do I need?
| Pipedream piece | Its job with Virlo | Typical use |
|---|---|---|
| Schedule trigger + Node.js step | Calls an api.virlo.ai/v1 endpoint on your cron and returns the rows | Weekly trend briefs, daily sound logs, monthly client numbers |
| HTTP / Webhook trigger | Gives the workflow a *.m.pipedream.net address that Virlo posts events to | Reacting to a tracked outlier or a finished marketing agent run |
| Anthropic or OpenAI action | Turns the Virlo rows from earlier steps into scripts, captions or a summary | Writing the brief before it goes to Slack or email |
| Pipedream MCP in an assistant | Lets Claude or ChatGPT act in your connected apps while Virlo's MCP server supplies the research | Ad hoc research plus action in a single chat, no workflow at all |
Workflows use your Virlo API key from an environment variable. The assistant route signs in to Virlo with OAuth instead.
What can a Pipedream workflow pull from Virlo today?
Each row is a question a workflow or connected assistant can answer right now, the Virlo MCP tool behind it, and the top answer from live data. The API endpoints in the setup return the same lists.
In Virlo's data, 659 creators posted the "My moon my man couple montage" trend in the last 7 days, the top answer the trends tool gives as of November 19, 2026.
As of November 19, 2026 at 13:07 UTC
| Question your app asks | Tool it calls | Top answer |
|---|---|---|
| Which format are most creators copying? | get_content_trends | My moon my man couple montage: 659 creators this week |
| Which sound is trending on Instagram Reels? | get_trending_sounds | "Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score]": 75 Reels in 7 days |
| Which hook type wins most often on TikTok? | search_hooks | POV setup: 32.9% reach a Virality Score of 18+ |
| Which hook type wins most often on Instagram? | search_hooks | Comparison: 19.0% reach a Virality Score of 18+ |
| What is the second trend to copy? | get_content_trends | While they're out partying btw: 346 creators this week |
Every answer, not just the top one
Connect the server and the same tools return the full lists, filters and history.
Start for freeHow this sample is made
- Source
- Virlo's Trends to copy, Instagram sound rankings and daily hook snapshot: the same data the MCP tools read.
- Window
- Trends: creators in the last 7 days. Sounds: Reels in the last 7 days. Hooks: all hook-tagged videos in the latest snapshot. TikTok and Instagram only.
- Method
- Each row is the top item for that question, from the data the named tool reads.
- As of
- Trends November 19, 2026 at 13:07 UTC; sounds November 19, 2026 at 12:03 UTC; hooks November 19, 2026.
- Made by
- Numbers are pulled automatically from Virlo's data every hour; the text around them is written by the Virlo team.
Suggested citation: Source: Virlo, “Use Pipedream MCP and workflows with TikTok and Instagram data”, virlo.ai/pipedream
How do I catch Virlo webhooks in Pipedream safely?
Start a second workflow with the HTTP / Webhook trigger and copy its endpoint. Pipedream offers a Custom token option on the trigger, but it expects the caller to send an Authorization header, and Virlo reserves that header name. Leave the trigger open and check a shared secret header in your first code step instead.
Register the endpoint with the request in setup step 5. Virlo will include your X-Webhook-Secret header on every delivery, and your code step can end the run early when the value is missing or wrong.
- Read the secret from
steps.trigger.event.headersand compare it with a second environment variable. - Skip repeats with the event id in the request body (also sent as the Virlo-Event-Id header), since a retried delivery keeps the same id.
- Branch on
eventso outlier alerts go to Slack and agent results go to a Google Doc. - Pipedream answers the HTTP request straight away by default, well inside the 30 seconds Virlo waits for a 2xx.
| Field in the request | What to put there |
|---|---|
url | The HTTPS endpoint from your HTTP / Webhook trigger |
enabled_events | For example tracking.outlier_video.detected or content_research_agent.run.completed |
headers | Up to 5 custom headers, such as X-Webhook-Secret, sent with every delivery |
| Where to send it | POST https://api.virlo.ai/v1/webhooks with your Virlo key in the Authorization header (setup step 5 has the full request) |
What can I build in Pipedream with Virlo?
Workflow ideas and AI-step prompts. Swap the brackets for your own niche, apps and channels.
Monday script pack
Schedule trigger, Node.js step on /v1/content-trends, then: "Write 3 TikTok scripts for [your brand] from these trends: {{steps.virlo.$return_value}}."
Outlier to Slack
HTTP / Webhook trigger on tracking.outlier_video.detected, then post the video link, views and a one-line reason it worked to #[channel].
Reels sound log
Daily, GET /v1/sounds/breakout?platform=instagram&limit=10 and append each sound title and 7-day count to [Google Sheet].
Hook digest
Weekly, GET /v1/hooks/trending, then ask the AI step: "Rewrite the 10 strongest hooks for [your offer] and keep each source link."
Agent results to Notion
Catch content_research_agent.run.completed and create a Notion page for [client] with the run summary and top videos.
Assistant pairing
In Claude with Virlo and Pipedream MCP: "Find this week's top 5 TikTok trends in [your niche] with Virlo, then send them to [Slack channel] through Pipedream."
Competitor watch
Track @[competitor] in Virlo, catch tracking.cycle.completed in Pipedream and email [address] when their latest video beats their usual views.
Pipedream workflows vs Pipedream MCP vs Pipedream Connect: what is the difference?
Pipedream sells three things that all mention APIs. Virlo plugs into each in a different place.
Pipedream workflows (this page)
Triggers plus steps that you deploy. Virlo is called from a Node.js step or posts events to an HTTP / Webhook trigger.
Pipedream MCP
A hosted MCP server that gives assistants such as Claude or ChatGPT tools for Pipedream's connected apps. It acts in apps; Virlo's server supplies social video research.
Pipedream Connect
A developer product for embedding app integrations and managed OAuth inside your own software. It powers Pipedream MCP and is unrelated to how Virlo authenticates.
Zapier
A no-code alternative. The Zapier guide shows the same Virlo data moving through Webhooks by Zapier and Catch Hooks.
What are the limits?
- Virlo only reads public TikTok and Instagram data; a Pipedream workflow can carry its findings anywhere, but nothing is posted to social accounts through Virlo.
- Environment variables are only exposed to workflows, so keep VIRLO_API_KEY there and avoid console.log on it, because logged values show up in step logs.
- Marketing agents and creator lookups finish in the background; start them in one workflow and pick up the result with the matching webhook in another.
- A Virlo team can keep 5 webhooks switched on, so route several event types to one Pipedream endpoint and branch in code.
- Virlo plan details live on pricing.
Frequently asked questions
How do I call an API from a Pipedream workflow?
Add a Node.js code step and use fetch inside its run function. For Virlo, request an endpoint such as https://api.virlo.ai/v1/content-trends with an Authorization header of Bearer plus process.env.VIRLO_API_KEY, then return the rows so later steps can read them as steps.<step name>.$return_value.
What is Pipedream MCP?
A hosted MCP server from Pipedream that lets assistants like Claude and ChatGPT call tools for thousands of connected apps, with OAuth handled by Pipedream Connect. It takes actions. Pair it with Virlo's MCP server and one chat can research TikTok trends and then send them through your apps.
Can Pipedream get TikTok trend data?
Yes, with Virlo. A workflow step can pull TikTok trends to copy, breakout sounds, trending hooks, hashtags and top videos from api.virlo.ai/v1 using a bearer key. Instagram Reels data comes from the same endpoints when you set platform=instagram. Each response is JSON inside a data field, so a code step can reshape it for Slack or a sheet.
Can Virlo trigger a Pipedream workflow?
Yes. Start a workflow with the HTTP / Webhook trigger, copy its endpoint and register it through POST /v1/webhooks on the Virlo API. Choose events like tracking.outlier_video.detected, and add a custom header as a shared secret that your first code step checks.
Where do I store an API key in Pipedream?
Under Settings, Environment Variables. Name it VIRLO_API_KEY and read it with process.env.VIRLO_API_KEY inside a code step. Names are case-sensitive, values can be up to 64KB, and the PIPEDREAM_ prefix is reserved, so pick a plain name. Avoid logging it, because logged values appear in the step logs.
How do I schedule a Pipedream workflow to run weekly?
Use the Schedule trigger. Pick Every for a simple interval or Cron Expression for exact times with a timezone, such as 0 8 * * 1 for Monday mornings. Put the Virlo code step right after it and the weekly research runs without anyone opening the builder.
Can Pipedream research Instagram Reels?
Yes. Point the Node.js step at Virlo endpoints with platform=instagram to fetch trending and breakout Reels sounds, Instagram hashtags and trends to copy that include Reels examples. An AI step can then turn those rows into Reel ideas for your brand.
Should I use Pipedream or Zapier with Virlo?
Pipedream if you are comfortable with a few lines of Node.js and want full control over the response. Zapier if your team wants no code at all and a familiar Zap editor. Both use the same Virlo key; the Zapier guide covers that route.
Can a Pipedream workflow post to TikTok with Virlo?
Not through Virlo, which is read-only and never connects to your social accounts. A workflow can pass Virlo research to a publishing tool you already use, but the post itself always goes out from that other tool. Most teams use Virlo to decide what to make and leave publishing to their usual scheduler.
Give your Pipedream workflows a social media brain
One Node.js step brings this week's TikTok and Instagram winners into every run.
More AI assistant guides
- AI assistant guides
- Claude
- Claude Code
- Cursor
- MCP server
- TikTok MCP server
- Instagram MCP server
- ChatGPT
- ChatGPT dots
- OpenAI Codex
- Gemini CLI
- Grok Build
- Claude Cowork
- n8n
- Zapier
- Grok Bot
- Muse
- Claude Duet
- Hermes Agent
- Kimi K3
- Cue
- Manus
- Perplexity Computer
- Paperclip
- OpenClaw
- NanoClaw
- DeepSeek
- AI agents CLI
- ChatGPT agent
- Perplexity
- Microsoft Copilot
- Le Chat
- Notion
- Slack
- Discord
- Telegram
- Google Sheets
- Windsurf
- VS Code
- GitHub Copilot
- Cline
- JetBrains
- Kiro
- Google Antigravity
- goose
- Warp
- OpenCode
- Zed
- Amp
- Factory Droid
- Raycast
- Lovable
- Replit
- Bolt.new
- v0
- Ollama
- LM Studio
- Open WebUI
- LibreChat
- Make
- Gumloop
- Lindy
- Relevance AI
- Airtable
- ClickUp
- Dify
- Flowise
- LangChain
- CrewAI
- OpenAI Agents SDK
- Mastra
- Vercel AI SDK
- Claude Agent SDK