Sonar Pro

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar-pro \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "sonar-pro",
  "messages": [
    {
      "role": "user",
      "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-2026"
    }
  ]
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar-pro \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-2026",
      "role": "user"
    }
  ],
  "model": "sonar-pro"
}
'

import requests

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

payload = {
    "messages": [
        {
            "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-2026",
            "role": "user"
        }
    ],
    "model": "sonar-pro"
}
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: 'Compare the economic policies of the US and EU regarding AI regulation in 2025-2026',
        role: 'user'
      }
    ],
    model: 'sonar-pro'
  })
};

fetch('https://api.aisa.one/apis/v1/perplexity/sonar-pro', 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-pro",
  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' => 'Compare the economic policies of the US and EU regarding AI regulation in 2025-2026',
                'role' => 'user'
        ]
    ],
    'model' => 'sonar-pro'
  ]),
  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-pro"

	payload := strings.NewReader("{\n  \"messages\": [\n    {\n      \"content\": \"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-pro\"\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-pro")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"messages\": [\n    {\n      \"content\": \"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-pro\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/perplexity/sonar-pro")

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\": \"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-pro\"\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-pro

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar-pro \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "sonar-pro",
  "messages": [
    {
      "role": "user",
      "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-2026"
    }
  ]
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar-pro \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-2026",
      "role": "user"
    }
  ],
  "model": "sonar-pro"
}
'

import requests

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

payload = {
    "messages": [
        {
            "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-2026",
            "role": "user"
        }
    ],
    "model": "sonar-pro"
}
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: 'Compare the economic policies of the US and EU regarding AI regulation in 2025-2026',
        role: 'user'
      }
    ],
    model: 'sonar-pro'
  })
};

fetch('https://api.aisa.one/apis/v1/perplexity/sonar-pro', 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-pro",
  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' => 'Compare the economic policies of the US and EU regarding AI regulation in 2025-2026',
                'role' => 'user'
        ]
    ],
    'model' => 'sonar-pro'
  ]),
  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-pro"

	payload := strings.NewReader("{\n  \"messages\": [\n    {\n      \"content\": \"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-pro\"\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-pro")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"messages\": [\n    {\n      \"content\": \"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-pro\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/perplexity/sonar-pro")

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\": \"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar-pro\"\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
  }
}

Ask a question that needs more than one search pass and get a written answer with citations. Same request and response shape as post_perplexity_sonar — model (required, sonar-pro) and messages in, choices[0].message.content, citations, search_results[] and usage out. Measured at about 10 seconds, roughly three times sonar, at the same flat per-request rate. Use it for questions with several parts or follow-ups. For a single lookup sonar answers in a third of the time at the same price; when the difficulty is reasoning rather than retrieval, post_perplexity_sonar_reasoning_pro shows its working.

Example

curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-pro" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar-pro",
    "messages": [
      {"role": "user", "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-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_pro",
      "arguments": {
        "model": "sonar-pro",
        "messages": [
          {
            "role": "user",
            "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-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-pro.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-pro
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/perplexity/sonar-pro
Runtime facts: fb88776539957bfc86000a34a6c0da10e10cbeecf9d65c8ae1d78688c170faac

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

{
  "operationId": "post_perplexity_sonar_pro",
  "method": "POST",
  "path": "/apis/v1/perplexity/sonar-pro",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "messages": [
            {
              "content": "Compare the economic policies of the US and EU regarding AI regulation in 2025-2026",
              "role": "user"
            }
          ],
          "model": "sonar-pro"
        },
        "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.11273,
    "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.11273 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.11273
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

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