400 free credits — no credit card required.Start building
Logo
400 free credits — no credit card required

Map Data API

Scrape Tavily Map data with one API call. Returns the sitegraph of a website starting from a root URL — a list of discovered URLs without their full content. Cheaper and faster than crawl when you only need to enumerate pages (e.g. for sitemap discovery or coverage analysis). Use `instructions` to guide the mapper in natural language and the `select_*` / `exclude_*` filters (regex patterns, comma-separated) to narrow scope.

Try the Tavily Map API

See real data before writing a single line

GET/v1/tavily/map

Root URL to begin mapping.

11 optional parameters

Maximum link depth from the root URL. Defaults to 1.

Maximum number of links followed per level (per page). Defaults to 20.

Total number of links the mapper will process before stopping. Defaults to 50.

Natural-language instructions for the mapper (e.g. 'Find all pages related to API documentation').

Comma-separated regex patterns — only include URLs whose path matches.

Comma-separated regex patterns — only include URLs whose domain matches.

Comma-separated regex patterns — exclude URLs whose path matches.

Comma-separated regex patterns — exclude URLs whose domain matches.

Whether to follow / return links to external domains. Defaults to true.

Maximum time in seconds (10–150).

Comma-separated list of category hints to bias mapping toward.

Searching 27 platforms in parallel

·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
Tavily API

What can you do with the Map API?

The Map endpoint gives you structured Tavily data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

GET /v1/tavily/map?url=https%3A%2F%2Fdocs.tavily.com

Parameters

ParameterRequiredDescription
urlYesRoot URL to begin mapping.
max_depthNoMaximum link depth from the root URL. Defaults to 1.
max_breadthNoMaximum number of links followed per level (per page). Defaults to 20.
limitNoTotal number of links the mapper will process before stopping. Defaults to 50.
instructionsNoNatural-language instructions for the mapper (e.g. 'Find all pages related to API documentation').
select_pathsNoComma-separated regex patterns — only include URLs whose path matches.
select_domainsNoComma-separated regex patterns — only include URLs whose domain matches.
exclude_pathsNoComma-separated regex patterns — exclude URLs whose path matches.
exclude_domainsNoComma-separated regex patterns — exclude URLs whose domain matches.
allow_externalNoWhether to follow / return links to external domains. Defaults to true.
timeoutNoMaximum time in seconds (10–150).
categoriesNoComma-separated list of category hints to bias mapping toward.
API Details

How does the Tavily Map API work?

Send a GET request with your API key and get back clean, structured JSON. Every response follows our unified schema with computed fields.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for Tavily Map data?

We handle the complexity of Tavily data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 27 platforms covering 10B+ monthly active users.

One schema, every platform

Query 27 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.

No code required

Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": { "username": "charlidamelio", "followers": 124000 },
    "engagement": { "likes": 5200, "engagement_rate": 0.045 },
    "metadata": { "language": "en", "content_category": "food" }
  }
}
and many more

Ready to scrape Tavily Map data?

Get your API key and start pulling Tavily data in under 60 seconds.

Start for free