xpay tools logo
  • Tools
  • Collections
  • Skills
  • Docs
  • xpay.sh
Tool Skill
Perplexity API logo

Perplexity Search

perplexity_search

Get ranked search results from Perplexity’s continuously refreshed index with advanced filtering and customization options.

$0.02/call
Flat rate
Perplexity API
Raw SKILL.mdTool Page

When to Use

Use this tool when you need to get ranked search results from perplexity’s continuously refreshed index with advanced filtering and customization options.. This is part of the Perplexity API provider on xpay✦.

MCP Connection

Connect to xpay✦ to access this tool (and 4+ 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:

  1. xpay_details — Get full input schema: xpay_details("perplexity/perplexity_search")
  2. xpay_run — Execute: xpay_run("perplexity/perplexity_search", { ...inputs })

Input Parameters

ParameterTypeRequiredDescription
last_updated_before_filterstringNoPerplexity-Specific: Filters search results to only include content last updated before this date. Format should be %m/%d/%Y (e.g., '12/30/2025').
countrystringNoCountry code to filter search results by geographic location (e.g., 'US', 'GB', 'DE').
max_tokensintegerNoThe maximum total number of tokens of webpage content returned across all search results. This sets the overall content budget for the search operation. Higher values return more content in the snippet fields. Use in combination with max_tokens_per_page to control content distribution.
search_language_filterarrayNoPerplexity-Specific: Filters search results to only include content in the specified languages. Accepts an array of ISO 639-1 language codes (2 lowercase letters). Maximum 10 language codes per request.
querystringYesA search query. Can be a single query or a list of queries for multi-query search.
max_tokens_per_pageintegerNoControls the maximum number of tokens retrieved from each webpage during search processing. Higher values provide more comprehensive content extraction but may increase processing time.
search_after_datestringNoFilters search results to only include content published after this date. Format should be %m/%d/%Y (e.g., '10/15/2025').
max_resultsintegerNoThe maximum number of search results to return.
search_domain_filterarrayNoA list of domains/URLs to limit search results to. Maximum 20 domains.
search_recency_filterstringNoFilters search results based on recency. Specify 'day' for results from the past 24 hours, 'week' for the past 7 days, 'month' for the past 30 days, or 'year' for the past 365 days.
search_before_datestringNoFilters search results to only include content published before this date. Format should be %m/%d/%Y (e.g., '10/16/2025').
last_updated_after_filterstringNoPerplexity-Specific: Filters search results to only include content last updated after this date. Format should be %m/%d/%Y (e.g., '07/01/2025').

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

  • Perplexity API (all tools) — 5 tools
  • Perplexity Chat Completions — $0.02/call
  • Perplexity Sonar Chat Completions Api — $0.02/call
  • Perplexity Get Async Chat Completion Response — $0.02/call
  • Perplexity List Async Chat Completions — $0.02/call

Links

  • Tool page: https://xpay.tools/perplexity/perplexity-search/
  • Provider: https://xpay.tools/perplexity/
  • All tools: https://xpay.tools/explore
How to Execute
// 1. Get full schema
xpay_details("perplexity/perplexity_search")
// 2. Execute
xpay_run("perplexity/perplexity_search", { ...inputs })
Input Parameters
ParameterTypeRequiredDescription

last_updated_before_filter

stringNo

Perplexity-Specific: Filters search results to only include content last updated before this date. Format should be %m/%d/%Y (e.g., '12/30/2025').

country

stringNo

Country code to filter search results by geographic location (e.g., 'US', 'GB', 'DE').

max_tokens

integerNo

The maximum total number of tokens of webpage content returned across all search results. This sets the overall content budget for the search operation. Higher values return more content in the snippet fields. Use in combination with max_tokens_per_page to control content distribution.

search_language_filter

arrayNo

Perplexity-Specific: Filters search results to only include content in the specified languages. Accepts an array of ISO 639-1 language codes (2 lowercase letters). Maximum 10 language codes per request.

query

string
Yes

A search query. Can be a single query or a list of queries for multi-query search.

max_tokens_per_page

integerNo

Controls the maximum number of tokens retrieved from each webpage during search processing. Higher values provide more comprehensive content extraction but may increase processing time.

search_after_date

stringNo

Filters search results to only include content published after this date. Format should be %m/%d/%Y (e.g., '10/15/2025').

max_results

integerNo

The maximum number of search results to return.

search_domain_filter

arrayNo

A list of domains/URLs to limit search results to. Maximum 20 domains.

search_recency_filter

stringNo

Filters search results based on recency. Specify 'day' for results from the past 24 hours, 'week' for the past 7 days, 'month' for the past 30 days, or 'year' for the past 365 days.

search_before_date

stringNo

Filters search results to only include content published before this date. Format should be %m/%d/%Y (e.g., '10/16/2025').

last_updated_after_filter

stringNo

Perplexity-Specific: Filters search results to only include content last updated after this date. Format should be %m/%d/%Y (e.g., '07/01/2025').

Related Tools from Perplexity API
Perplexity Chat Completions — $0.02Perplexity Sonar Chat Completions Api — $0.02Perplexity Get Async Chat Completion Response — $0.02Perplexity List Async Chat Completions — $0.02
Install Skill
Claude Code
claude /install-skill https://xpay.tools/skills/perplexity/perplexity-search/SKILL.md
CLI
npx @xpaysh/cli install perplexity/perplexity-search
Manual
curl -o SKILL.md https://xpay.tools/skills/perplexity/perplexity-search/SKILL.md
Pricing

Cost

$0.02/call

Model

Flat rate

Provider

Perplexity API

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