Sonar Deep Research

Reference example

# Fixed reference example. Playground inputs do not update this sample.
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"
    }
  ]
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar-deep-research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026",
      "role": "user"
    }
  ],
  "model": "sonar-deep-research"
}
'

import requests

url = "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research"

payload = {
    "messages": [
        {
            "content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026",
            "role": "user"
        }
    ],
    "model": "sonar-deep-research"
}
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({
    messages: [
      {
        content: 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026',
        role: 'user'
      }
    ],
    model: 'sonar-deep-research'
  })
};

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([
    'messages' => [
        [
                'content' => 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026',
                'role' => 'user'
        ]
    ],
    'model' => 'sonar-deep-research'
  ]),
  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  \"messages\": [\n    {\n      \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-deep-research\"\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  \"messages\": [\n    {\n      \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-deep-research\"\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  \"messages\": [\n    {\n      \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-deep-research\"\n}"

response = http.request(request)
puts response.read_body

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 123,
      "message": {
        "content": "<string>",
        "role": "<string>"
      }
    }
  ],
  "citations": [
    "<string>"
  ],
  "created": 123,
  "id": "<string>",
  "model": "<string>",
  "object": "chat.completion",
  "search_results": [
    {
      "date": "<string>",
      "snippet": "<string>",
      "source": "<string>",
      "title": "<string>",
      "url": "<string>"
    }
  ],
  "usage": {
    "completion_tokens": 123,
    "prompt_tokens": 123,
    "search_context_size": "<string>",
    "total_tokens": 123
  }
}

POST

https://api.aisa.one

apis

perplexity

sonar-deep-research

Reference example

# Fixed reference example. Playground inputs do not update this sample.
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"
    }
  ]
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar-deep-research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026",
      "role": "user"
    }
  ],
  "model": "sonar-deep-research"
}
'

import requests

url = "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research"

payload = {
    "messages": [
        {
            "content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026",
            "role": "user"
        }
    ],
    "model": "sonar-deep-research"
}
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({
    messages: [
      {
        content: 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026',
        role: 'user'
      }
    ],
    model: 'sonar-deep-research'
  })
};

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([
    'messages' => [
        [
                'content' => 'Write a comprehensive analysis of the global semiconductor supply chain risks in 2026',
                'role' => 'user'
        ]
    ],
    'model' => 'sonar-deep-research'
  ]),
  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  \"messages\": [\n    {\n      \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-deep-research\"\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  \"messages\": [\n    {\n      \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-deep-research\"\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  \"messages\": [\n    {\n      \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-deep-research\"\n}"

response = http.request(request)
puts response.read_body

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 123,
      "message": {
        "content": "<string>",
        "role": "<string>"
      }
    }
  ],
  "citations": [
    "<string>"
  ],
  "created": 123,
  "id": "<string>",
  "model": "<string>",
  "object": "chat.completion",
  "search_results": [
    {
      "date": "<string>",
      "snippet": "<string>",
      "source": "<string>",
      "title": "<string>",
      "url": "<string>"
    }
  ],
  "usage": {
    "completion_tokens": 123,
    "prompt_tokens": 123,
    "search_context_size": "<string>",
    "total_tokens": 123
  }
}

Commission a report: this endpoint runs many searches and writes a long, cited document. 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 per-request rate. 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"}
    ]
  }'

