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

Perplexity API
Perplexity API logo
Perplexity API
Tool

Perplexity Search

perplexity_search

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

How it works ↓

Pricing

Per call

$0.02

Model

flat


Pay only for what you use. No subscriptions.
Inputs

last_updated_before_filter

string

country

string

max_tokens

integer

search_language_filter

array

query *

string

max_tokens_per_page

integer

search_after_date

string

max_results

integer

search_domain_filter

array

search_recency_filter

string

search_before_date

string

last_updated_after_filter

string
Try It
API
MCP Config
Input Parameters
last_updated_before_filter
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
Country code to filter search results by geographic location (e.g., 'US', 'GB', 'DE').
max_tokens
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
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 *
A search query. Can be a single query or a list of queries for multi-query search.
max_tokens_per_page
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
Filters search results to only include content published after this date. Format should be %m/%d/%Y (e.g., '10/15/2025').
max_results
The maximum number of search results to return.
search_domain_filter
A list of domains/URLs to limit search results to. Maximum 20 domains.
search_recency_filter
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
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
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').
Cost per run
Execution cost
$0.02
Deducted from your xPay allowance
About Perplexity Search

Perplexity Search on xpay — agent-grade web search, one MCP call

Perplexity's Search API is built for AI agents. Unlike Google or Bing-style result links, it returns answer-grade snippets with inline citations — the same retrieval layer that powers Perplexity's Sonar chat models, exposed directly so your agent can run search as a discrete step.

xpay wraps Perplexity Search as the perplexity_search MCP tool. Pass a query, get back ranked results with content snippets and source URLs, billed per call.

What you get back

{
  "results": [
    {
      "title": "...",
      "url": "https://...",
      "snippet": "Answer-grade extract relevant to the query.",
      "published_date": "2026-04-22"
    }
  ]
}

Snippets are extractive and answer-shaped, not link-list teasers. That makes Perplexity Search materially better than scraping a SERP when your agent needs to reason over the result content directly.

When Perplexity Search beats Tavily / Exa / Linkup

  • Citation requirements. Each result has a verifiable source URL.
  • Recency. Perplexity prioritizes fresh content; good for news, regulatory, market-event queries.
  • Mixed open-web coverage. Reaches forums, news, docs, and long-tail sources Google indexes but most agent search APIs filter out.

When to choose alternatives

  • For paper/research search, Semantic Scholar or arXiv tools on xpay are better.
  • For clean Markdown extraction of a known URL, Jina Reader or Firecrawl Scrape are cheaper.
  • For vector-search over your private docs, run your own retrieval.

Pricing

Roughly $0.005–$0.02 per call on xpay. Fixed per-call, regardless of result count. $5 free credit on signup.

How it pairs with chat completions

Common agent pattern: perplexity_search to gather sources, then a frontier LLM (anthropic_claude, openai_gpt) to reason over the snippets. Or use perplexity_chat_completions for the all-in-one call where Sonar handles search + answer in a single round-trip.

Frequently Asked Questions

It is Perplexity's standalone web-search endpoint — the same retrieval layer that powers Sonar chat models, exposed directly. You pass a query and get back ranked results with answer-grade snippets and source URLs.

Search returns ranked results + snippets only — no LLM-generated answer. Sonar chat completions runs the search and returns an LLM-synthesized answer plus citations. Use Search when you want raw retrieval (and to feed your own LLM), use Sonar chat for one-call answer + sources.

Approximately $0.005–$0.02 per call on xpay, fixed regardless of result count. New accounts get $5 free credit.

Yes when available. Perplexity surfaces published_date for news and dated content; for static pages the field may be absent.

Tavily is cheaper and good for general agent search with content extraction; Exa is best for neural / "find similar" semantic search. Perplexity Search is best when citation quality, recency, and answer-shaped snippets matter most.

Yes — that is the point of running it through xpay. You authenticate with your xpay key only; xpay holds the upstream Perplexity credential and bills you per call.

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
Perplexity Search by Perplexity

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