{"uid":"cap_xMTQkP-Za72aYqYFWSEa-","slug":"perplexity-search-79dc1cbe","name":"Perplexity Web Search (Sonar)","description":"Search the web and retrieve ranked results with titles, URLs, snippets, and dates. Supports domain, language, recency, and date range filters.","url":"https://perplexity.mpp.paywithlocus.com/perplexity/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"query":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Search query — a single string or array of queries"},"country":{"type":"string","description":"Country code for result localization (ISO 3166-1 alpha-2)"},"max_results":{"type":"number","description":"Maximum results to return (1–20, default 10)"},"search_domain_filter":{"type":"array","items":{"type":"string"},"description":"Restrict search to specific domains (max 20)"},"search_recency_filter":{"type":"string","description":"Time filter: 'hour', 'day', 'week', 'month', 'year'"},"search_language_filter":{"type":"array","items":{"type":"string"},"description":"Language filter (ISO 639-1 codes)"},"search_after_date_filter":{"type":"string","description":"Only results after this date (MM/DD/YYYY)"},"search_before_date_filter":{"type":"string","description":"Only results before this date (MM/DD/YYYY)"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"query":"artificial intelligence","max_results":10,"search_recency_filter":"month"},"response":{"_truncated":true,"_originalSize":19719}},"exampleRequest":{"query":"artificial intelligence","max_results":10,"search_recency_filter":"month"},"tags":["search","ai-search","web-grounding","sonar","ai"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":true,"priceHint":"$0.006","priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":7,"rating":{"score":"0.82","successRate":"0.81","reviews":7,"stars":"4.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$0.006 (dynamic)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TF0ZO2852mnbfyIYOOJpT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Perplexity","brandSlug":"perplexity","brandBaseUrl":"https://perplexity.ai","brandDocsUrl":"https://docs.perplexity.ai","whatItDoes":"Performs real-time AI-powered web search using Perplexity's Sonar engine, returning grounded results with optional filters for recency, domain, language, and date range.","exampleAgentPrompt":"Search the web for the latest developments on OpenAI's o3 model — limit it to results from the past week, up to 15 results, and only from reputable tech news domains like techcrunch.com and theverge.com.","exampleUseCases":null,"resultDescription":"Returns a set of web search results grounded in real-time data, including ranked snippets and source references, filtered by any specified recency, domain, language, or date constraints.","failureModes":["Empty or vague query returns low-quality or irrelevant results","Invalid country code (non ISO 3166-1 alpha-2) causes a validation error","max_results outside 1–20 range causes a parameter error","Invalid date format (not MM/DD/YYYY) causes a parsing error","Overly restrictive domain or date filters return zero results","Network or upstream Perplexity API unavailability returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs real-time, web-grounded information — especially for recent events, news, or facts that a static model would not know. Prefer it over embeddings or chat endpoints when the goal is retrieval rather than generation. The domain, recency, language, and date filters make it ideal for targeted research tasks where freshness and source control matter.","instructions":null,"reviewSummary":"Web search capability delivers accurate, well-ranked results with titles, URLs, snippets, and dates across multilingual queries including Japanese and French, with recency and date-range filters functioning as documented. Performance is strong on niche and structured recall tasks, returning high-signal sources quickly at roughly $0.006 per call. One recorded 502 upstream failure resulted in a charge with no results delivered, and domain filtering for Reddit/LinkedIn returns empty arrays — dropping the filter surfaces those results naturally.","reviewSummaryHighlights":["Accurate multilingual results across English, Japanese, and French queries","Recency and date-range filters work as documented","High-signal sources surfaced efficiently at ~$0.006 per call"],"reviewSummaryConcerns":["Occasional 502 upstream failures can charge the caller with no results returned","search_domain_filter for Reddit/LinkedIn returns empty results — use unfiltered queries instead"],"reviewSummaryGeneratedAt":"2026-08-19T16:15:15.459Z","activationCount":27,"lastUsedAt":"2026-08-19T15:53:16.075Z","lastSuccessfullyRanAt":"2026-08-19T15:53:16.075Z","lastHealthCheckAt":"2026-10-10T00:43:46.559Z","isFirstParty":false,"canonicalSlug":"perplexity-search-79dc1cbe"}