Valyu Search Skill — Valyu API Tool for AI Agents

Tool Skill

Valyu Search

valyu_search

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

$0.02/call

Flat rate

Valyu API

Raw SKILL.md Tool Page

When to Use

Use this tool when you need to reference for the valyu search endpoint to search the web, research, and proprietary datasets via post /v1/search.. This is part of the Valyu API provider on xpay✦.

MCP Connection

Connect to xpay✦ to access this tool (and 12+ others):

{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}

For Claude Code:

claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"

How to Execute

Use the xpay✦ meta-tools to run this tool:

xpay_details — Get full input schema: xpay_details("valyu/valyu_search")
xpay_run — Execute: xpay_run("valyu/valyu_search", { ...inputs })

Input Parameters

Parameter	Type	Required	Description
`end_date`	string	No	End date for time-filtered searches (YYYY-MM-DD)
`max_num_results`	integer	No	Maximum number of results to return (1-20 for standard API keys, up to 100 with a special API key)
`fast_mode`	boolean	No	Enable fast mode for reduced latency but shorter results. Best for general purpose queries.
`query`	string	Yes	The query string for the search
`relevance_threshold`	string	No	Minimum relevance score for results (0.0-1.0)
`search_type`	string	No	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`	string	No	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`	string	No	2-letter ISO country code to bias search results to a specific country
`max_price`	string	No	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.
`url_only`	boolean	No	When set to true, only returns URLs for results (no content). Only applies when search_type is 'web' or 'news'.
`is_tool_call`	boolean	No	Tunes retrieval process based on whether the API is being called by an AI agent as a tool call, or a user query.
`included_sources`	array	No	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`	array	No	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`	string	No	Natural language category/guide phrase to help guide the search to the most relevant content. For example 'agentic use-cases
`start_date`	string	No	Start date for time-filtered searches (YYYY-MM-DD)

Pricing

Cost: $0.02/call
Balance check: Use xpay_balance to check remaining credits
Get your API key at xpay.tools — $5 free credits included

Related Skills

Valyu API (all tools) — 13 tools
Valyu Create Batch — $0.02/call
Valyu Get Status — $0.02/call
Valyu Update Task — $0.02/call
Valyu Cancel Task — $0.02/call
Valyu Delete Task — $0.02/call

Links

Tool page: https://xpay.tools/valyu/valyu-search/
Provider: https://xpay.tools/valyu/
All tools: https://xpay.tools/explore

How to Execute

// 1. Get full schema

xpay_details("valyu/valyu_search")

// 2. Execute

xpay_run("valyu/valyu_search", { ...inputs })

Input Parameters

Parameter	Type	Required	Description
end_date	string	No	End date for time-filtered searches (YYYY-MM-DD)
max_num_results	integer	No	Maximum number of results to return (1-20 for standard API keys, up to 100 with a special API key)
fast_mode	boolean	No	Enable fast mode for reduced latency but shorter results. Best for general purpose queries.
query	string	Yes	The query string for the search
relevance_threshold	string	No	Minimum relevance score for results (0.0-1.0)
search_type	string	No	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	string	No	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	string	No	2-letter ISO country code to bias search results to a specific country
max_price	string	No	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.
url_only	boolean	No	When set to true, only returns URLs for results (no content). Only applies when search_type is 'web' or 'news'.
is_tool_call	boolean	No	Tunes retrieval process based on whether the API is being called by an AI agent as a tool call, or a user query.
included_sources	array	No	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	array	No	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	string	No	Natural language category/guide phrase to help guide the search to the most relevant content. For example 'agentic use-cases
start_date	string	No	Start date for time-filtered searches (YYYY-MM-DD)

Related Tools from Valyu API

Valyu Create Batch — $0.02 Valyu Get Status — $0.02 Valyu Update Task — $0.02 Valyu Cancel Task — $0.02 Valyu Delete Task — $0.02 Valyu Get Batch Status — $0.02 Valyu List Batch Tasks — $0.02 Valyu Cancel Batch — $0.02

Install Skill

Claude Code

claude /install-skill https://xpay.tools/skills/valyu/valyu-search/SKILL.md

CLI

npx @xpaysh/cli install valyu/valyu-search

Manual

curl -o SKILL.md https://xpay.tools/skills/valyu/valyu-search/SKILL.md

Pricing

Cost

$0.02/call

Model

Flat rate

Provider

Valyu API

Input Parameters

Parameter

Type

Required

Description

end_date

string

End date for time-filtered searches (YYYY-MM-DD)

max_num_results

integer

Maximum number of results to return (1-20 for standard API keys, up to 100 with a special API key)

fast_mode

boolean

Enable fast mode for reduced latency but shorter results. Best for general purpose queries.

query

string

Yes

The query string for the search

relevance_threshold

string

Minimum relevance score for results (0.0-1.0)

search_type

string

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

string

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

string

2-letter ISO country code to bias search results to a specific country

max_price

string

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.

url_only

boolean

When set to true, only returns URLs for results (no content). Only applies when search_type is 'web' or 'news'.

is_tool_call

boolean

Tunes retrieval process based on whether the API is being called by an AI agent as a tool call, or a user query.

included_sources

array

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

array

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

string

Natural language category/guide phrase to help guide the search to the most relevant content. For example 'agentic use-cases

start_date

string

Start date for time-filtered searches (YYYY-MM-DD)

Parameter

Type

Required

Description

end_date

string

End date for time-filtered searches (YYYY-MM-DD)

max_num_results

integer

Maximum number of results to return (1-20 for standard API keys, up to 100 with a special API key)

fast_mode

boolean

Enable fast mode for reduced latency but shorter results. Best for general purpose queries.

query

string

Yes

The query string for the search

relevance_threshold

string

Minimum relevance score for results (0.0-1.0)

search_type

string

response_length

string

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

string

2-letter ISO country code to bias search results to a specific country

max_price

string

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.

url_only

boolean

When set to true, only returns URLs for results (no content). Only applies when search_type is 'web' or 'news'.

is_tool_call

boolean

Tunes retrieval process based on whether the API is being called by an AI agent as a tool call, or a user query.

included_sources

array

excluded_sources

array

Valyu Search

When to Use

MCP Connection

How to Execute

Input Parameters

Pricing

Related Skills

Links

How to Execute

Input Parameters

Related Tools from Valyu API

Install Skill

Pricing

Popular Tools

Collections

Developers

Resources

Company

Valyu Search

When to Use

MCP Connection

How to Execute

Input Parameters

Pricing

Related Skills

Links

How to Execute

Input Parameters

Related Tools from Valyu API

Install Skill

Pricing

Popular Tools

Collections

Developers

Resources

Company