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.

  1. Step 1: Create your Virlo account for free

    Create your free Virlo account in under a minute. Already signed up? Open API Keys.
  2. 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.

  3. 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.

  4. 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: virlo
    export 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,
        }))
      },
    })
  5. 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 endpoint
    curl -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" }
      }'
  6. 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 prompt
    Here 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 pieceIts job with VirloTypical use
Schedule trigger + Node.js stepCalls an api.virlo.ai/v1 endpoint on your cron and returns the rowsWeekly trend briefs, daily sound logs, monthly client numbers
HTTP / Webhook triggerGives the workflow a *.m.pipedream.net address that Virlo posts events toReacting to a tracked outlier or a finished marketing agent run
Anthropic or OpenAI actionTurns the Virlo rows from earlier steps into scripts, captions or a summaryWriting the brief before it goes to Slack or email
Pipedream MCP in an assistantLets Claude or ChatGPT act in your connected apps while Virlo's MCP server supplies the researchAd 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

What can a Pipedream workflow pull from Virlo today?
Question your app asksTool it callsTop answer
Which format are most creators copying?get_content_trendsMy 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_hooksPOV setup: 32.9% reach a Virality Score of 18+
Which hook type wins most often on Instagram?search_hooksComparison: 19.0% reach a Virality Score of 18+
What is the second trend to copy?get_content_trendsWhile 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 free

How 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.headers and 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 event so 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.
Register a Pipedream endpoint with Virlo
Field in the requestWhat to put there
urlThe HTTPS endpoint from your HTTP / Webhook trigger
enabled_eventsFor example tracking.outlier_video.detected or content_research_agent.run.completed
headersUp to 5 custom headers, such as X-Webhook-Secret, sent with every delivery
Where to send itPOST 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.