Skip to the page

Tavily map compatible

Change the address.

Since November 10, 2026 SpecStream answers Tavily's POST /map in Tavily's own JSON. A map costs $0.0008, one page read, for up to 5,000 URLs. Tavily charges 1 API credit per 10 pages mapped.

The switch is one line: TavilyClient(api_key=KEY, api_base_url="https://api.specstream.ai/tavily") in place of TavilyClient(api_key="tvly-..."). client.map() and your parser stay.

Crawls run on the same key at https://api.specstream.ai/firecrawl/v2/crawl, $0.0008 a page. The Extract API scores 0.908 F1 on WCXB, and a new account gets $10 of credit, no card.

New accounts get $10 of credit, no card. It covers 12,500 maps or pages.

Tavily map to SpecStream, parameter by parameter and field by field

SpecStreamTavily
AddressPOST https://api.specstream.ai/tavily/mapPOST https://api.tavily.com/map
The keyA SpecStream key as Authorization: Bearer, or api_key in the bodyA Tavily key as Authorization: Bearer tvly-...
Parameters appliedurl (a bare host too), limit, max_depth, select_paths, exclude_paths, select_domains and exclude_domainsThe same, plus instructions, max_breadth and allow_external
URLs a map50 by default, up to 5,000limit default 50
Replybase_url, results as URL strings, response_time and request_idThe same, plus usage
ErrorsTavily's own: 400 for a bad pattern or max_depth past 5, 401 for a wrong key. A busy call gets 429 with Retry-After and is not charged400 invalid request, 401 key wrong or missing, 429 with Retry-After, 432 plan limit exceeded
Price$0.0008 a map, whatever its size1 API credit per 10 pages, 2 per 10 with instructions. Pay as you go is $0.008 a credit
CrawlNot at /tavily/crawl. Firecrawl's crawl on the same key at https://api.specstream.ai/firecrawl, $0.0008 a pagePOST /crawl, 1 credit per 5 successful extractions
Free to start$10 of credit, no card, which covers 12,500 maps1,000 free API credits a month

The Tavily map reference, on SpecStream

What else Tavily map users price

How SpecStream scores

The same numbers as the benchmarks page, from the official tasks and scorers.

How to migrate, step by step

1. Create a key under Agents & API in the workspace. A new account gets $10 of credit, no card.

2. Set the address to https://api.specstream.ai/tavily where your code has https://api.tavily.com, and send the SpecStream key as the Bearer token. In Python:

import requests

BASE = "https://api.specstream.ai/tavily"  # was https://api.tavily.com

reply = requests.post(
    f"{BASE}/map",
    headers={"Authorization": f"Bearer {SPECSTREAM_KEY}"},
    json={"url": "https://quotes.toscrape.com/", "limit": 100, "exclude_paths": ["/tag/.*"]},
    timeout=60,
)
reply.raise_for_status()
for url in reply.json()["results"]:
    print(url)

3. In JavaScript:

const reply = await fetch("https://api.specstream.ai/tavily/map", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.SPECSTREAM_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "quotes.toscrape.com", max_depth: 2, limit: 500 }),
});
const { base_url, results } = await reply.json();
console.log(base_url, results.length);

4. Read 429 as a call to send again after Retry-After. It is not charged.

Frequently asked questions

Something we didn't answer? Talk to a human

Is there a Tavily map compatible API?
Yes. Since Nov 10, 2026 SpecStream answers Tavily's POST /map at https://api.specstream.ai/tavily/map with Tavily's reply, as measured on production. A map costs $0.0008.
How do I migrate from Tavily map?
Change one address: https://api.tavily.com becomes https://api.specstream.ai/tavily, and a SpecStream key goes in the Bearer token. url, limit, max_depth, select_paths, exclude_paths, select_domains and exclude_domains keep their meaning.
How much does Tavily map cost?
1 API credit per 10 pages, 2 per 10 with instructions, and pay as you go is $0.008 a credit. On SpecStream a map of up to 5,000 URLs costs $0.0008.
Does the Tavily Python SDK work with SpecStream?
Yes. tavily-python 0.8.5 works with api_base_url="https://api.specstream.ai/tavily", as tested on production on Nov 10, 2026. map, search and extract run on that address.
Does SpecStream answer Tavily crawl?
Not at /tavily/crawl. Since Nov 10, 2026 crawls run on the same key at https://api.specstream.ai/firecrawl/v2/crawl, in Firecrawl's form, at $0.0008 a page with text.
Which Tavily map fields does SpecStream not return?
usage. base_url, results, response_time and request_id come back on every reply.

Sources

SpecStream wrote this page. Each Tavily figure comes from Tavily's own pages, and each other provider's figure from that company's own page. The route's behavior comes from its code and the pass table measured on production.

  1. Tavily mapdocs.tavily.com/documentation/api-reference/endpoint/map, read Nov 10, 2026
  2. Tavily crawldocs.tavily.com/documentation/api-reference/endpoint/crawl, read Nov 10, 2026
  3. Tavily pricingtavily.com/pricing, read Nov 10, 2026
  4. Tavily API creditsdocs.tavily.com/documentation/api-credits.md, read Nov 10, 2026
  5. SpecStream Tavily map pass tablespecstream.ai/specstream/dialects/tavily_site.md, read Nov 10, 2026
  6. Spider pricingspider.cloud/pricing, read Nov 10, 2026
  7. Firecrawl pricingfirecrawl.dev/pricing, read Nov 10, 2026
  8. Firecrawl billingdocs.firecrawl.dev/billing.md, read Nov 10, 2026
  9. SpecStream benchmarksspecstream.ai/benchmarks, read Nov 10, 2026
  10. SpecStream for agentsspecstream.ai/agents.md, read Nov 10, 2026