Perplexity

Perplexity-Search

post
Header parameters
AuthorizationstringRequiredExample: sk-VPfVMqoBRjtlW
Body
modelstringRequiredExample: perplexity-search
querystringRequired

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

Example: latest AI developments 2024
max_resultsinteger · min: 1 · max: 20Optional

The maximum number of search results to return.

Default: 10Example: 10
search_domain_filterstring[] · max: 20Optional

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

max_tokens_per_pageintegerOptional

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.

Default: 1024Example: 1024
countrystringOptional

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

Example: US
search_recency_filterstring · enumOptional

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.

Example: weekPossible values:
search_after_datestringOptional

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

Example: 10/15/2025
search_before_datestringOptional

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

Example: 10/16/2025
Responses
200Success
application/json
post
/v1/perplexity
200Success

Last updated