// Copy this whole block into Claude Code, Codex, Cursor or any coding agent.
// It carries everything needed to connect, authorize and run this example —
// no key to paste, one click of Allow in the browser.
{
  "calls": [
    {
      "call_id": "1",
      "tool": "post_perplexity_sonar_deep_research",
      "arguments": {
        "model": "sonar-deep-research",
        "messages": [
          {
            "role": "user",
            "content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026"
          }
        ]
      }
    }
  ]
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `batch_quote` tool with the JSON above.
//   name       aisa
//   endpoint   https://mcp.aisa.one/mcp
//   transport  streamable-http
//   auth       OAuth. The server publishes RFC 9728 metadata, so open a
//              browser and the user clicks Allow once — nothing to paste.
//              If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
//   Codex        codex mcp add aisa --url https://mcp.aisa.one/mcp
//   Claude Code  claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
//   Cursor / VS Code   a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server reaches https://mcp.aisa.one/servers worth of APIs through a few meta
// tools: search, list_categories, get_details, batch_quote, batch_use.
// search, get_details and batch_quote are free; batch_use is billed per
// call. This operation's full contract — every argument, the response
// shape, the price and the pitfalls — is at
//   https://aisa.one/docs/api-reference/perplexity/post_perplexity-sonar-deep-research.md
// Show me the quoted cost. Once I approve, run the same calls with
// batch_use and show me the result.

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

Method and path: POST /apis/v1/perplexity/sonar-deep-research
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/perplexity/sonar-deep-research
Runtime facts: fb88776539957bfc86000a34a6c0da10e10cbeecf9d65c8ae1d78688c170faac

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_perplexity_sonar_deep_research",
  "method": "POST",
  "path": "/apis/v1/perplexity/sonar-deep-research",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "messages": [
            {
              "content": "Write a comprehensive analysis of the global semiconductor supply chain risks in 2026",
              "role": "user"
            }
          ],
          "model": "sonar-deep-research"
        },
        "schema": {
          "properties": {
            "frequency_penalty": {
              "default": 1,
              "description": "Penalizes new tokens based on their existing frequency in the text so far. Positive values decrease the likelihood of repeating the same line verbatim.",
              "maximum": 2,
              "minimum": 0,
              "type": "number"
            },
            "max_tokens": {
              "description": "The maximum number of tokens to generate in the response.",
              "type": "integer"
            },
            "messages": {
              "description": "A list of messages comprising the conversation so far.",
              "items": {
                "properties": {
                  "content": {
                    "description": "The content of the message.",
                    "type": "string"
                  },
                  "role": {
                    "description": "The role of the message author.",
                    "enum": [
                      "system",
                      "user",
                      "assistant"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "role",
                  "content"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "model": {
              "description": "The Sonar model to use.",
              "enum": [
                "sonar",
                "sonar-pro",
                "sonar-reasoning-pro",
                "sonar-deep-research"
              ],
              "type": "string"
            },
            "presence_penalty": {
              "default": 0,
              "description": "Penalizes new tokens based on whether they appear in the text so far. Positive values increase the likelihood of talking about new topics.",
              "maximum": 2,
              "minimum": -2,
              "type": "number"
            },
            "return_citations": {
              "default": true,
              "description": "Whether to return citations and search results in the response.",
              "type": "boolean"
            },
            "search_context": {
              "default": "low",
              "description": "Controls how much search context to use. Affects per-request cost.",
              "enum": [
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            "search_domain_filter": {
              "description": "Limit search to specific domains.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "search_recency_filter": {
              "description": "Filter search results by recency.",
              "enum": [
                "month",
                "week",
                "day",
                "hour"
              ],
              "type": "string"
            },
            "stream": {
              "default": false,
              "description": "Whether to stream the response using server-sent events.",
              "type": "boolean"
            },
            "temperature": {
              "default": 0.2,
              "description": "Sampling temperature between 0 and 2. Lower values make output more focused and deterministic.",
              "maximum": 2,
              "minimum": 0,
              "type": "number"
            },
            "top_k": {
              "default": 0,
              "description": "The number of tokens to keep for top-k filtering.",
              "maximum": 2048,
              "minimum": 0,
              "type": "integer"
            },
            "top_p": {
              "default": 0.9,
              "description": "Nucleus sampling parameter. The model considers tokens with top_p probability mass.",
              "maximum": 1,
              "minimum": 0,
              "type": "number"
            }
          },
          "required": [
            "model",
            "messages"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_usd",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.23932,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $0.23932 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.23932
Cost contract: response_usd
Published reference multiplier: 1.0
Settlement evidence source: response_body

Authorizations

Authorization

string

header

required

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

Body

application/json

messages

object[]

required

A list of messages comprising the conversation so far.

Show child attributes

model

enum<string>

required

The Sonar model to use.

Available options:

sonar,

sonar-pro,

sonar-reasoning-pro,

sonar-deep-research

frequency_penalty

number

default:1

Penalizes new tokens based on their existing frequency in the text so far. Positive values decrease the likelihood of repeating the same line verbatim.

Required range: 0 <= x <= 2

max_tokens

integer

The maximum number of tokens to generate in the response.

presence_penalty

number

default:0

Penalizes new tokens based on whether they appear in the text so far. Positive values increase the likelihood of talking about new topics.

Required range: -2 <= x <= 2

return_citations

boolean

default:true

Whether to return citations and search results in the response.

search_context

enum<string>

default:low

Controls how much search context to use. Affects per-request cost.

Available options:

low,

medium,

high

search_domain_filter

string[]

Limit search to specific domains.

search_recency_filter

enum<string>

Filter search results by recency.

Available options:

month,

week,

day,

hour

stream

boolean

default:false

Whether to stream the response using server-sent events.

temperature

number

default:0.2

Sampling temperature between 0 and 2. Lower values make output more focused and deterministic.

Required range: 0 <= x <= 2

top_k

integer

default:0

The number of tokens to keep for top-k filtering.

Required range: 0 <= x <= 2048

top_p

number

default:0.9

Nucleus sampling parameter. The model considers tokens with top_p probability mass.

Required range: 0 <= x <= 1

Response

Successful response with AI answer and citations

choices

object[]

Show child attributes

citations

string[]

List of source URLs referenced in the answer.

created

integer

Unix timestamp of when the completion was created.

string

Unique identifier for the completion.

model

string

The model used for the completion.

object

string

Example:

"chat.completion"

search_results

object[]

Detailed search results with titles, snippets, and URLs.

Show child attributes

usage

object

Show child attributes

Overview

Models

Search & Research

Finance & Crypto

CoinGecko

Duffel Flights

DataForSEO

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Sonar Deep Research

Example

Request contract

Cost and request rules

Authorizations

Body

Response

​Example

​Request contract

​Cost and request rules

Authorizations

Body

Response

Example

Request contract

Cost and request rules