Search
perplexity.search
ActionAI & modelsconnection required
Calls the Perplexity API with the connection's credentials.
Search the web through Perplexity's Search API and return the ranked results with no model and no generated answer.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Perplexity
- Secret shape
- {"api_key": "…"}
- Config it needs
- base_url, default_model
- Resolved by
- config.connection_id, else node.connection_id
Configuration
8 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
query What to search for. A JSON array of up to five strings runs them as one multi-topic search. | string | Yes | — | — | perplexity sonar api pricing |
max_results How many results to return, from 1 to 20. Defaults to 10. | number | No | 10 | 1–20 | — |
max_tokens_per_page How much text to extract from each page, in tokens. Defaults to 1024. | number | No | 1024 | ≥ 1 | — |
search_mode Which corpus Perplexity searches: web (the whole web), academic (scholarly papers) or sec (SEC filings). Defaults to web. | string | No | — | one of "web", "academic", "sec" | — |
search_domain_filter Domains to restrict the search to, as a JSON array or a comma-separated list. Prefix a domain with '-' to exclude it instead. | array | No | — | array of string | ["arxiv.org","-reddit.com"] |
search_recency_filter Only use sources published within this window, counted back from now. | string | No | — | one of "hour", "day", "week", "month", "year" | — |
search_after_date_filter Only use sources published on or after this date, written as MM/DD/YYYY. | string | No | — | — | 01/01/2026 |
search_before_date_filter Only use sources published on or before this date, written as MM/DD/YYYY. | string | No | — | — | 12/31/2026 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"max_results": 10,
"max_tokens_per_page": 1024,
"query": "perplexity sonar api pricing",
"search_after_date_filter": "01/01/2026",
"search_before_date_filter": "12/31/2026",
"search_domain_filter": [
"arxiv.org",
"-reddit.com"
]
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
results The ranked results, each with a title, url, snippet, date and last_updated. | array | — |
count How many results came back. | number | — |
id Perplexity's identifier for this search. | string | — |
raw The untouched response body. | object | — |
{
"count": 0,
"id": "",
"raw": {},
"results": []
}Related Perplexity nodes
See Search run in a workflow.
In a technical demo we add the Perplexity connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.