query | string | yes | - | The natural-language search query. |
max_results | number | no | 10 | Maximum number of results to return. · Range: 1 – 20 |
max_tokens | number | no | 1000000 | Maximum tokens extracted across all results. · Range: 1 – 1000000 |
max_tokens_per_page | number | no | 4096 | Max tokens extracted per individual result page. · Range: 1 – 16384 |
multi_query_mode | boolean | no | false | Let Perplexity expand the query into multiple parallel searches for broader coverage. |
search_domain_filter | string | no | - | Comma-separated domains. Prefix with ’-’ to exclude. Max 20. |
search_language_filter | string | no | - | Comma-separated ISO 639-1 codes (2 letters). Max 10. |
search_recency_filter | enum | no | "none" | Relative time filter (hour | day | week | month | year). · Allowed: none, hour, day, week, month, year |
search_after_date_filter | string | no | - | Use YYYY-MM-DD. Only include sources after this date. |
search_before_date_filter | string | no | - | Use YYYY-MM-DD. Only include sources before this date. |
last_updated_after_filter | string | no | - | Use YYYY-MM-DD. Only include sources after this date. |
last_updated_before_filter | string | no | - | Use YYYY-MM-DD. Only include sources before this date. |
country | string | no | - | Two-letter ISO 3166-1 code (US, GB, etc.) for biasing results to a country. |
display_server_time | boolean | no | false | Include the server-time timestamp in the response payload. |