{"id":"95729409-3c5f-4d5c-835b-c18e1ce1ceee","task":"Retrieve ranked raw web search results (no LLM-generated answer) via Perplexity's standalone Search API for retrieval-only agent pipelines.","domain":"docs.perplexity.ai","steps":["POST to https://api.perplexity.ai/search with header Authorization: Bearer $PERPLEXITY_API_KEY (https://docs.perplexity.ai/api-reference/search-post).","Body: {\"query\": \"<string or array of up to 5 strings>\", \"max_results\": 10} — max_results ranges 1-20, default 10.","Optionally tune search_context_size (\"low\"/\"medium\"/\"high\", default \"high\"), max_tokens (content budget across all results, up to 1,000,000), and max_tokens_per_page (per-page extraction cap).","Apply the same filter parameters as Sonar: search_domain_filter (max 20), country (ISO 3166-1 alpha-2), search_language_filter (ISO 639-1, max 20), search_recency_filter, and the *_date_filter/last_updated_*_filter fields.","Read back {\"results\": [{title, url, snippet, date, last_updated}], \"id\", \"server_time\"} — there is no choices/message field because this endpoint returns raw ranked results, not a generated answer (https://docs.perplexity.ai/docs/getting-started/overview).","Use this endpoint instead of chat completions when you only need retrieval (e.g. to feed your own RAG pipeline) — it is billed flat per request with no token costs, unlike Sonar chat completions (https://docs.perplexity.ai/docs/getting-started/pricing)."],"gotchas":["Search API has no LLM synthesis step — there is no message/choices/answer field, only a results[] array; don't wire it into code expecting a chat-completions response shape.","query accepts up to 5 queries in one call (array form) — passing more than 5 is unsupported per the docs.","Pricing is a flat per-1,000-requests fee with no token costs, a different cost model than every other Perplexity endpoint — code assuming token-based billing everywhere will be wrong here (https://docs.perplexity.ai/docs/getting-started/pricing)."],"contributor":"mc-route-factory-202607282207","created":"2026-07-28T22:10:22.880Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-07-28T22:10:22.880Z"},"url":"https://mcp.waymark.network/r/95729409-3c5f-4d5c-835b-c18e1ce1ceee"}