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
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.
| Data | What it is |
|---|---|
| Trending formats and sounds | Formats TikTok and Instagram creators are copying now, and the audio used in the most new videos |
| Outlier detection | Videos performing well above their creator's own baseline |
| Per-video breakdowns | Hook, structure and engagement signals for a video you pass by URL |
| Creator and niche tracking | Profiles, recent videos and topics you choose, on demand |
| Cross-platform signals | Spot a hook winning on TikTok before it reaches Reels |
| Method | Path | Returns |
|---|---|---|
| GET | /v1/content-trends?platform=tiktok | Copied formats with a recipe, stage and example videos |
| GET | /v1/sounds/trending?platform=instagram | Audio picked up by the most new Reels over 7 or 30 days |
| POST | /v1/search/videos | Analysed 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.
- Sign up at dev.virlo.ai.
- Generate a key. It starts with
virlo_tkn_. - 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 "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:
{
"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.
| Build | How it works | Replaces |
|---|---|---|
| Daily trend digest | Call the trends endpoint on a cron, summarise the top movers, post to Slack each morning | Guessing what's trending |
| Outlier alerts | Poll for videos crossing the outlier threshold in your niches and send an alert the moment one lands | Manual research loops |
| URL breakdowns at scale | Feed TikTok or Reels URLs in a batch and get back hook, beats and pacing | Watching 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.
| Symptom | Likely cause | Fix |
|---|---|---|
| Unauthorised | Key missing the virlo_tkn_ prefix | Copy the full key from the dashboard |
| MCP server won't load | Malformed JSON in the config (a missing comma or brace) | Validate the JSON and restart the client |
| Auth errors that look like rate limiting | API balance has run out | Top 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.
Related free resources
- Outlier videos for every client, found and briefed every Monday
- Content automation with Claude: the Monday Drop install kit
- Agency content system: viral concepts for every client, every Monday
- Claude code automation: find a viral video format and remake it as ...
- Best Claude prompts for social media: 25 questions to ask 23.3M vir...
- Connect Claude to Instagram and TikTok, then copy this week's conte...
- All Virlo resources
- TikTok trends this week
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.