Social media API for TikTok and Instagram video data, set up in 10 minutes

Updated

Virlo's social media API gives developers TikTok and Instagram video data as structured JSON: copied formats and trending sounds, outlier videos that beat their creator's own baseline, per-video breakdowns and creator lookups, all from one key sent as a Bearer token. The same key powers an MCP server, so Claude can query the data directly. An agency owner, Matthew Berman, built his weekly outlier research on it and passed 11 million views for a single client.

  • What the API returns for TikTok and Instagram, endpoint by endpoint
  • Your key, your first curl call and the MCP config for Claude
  • 3 builds to start with, and the setup errors that trip people up
TikTokInstagram

What data does this social media API return?

The API returns the same trend, creator and outlier data that powers the Virlo web app, as JSON you can pipe into a product, a Slack bot, a content pipeline, a research dashboard or an LLM workflow. There's no scraping setup to run yourself.

What the social media API gives you
DataWhat it is
Trending formats and soundsFormats TikTok and Instagram creators are copying now, and the audio used in the most new videos
Outlier detectionVideos performing well above their creator's own baseline
Per-video breakdownsHook, structure and engagement signals for a video you pass by URL
Creator and niche trackingProfiles, recent videos and topics you choose, on demand
Cross-platform signalsSpot a hook winning on TikTok before it reaches Reels
A few endpoints (base URL https://api.virlo.ai)
MethodPathReturns
GET/v1/content-trends?platform=tiktokCopied formats with a recipe, stage and example videos
GET/v1/sounds/trending?platform=instagramAudio picked up by the most new Reels over 7 or 30 days
POST/v1/search/videosAnalysed videos filtered by topic, look, region, account size or Virality Score
GET/v1/raw/tiktok/video?url=...One TikTok: caption, author, views, likes, comments, shares, saves, sound
GET/v1/raw/instagram/creator/{handle}A public Instagram profile: bio, follower and post counts

The full endpoint lists, with live sample responses, are on the TikTok API and Instagram API pages.

How do you get a social media API key?

You get a key by signing up on Virlo's developer dashboard and generating one. Every request authenticates with that key.

  1. Sign up at dev.virlo.ai.
  2. Generate a key. It starts with virlo_tkn_.
  3. Add funds to your API balance. It's pay as you go, with no subscription.

Store the key in an environment variable (the examples below use VIRLO_API_KEY) rather than in your code.

How do you make your first social media API call?

Send the key as a Bearer token. This call returns the formats TikTok creators are copying right now as structured JSON, ready to parse, store or pass to a model.

curl: TikTok content trends
curl "https://api.virlo.ai/v1/content-trends?platform=tiktok" \
  -H "Authorization: Bearer $VIRLO_API_KEY"

Swap platform=tiktok for platform=instagram to get Reels formats. Endpoint docs live at dev.virlo.ai.

How do you connect the social media API to Claude?

The API also runs an MCP server, so Claude or any MCP client can read live Virlo data inside a conversation with no glue code. Add this to your MCP config:

MCP config
{
  "mcpServers": {
    "virlo": {
      "url": "https://dev.virlo.ai/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer virlo_tkn_YOUR_API_KEY"
      }
    }
  }
}

Your model can then pull trending formats, analyse any video URL and surface outliers on request. Platform specifics are on the TikTok MCP and Instagram MCP pages, and claude.ai users can add the same server as a connector through Virlo for Claude.

What should you build first with a social media API?

Three builds pay back fastest because they replace work a team already does by hand.

Three first builds on the social media API
BuildHow it worksReplaces
Daily trend digestCall the trends endpoint on a cron, summarise the top movers, post to Slack each morningGuessing what's trending
Outlier alertsPoll for videos crossing the outlier threshold in your niches and send an alert the moment one landsManual research loops
URL breakdowns at scaleFeed TikTok or Reels URLs in a batch and get back hook, beats and pacingWatching competitors' videos one by one

Outlier alerts are the mechanic behind Matthew Berman's Monday Drop: he wired the API into Claude so each week it pulls the videos beating their creators' baselines in a client's niche and hands his team a research brief. He reports over 11 million views for one client and new clients closed by sharing what the system finds. Read the Monday Drop, or the no-code version in outlier videos.

Why do social media API calls fail?

When a call fails, it is almost always one of three setup problems, not the endpoint.

Common setup errors
SymptomLikely causeFix
UnauthorisedKey missing the virlo_tkn_ prefixCopy the full key from the dashboard
MCP server won't loadMalformed JSON in the config (a missing comma or brace)Validate the JSON and restart the client
Auth errors that look like rate limitingAPI balance has run outTop up the balance on the dashboard

Why use a social media API instead of manual research?

Manual research means 50 open tabs, 30 videos watched, notes nobody reopens and about four hours lost each week. An API turns the same questions into queries you can run on demand and route into whatever your team already uses.

Not a developer? The Outliers view in the web app shows the same videos with no code.

Generate a key and make your first TikTok or Instagram call in a few minutes.

How this resource was made

Source
The original Virlo API resource (agency case study, capabilities, setup steps, first builds and common errors). Endpoint paths and the base URL are taken from Virlo's live TikTok API and Instagram API pages.
How this page is made
Written by the Virlo team from that resource, with the first call and MCP URL updated to the current endpoints.
Limitations
The 11 million views figure is one agency's result for one client. Endpoint coverage changes; the API pages hold the current list.
As of
(first published May 28, 2026)

Source: Virlo, Social media API for TikTok and Instagram video data, set up in 10 minutes, November 2026, virlo.ai/resources/social-media-api

Want the full list?

TikTok and Instagram trends, sounds, outliers and per-video data as JSON, plus an MCP server for Claude. Virlo is social listening for TikTok and Instagram Reels: start a 7-day free trial at app.virlo.ai and see real videos from your niche before you pay.

Frequently asked questions

What is a social media API?

An interface that returns social media data, such as videos, creators, sounds and engagement, to your code as structured JSON instead of a web page.

Does Virlo's API cover TikTok and Instagram?

Yes. It returns TikTok videos and Instagram Reels, creator profiles, trending sounds, copied formats and per-video data.

How do I authenticate?

Generate a key that starts with virlo_tkn_ on dev.virlo.ai and send it as an Authorization: Bearer header on every request.

What is the base URL?

The base URL is https://api.virlo.ai and endpoints sit under /v1, for example /v1/content-trends?platform=tiktok.

Is there a subscription?

No. The API is pay as you go from a balance you top up on the developer dashboard.

Can Claude use the API directly?

Yes. The API runs an MCP server at https://dev.virlo.ai/api/mcp/mcp; add it to your MCP config with your key in the Authorization header.

What is an outlier in the API?

A video performing well above its own creator's baseline, which shows an idea that worked beyond the account's usual reach.

Why am I getting errors that look like rate limiting?

Usually an empty API balance, which surfaces as auth errors. Top up the balance and retry.

Do I need to run my own scrapers?

No. The API serves the data Virlo already collects and analyses, plus live lookups for single videos and profiles.

Run this on your own niche

TikTok and Instagram trends, sounds, outliers and per-video data as JSON, plus an MCP server for Claude.

7-day free trial, easy to cancel.