xpay tools logo
  • Tools
  • Collections
  • Skills
  • Docs
  • xpay.sh
  1. Home
  2. ›
  3. Valyu API
  4. ›

  5. Valyu Search

Valyu API
Valyu API logo
Valyu API
Tool

Valyu Search

valyu_search

Reference for the Valyu Search endpoint to search the web, research, and proprietary datasets via POST /v1/search.

How it works ↓
Pricing

Per call

$0.02

Model

flat

Pay only for what you use. No subscriptions.
Inputs

end_date

string

max_num_results

integer

fast_mode

boolean

query *

string

relevance_threshold

string

search_type

string

response_length

string

country_code

string

max_price

string

url_only

boolean

is_tool_call

boolean

included_sources

array

excluded_sources

array

category

string

start_date

string
Try It
API
MCP Config
Input Parameters
end_date
End date for time-filtered searches (YYYY-MM-DD)
max_num_results
Maximum number of results to return (1-20 for standard API keys, up to 100 with a special API key)
query *
The query string for the search
relevance_threshold
Minimum relevance score for results (0.0-1.0)
search_type
Type of search to perform.'web' searches and returns web content. 'proprietary' uses Valyu's full-text multimodal indicies (arxiv/pubmed/proprietary academic content). 'news' searches and returns only news articles.
response_length
Controls the length of content returned per result. Can be an integer for character count or predefined values: 'short' (25k), 'medium' (50k), 'large' (100k), 'max' (full)
country_code
2-letter ISO country code to bias search results to a specific country
max_price
Maximum price in dollars for a thousand retrievals (CPM). Only applies when provided. If not provided, adjusts automatically based on search type and max number of results.
included_sources
List of specific sources to search (URLs, domains or dataset names). When a URL or domain path is provided (e.g., 'https://valyu.ai/blog' or 'valyu.ai/blog'), only that specific path will be searched. For entire domains, use either the domain name (e.g., 'valyu.ai') or the base URL (e.g., 'https://valyu.ai').
excluded_sources
List of specific sources to exclude from search (URLs, domains, or dataset names). When a URL or domain path is provided (e.g., 'https://valyu.ai/blog' or 'valyu.ai/blog'), only that specific path will be excluded. For entire domains, use either the domain name (e.g., 'valyu.ai') or the base URL (e.g., 'https://valyu.ai').
category
Natural language category/guide phrase to help guide the search to the most relevant content. For example 'agentic use-cases
start_date
Start date for time-filtered searches (YYYY-MM-DD)
Cost per run
Execution cost
$0.02
Deducted from your xPay allowance
About Valyu Search

Reference for the Valyu Search endpoint to search the web, research, and proprietary datasets via POST /v1/search.

Frequently Asked Questions

Reference for the Valyu Search endpoint to search the web, research, and proprietary datasets via POST /v1/search.

Valyu Search costs $0.02 per call on xpay. No subscription, no minimums. Pay only for the calls you make. New accounts get $5 in free credits.

Connect the Valyu API MCP endpoint to your client — Claude Code: claude mcp add --transport http valyu "https://valyu.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"; Cursor/Windsurf/Cline/VS Code: same URL in mcp.json. The agent will see valyu_search as a callable tool with the input schema and run it directly. (Unified across all providers: https://mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY, then xpay_run with toolPath valyu/valyu_search.)

Yes — that's exactly what xpay is for. You don't need a Valyu API account or API key. Sign up at xpay.tools (Google or email), get $5 free credit, and run Valyu Search immediately. Billing flows through your xpay balance.

Valyu Search accepts 15 input parameters: end_date, max_num_results, fast_mode, query, relevance_threshold, search_type…. See the input schema and runnable form on this page for details and to test live.

xpay tools logo

Marketplace for AI Capabilities. Run agents, tools & prompts with pay-per-use micropayments.

or ask your AI app
Popular Tools
FirecrawlTavilyExaHunterPerplexityRecraftIdeogramFlux
Collections
AI Image & MediaContent & ResearchDev ToolsFinanceLead GenWeb ScrapingCompetitive Intel
Developers
DocumentationAPI ReferenceQuickstartSDKsSkillsskill.mdllms.txt
Resources
The Agentic EconomyAgentic CommerceAgent Frameworksx402 ProtocolBlog
Company
About xpayxpay.shGitHubDiscordTwitter / X
© 2026 Agentically Inc. All rights reserved.
Privacy PolicyTerms of Service
✦
xpay Assistant
Valyu Search by Valyu

Ask me about tools, pricing, or how to connect

How does this tool work?
What parameters does it accept?
Show me a usage example
DocsCollectionsExplore