polymerdao/polymer-pay-tavily

Tavily

Real-time search, extraction, and web crawling through a single, secure API. Access Tavily's search, crawl, extract, map, and research capabilities through the Polymer Pay proxy. No API key needed — payment is handled automatically.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tavily

To get an Polymer Pay API key, sign up at https://my.pay.polymerlabs.org/dashboard/api-keys.

Common Operations

Search

Execute a search query using Tavily Search.

Pricing: $0.016

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tavily/search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "latest developments in AI agents",
    "search_depth": "advanced",
    "max_results": 10,
    "include_answer": true
  }
}

Response: JSON with search results including snippets and optional AI answer.

Crawl

Graph-based website traversal with intelligent discovery.

Pricing: Dynamic

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tavily/crawl",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "url": "https://example.com",
    "max_depth": 2,
    "limit": 50
  }
}

Response: JSON with crawled content from website.

Extract

Extract web page content from specific URLs.

Pricing: Dynamic

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tavily/extract",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "urls": ["https://example.com/article"],
    "extract_depth": "basic"
  }
}

Response: JSON with extracted content from URLs.

Map

Traverse websites like a graph to generate comprehensive site maps.

Pricing: Dynamic

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tavily/map",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "url": "https://example.com/docs",
    "max_depth": 3,
    "limit": 100
  }
}

Response: JSON with site map of discovered URLs.

Research

Comprehensive research with multiple searches and synthesis.

Pricing: $0.50

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tavily/research",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "input": "What is the current state of AI in healthcare?",
    "model": "pro"
  }
}

Response: JSON with comprehensive research report and citations.

When to Use

• Search — User wants real-time web search with filtering
• Crawling — User needs to crawl websites with intelligent discovery
• Extraction — User wants to extract content from specific URLs
• Site mapping — User needs to discover all pages on a website
• Research — User wants comprehensive research reports

Best Practices

• Use search_depth — 'fast' for speed, 'advanced' for best relevance
• Set max_results — Control the number of returned results
• Include_answer — Get AI-generated answers alongside search results
• Use filters — Apply date, domain, and topic filters for targeted results
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting