polymerdao/polymer-pay-valyu

Valyu

Valyu's Search API lets your AI search for the information it needs. Access high-quality content from the web and proprietary sources, with full-text multimodal retrieval 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/valyu

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

Common Operations

Search

Search the web, research, and proprietary datasets.

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/valyu/v1/search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "latest developments in AI agents",
    "max_num_results": 10,
    "search_type": "web"
  }
}

Response: JSON with search results including content.

Answer

Get AI-generated answers blended with search results.

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/valyu/v1/answer",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "What are the key trends in quantum computing?",
    "search_type": "web"
  }
}

Response: JSON with AI-generated answer and cited sources.

Extract Content

Extract clean, structured content from URLs.

Pricing: $0.01

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

Response: JSON with extracted content from URLs.

Deep Research

Create comprehensive research tasks.

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/valyu/v1/deepresearch/tasks",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "Comprehensive analysis of AI in healthcare 2025",
    "mode": "standard"
  }
}

Response: JSON with research task ID for polling.

When to Use

• Web search — User needs high-quality search results
• AI answers — User wants AI-generated answers with sources
• Content extraction — User needs to extract content from URLs
• Deep research — User wants comprehensive research reports

Best Practices

• Set search_type — Use 'web', 'news', or 'proprietary' for different sources
• Configure response_length — Use 'short', 'medium', 'large', or 'max' for content size
• Use filters — Apply date filters, source filters for targeted results
• Poll for research — Use returned task ID to poll for deep research completion
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting