# Tavily Data API (https://www.socialcrawl.dev/platforms/tavily)

> Tavily API access through SocialCrawl: 4 endpoints — web search, URL content extract, site map, and LLM-guided crawl — in the same JSON envelope as 43 other platforms. Each call costs 1 credit; 100 free credits on signup, no card. One x-api-key covers Tavily, Perplexity Sonar, and AI social search together.

TL;DR: SocialCrawl's Tavily API exposes 4 endpoints, 1 credit per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Search | GET | `/v1/tavily/search` | 1 | Tavily web search with optional LLM-generated answer |
| Extract | GET | `/v1/tavily/extract` | 1 | Extract clean content from one or more URLs |
| Map | GET | `/v1/tavily/map` | 1 | Map a website's sitegraph |
| Crawl | GET | `/v1/tavily/crawl` | 1 | Crawl a website with LLM-driven path selection |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tavily/search?query=claude%20opus%204.7%20release%20notes" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs Tavily API (direct)

| Feature | SocialCrawl | Tavily API (direct) |
| --- | --- | --- |
| Authentication | One x-api-key shared with 43 other platforms | Separate Tavily account and API key |
| Setup | GET requests at /v1/tavily/{resource} in the same envelope as your other sources | Tavily SDK or REST with its own response format |
| Pricing | 1 credit per call from one shared balance | Separate plan with its own monthly credit allotment |
| Response schema | Unified SocialCrawl JSON envelope across search, extract, map, and crawl | Tavily-native response shapes |
| Data coverage | Search, extract, map, and crawl, plus Perplexity and social search on the same key | Full Tavily surface with every native parameter |
| Free tier | 100 free credits, no credit card | Free tier with monthly credits on Tavily's own plan |

## FAQ

### What is the Tavily API on SocialCrawl?

SocialCrawl gives you access to the Tavily web-search API through your single SocialCrawl x-api-key and credit balance. Tavily is a search API built for AI agents and LLMs. You call it at /v1/tavily/{resource} on the same key as your social, dev, and search data — no separate Tavily account.

### Which Tavily endpoints does SocialCrawl offer?

4 endpoints: Search, Extract, Map, and Crawl. Each is a GET at /v1/tavily/{resource}.

### Do I need a separate Tavily API key?

No. Your SocialCrawl x-api-key covers Tavily. You do not register at api.tavily.com or manage a second key — SocialCrawl proxies the request and bills it from your existing credit balance, the same way every other SocialCrawl endpoint works.

### How much does the Tavily API cost on SocialCrawl?

Tavily endpoints run on the standard tier at 1 credit per call. New accounts get 100 free credits with no credit card required — enough to test search, extract, map, and crawl many times over before you pay anything.

### Can I also reach Perplexity or AI search from the same key?

Yes. The same SocialCrawl key reaches Perplexity Sonar for research and SocialCrawl's own AI social search across 12 platforms. One key gives you Tavily AND Perplexity AND social search — pick the backend that fits the query without juggling accounts.

### When should I use search vs crawl vs map vs extract?

Use search to find pages for a query, extract to read the content of URLs you already have, map to discover a site's link structure fast, and crawl to walk a site following LLM-chosen paths and pull content. Search and extract suit RAG; map and crawl suit site ingestion.

### What is the best way to access Tavily search via API?

Going direct to Tavily gives you the full native surface and its own free tier. SocialCrawl makes sense when Tavily is one of several backends: search, extract, map, and crawl run at 1 credit per call on the same x-api-key as Perplexity Sonar and social search — with 100 free credits to start, no card.

### Is there a Tavily data API?

Tavily is itself a web-search API, so the data API is Tavily's own and available directly with its free tier. SocialCrawl adds convenience rather than access: it proxies Tavily search, extract, map, and crawl under one x-api-key so you reach genuine Tavily on the same key and credits as Perplexity Sonar and social search, at 1 credit per call.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to use Tavily search through the SocialCrawl API
- Can I call Tavily and Perplexity from one SocialCrawl key?
- What is the difference between Tavily search, crawl, map, and extract?