Skip to main content
POST
/
search
Search
curl --request POST \
  --url https://api.perplexity.ai/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "latest AI developments 2024",
  "max_results": 10,
  "search_domain_filter": [
    "science.org",
    "pnas.org",
    "cell.com"
  ],
  "max_tokens_per_page": 1024,
  "country": "US",
  "search_recency_filter": "week",
  "search_after_date": "10/15/2025",
  "search_before_date": "10/16/2025"
}
'
{
  "results": [
    {
      "title": "<string>",
      "url": "<string>",
      "snippet": "<string>",
      "date": "2025-03-20",
      "last_updated": "2025-09-19"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
query
required

The search query or queries to execute.

Example:

"latest AI developments 2024"

​
max_results
integer
default:10

The maximum number of search results to return.

Required range: 1 <= x <= 20
​
search_domain_filter
string[]

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

Maximum array length: 20
Example:
["science.org", "pnas.org", "cell.com"]
​
max_tokens_per_page
integer
default:1024

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.

Example:

1024

​
country
string

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

Example:

"US"

​
search_recency_filter
enum<string>

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.

Available options:
day,
week,
month,
year
Example:

"week"

​
search_after_date
string

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_date
string

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"

Response

200 - application/json

Successfully retrieved search results.

​
results
SearchResult · object[]
required

An array of search results.