400 free credits — no credit card required

Search Data API

Name: Tavily Search API
Brand: SocialCrawl
Availability: InStock

Scrape Tavily Search data with one API call. Runs a web search via Tavily and returns ranked results plus an optional LLM-generated `answer` synthesised from the top sources. Set `include_answer=true` to enable answer synthesis. Use `search_depth=advanced` for higher-relevance results (also unlocks `chunks_per_source`). Filter results to specific domains via `include_domains` (comma-separated), or exclude via `exclude_domains`. Time-bounded queries via `time_range` (`d` / `w` / `m` / `y`) or explicit `start_date` / `end_date` (YYYY-MM-DD).

Start for free View Documentation

Try the Tavily Search API

See real data before writing a single line

GET/v1/tavily/search

queryrequired

The search query — natural-language free text.

14 optional parameters

search_depth

Latency-vs-relevance tradeoff. `basic` is the default; `advanced` unlocks `chunks_per_source` and higher-relevance ranking.

topic

Search category. Defaults to `general`. Use `news` for time-sensitive queries and `finance` for market data.

time_range

Time window relative to now. Accepts `day` / `week` / `month` / `year` (or shorthand `d` / `w` / `m` / `y`).

max_results

Number of results to return (1–20). Defaults to 5.

chunks_per_source

Max relevant chunks returned per source (1–5). Only honoured when `search_depth=advanced`. Defaults to 3.

include_images

Include images alongside the result content.

include_image_descriptions

Include AI-generated descriptions for the returned images.

include_answer

Include an LLM-generated answer string synthesised from the top sources.

include_raw_content

Include the raw HTML/text alongside the cleaned content.

include_domains

Comma-separated list of domains to restrict results to (e.g. `nytimes.com,reuters.com`).

exclude_domains

Comma-separated list of domains to exclude from results.

country

ISO 3166-1 alpha-2 country code to bias results toward.

start_date

Inclusive lower bound on result publish date (YYYY-MM-DD).

end_date

Inclusive upper bound on result publish date (YYYY-MM-DD).

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 Search API?

The Search 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/search?query=claude+opus+4.7+release+notes

Parameters

Parameter	Required	Description
query	Yes	The search query — natural-language free text.
search_depth	No	Latency-vs-relevance tradeoff. `basic` is the default; `advanced` unlocks `chunks_per_source` and higher-relevance ranking. (basic \| advanced \| fast \| ultra-fast)
topic	No	Search category. Defaults to `general`. Use `news` for time-sensitive queries and `finance` for market data. (general \| news \| finance)
time_range	No	Time window relative to now. Accepts `day` / `week` / `month` / `year` (or shorthand `d` / `w` / `m` / `y`). (day \| week \| month \| year \| d \| w \| m \| y)
max_results	No	Number of results to return (1–20). Defaults to 5.
chunks_per_source	No	Max relevant chunks returned per source (1–5). Only honoured when `search_depth=advanced`. Defaults to 3.
include_images	No	Include images alongside the result content.
include_image_descriptions	No	Include AI-generated descriptions for the returned images.
include_answer	No	Include an LLM-generated answer string synthesised from the top sources.
include_raw_content	No	Include the raw HTML/text alongside the cleaned content.
include_domains	No	Comma-separated list of domains to restrict results to (e.g. `nytimes.com,reuters.com`).
exclude_domains	No	Comma-separated list of domains to exclude from results.
country	No	ISO 3166-1 alpha-2 country code to bias results toward.
start_date	No	Inclusive lower bound on result publish date (YYYY-MM-DD).
end_date	No	Inclusive upper bound on result publish date (YYYY-MM-DD).

API Details

How does the Tavily Search 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 Search 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.

One schema for every platform — write your integration once
Computed fields on every response: engagement rate, reach, category, language
No scraping infrastructure to build, no proxies to manage, no rate limits to fight
Real-time data from Tavily — no caching, no delays

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 Search data?

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

Start for free