curl --request POST \
--url https://api.aisa.one/apis/v1/perplexity/sonar-deep-research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "sonar-deep-research",
"messages": [
{
"role": "user",
"content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026"
}
]
}
'import requests
url = "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research"
payload = {
"model": "sonar-deep-research",
"messages": [
{
"role": "user",
"content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'sonar-deep-research',
messages: [
{
role: 'user',
content: 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026'
}
]
})
};
fetch('https://api.aisa.one/apis/v1/perplexity/sonar-deep-research', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'sonar-deep-research',
'messages' => [
[
'role' => 'user',
'content' => 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research"
payload := strings.NewReader("{\n \"model\": \"sonar-deep-research\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/perplexity/sonar-deep-research")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"sonar-deep-research\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/perplexity/sonar-deep-research")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"sonar-deep-research\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"model": "<string>",
"object": "chat.completion",
"created": 123,
"choices": [
{
"index": 123,
"message": {
"role": "<string>",
"content": "<string>"
},
"finish_reason": "stop"
}
],
"citations": [
"<string>"
],
"search_results": [
{
"title": "<string>",
"url": "<string>",
"snippet": "<string>",
"date": "<string>",
"source": "<string>"
}
],
"usage": {
"prompt_tokens": 123,
"completion_tokens": 123,
"total_tokens": 123,
"search_context_size": "<string>"
}
}Sonar Deep Research
Commission a report: this endpoint runs many searches and writes a long, cited document.
curl --request POST \
--url https://api.aisa.one/apis/v1/perplexity/sonar-deep-research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "sonar-deep-research",
"messages": [
{
"role": "user",
"content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026"
}
]
}
'import requests
url = "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research"
payload = {
"model": "sonar-deep-research",
"messages": [
{
"role": "user",
"content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'sonar-deep-research',
messages: [
{
role: 'user',
content: 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026'
}
]
})
};
fetch('https://api.aisa.one/apis/v1/perplexity/sonar-deep-research', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'sonar-deep-research',
'messages' => [
[
'role' => 'user',
'content' => 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research"
payload := strings.NewReader("{\n \"model\": \"sonar-deep-research\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/perplexity/sonar-deep-research")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"sonar-deep-research\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/perplexity/sonar-deep-research")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"sonar-deep-research\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"model": "<string>",
"object": "chat.completion",
"created": 123,
"choices": [
{
"index": 123,
"message": {
"role": "<string>",
"content": "<string>"
},
"finish_reason": "stop"
}
],
"citations": [
"<string>"
],
"search_results": [
{
"title": "<string>",
"url": "<string>",
"snippet": "<string>",
"date": "<string>",
"source": "<string>"
}
],
"usage": {
"prompt_tokens": 123,
"completion_tokens": 123,
"total_tokens": 123,
"search_context_size": "<string>"
}
}model (required, sonar-deep-research) and messages in; choices[0].message.content, citations, search_results[] and usage out, where usage also reports num_search_queries and reasoning_tokens. ⚠️ Budget for the wait: a two-sentence question measured 192 seconds and returned 86 KB after 10 upstream searches — roughly 60 times slower and 10 times larger than post_perplexity_sonar, at the same flat $0.012 per request. Many clients time out well before it answers, so call it only when a report is genuinely the deliverable, and never in a loop. For anything you would read in one sitting, the other three Perplexity endpoints answer in seconds.
Example
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-deep-research",
"messages": [
{"role": "user", "content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026"}
]
}'
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The Sonar model to use.
sonar, sonar-pro, sonar-reasoning-pro, sonar-deep-research A list of messages comprising the conversation so far.
Show child attributes
Show child attributes
The maximum number of tokens to generate in the response.
Sampling temperature between 0 and 2. Lower values make output more focused and deterministic.
0 <= x <= 2Nucleus sampling parameter. The model considers tokens with top_p probability mass.
0 <= x <= 1The number of tokens to keep for top-k filtering.
0 <= x <= 2048Whether to stream the response using server-sent events.
Controls how much search context to use. Affects per-request cost.
low, medium, high Penalizes new tokens based on their existing frequency in the text so far. Positive values decrease the likelihood of repeating the same line verbatim.
0 <= x <= 2Penalizes new tokens based on whether they appear in the text so far. Positive values increase the likelihood of talking about new topics.
-2 <= x <= 2Whether to return citations and search results in the response.
Filter search results by recency.
month, week, day, hour Limit search to specific domains.
Response
Successful response with AI answer and citations
Unique identifier for the completion.
The model used for the completion.
"chat.completion"
Unix timestamp of when the completion was created.
Show child attributes
Show child attributes
List of source URLs referenced in the answer.
Detailed search results with titles, snippets, and URLs.
Show child attributes
Show child attributes
Show child attributes
Show child attributes