Explore Plans
Back
Perplexity

Ask Perplexity

This query returns a conversational, web-grounded answer from Perplexity, along with the web sources it cited, for the question you provide.

Developer info

API endpoint slug
perplexity.ask_perplexity
Runtime method
performQuery("perplexity.ask_perplexity"}

Query fields

Question Text input > Long text

Label
Question
Helper text
What you want to ask Perplexity. Perplexity answers in plain language and searches the web in real time to ground its answer.
Slug
question
Required
true
Can have default value
true

Model Dropdown list

Label
Model
Helper text
Which Perplexity model answers your question. Sonar is fast and economical; Sonar Pro gives more thorough, higher-quality answers; Sonar Reasoning Pro adds step-by-step reasoning.
Slug
model
Required
true
Can have default value
true

System prompt Text input

Label
System prompt
Helper text
Optional instructions that shape how Perplexity answers — tone, format, or persona (e.g. "Answer in one short paragraph"). Leave blank for a default helpful-assistant answer.
Slug
system_prompt
Required
false
Can have default value
true

Search recency Dropdown list

Label
Search recency
Helper text
Optionally restrict the web search behind the answer to recent results. Leave blank to search across all time.
Slug
search_recency
Required
false
Can have default value
true

Max tokens Text input > Other

Label
Max tokens
Helper text
Optionally cap the length of the answer, measured in tokens. Leave blank to let Perplexity choose.
Slug
max_tokens
Required
false
Can have default value
true

Ingredients

Answer The conversational, web-grounded answer Perplexity generated for your question.

Slug
answer
Filter
Perplexity.askPerplexity.Answer
Type
String
Example
The James Webb Space Telescope launched on December 25, 2021.

Sources A newline-separated list of the web source URLs Perplexity cited for the answer.

Slug
sources
Filter
Perplexity.askPerplexity.Sources
Type
String
Example
https://www.nasa.gov/webb https://en.wikipedia.org/wiki/James_Webb_Space_Telescope

Top source title The title of the top web source Perplexity cited. Empty when the answer cited no web results.

Slug
top_source_title
Filter
Perplexity.askPerplexity.TopSourceTitle
Type
String
Example
James Webb Space Telescope - NASA

Top source url The URL of the top web source Perplexity cited. Empty when the answer cited no web results.

Slug
top_source_url
Filter
Perplexity.askPerplexity.TopSourceUrl
Type
Web URL
Example
https://www.nasa.gov/webb

Model used The Perplexity model that produced the answer.

Slug
model_used
Filter
Perplexity.askPerplexity.ModelUsed
Type
String
Example
sonar-pro

Prompt tokens The number of tokens in the prompt sent to Perplexity, as a string.

Slug
prompt_tokens
Filter
Perplexity.askPerplexity.PromptTokens
Type
String
Example
12

Completion tokens The number of tokens in the generated answer, as a string.

Slug
completion_tokens
Filter
Perplexity.askPerplexity.CompletionTokens
Type
String
Example
48

Total tokens The total number of tokens used for the request (prompt plus completion), as a string.

Slug
total_tokens
Filter
Perplexity.askPerplexity.TotalTokens
Type
String
Example
60

Response Perplexity's unique identifier for this response.

Slug
response_id
Filter
Perplexity.askPerplexity.ResponseId
Type
String
Example
3c90c3cc-0d44-4b50-8888-8dd25736052a

Created at When Perplexity generated the answer.

Slug
created_at
Filter
Perplexity.askPerplexity.CreatedAt
Type
Date with time (ISO8601)
Example
2020-07-08T04:17:06+05:00

Applets using this Query