AI & Machine Learning Bearer Token

Perplexity AI REST API

Conversational AI search with real-time web citations

Perplexity AI is a conversational search engine API that provides AI-powered answers with real-time web citations and sources. Developers integrate Perplexity to build applications that require up-to-date information, fact-checked responses, and transparent source attribution. The API supports streaming responses, multiple AI models, and custom search domains for specialized use cases.

Base URL https://api.perplexity.ai

API Endpoints

Method	Endpoint	Description
POST	`/chat/completions`	Generate AI responses with web search integration and citations
POST	`/chat/completions/stream`	Stream AI responses in real-time with progressive citations
GET	`/models`	List available AI models including sonar, codellama, and mixtral variants
POST	`/search`	Perform direct web search with AI-powered result summarization
POST	`/search/focus`	Execute focused searches on specific domains like academic, news, or reddit
GET	`/usage`	Retrieve API usage statistics and token consumption data
POST	`/citations/verify`	Verify and validate citation accuracy for generated responses
GET	`/models/{model_id}`	Get detailed information about a specific AI model
POST	`/search/domains`	Configure custom domain restrictions for search results
GET	`/account/limits`	Check current rate limits and quota availability
POST	`/embeddings`	Generate vector embeddings for text using Perplexity models
DELETE	`/cache/{cache_id}`	Clear cached search results and responses
POST	`/collections`	Create collections of related searches for context continuity
GET	`/collections/{collection_id}/history`	Retrieve conversation history from a specific collection

Code Examples

curl -X POST https://api.perplexity.ai/chat/completions \
  -H "Authorization: Bearer pplx-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar-small-chat",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "What are the latest developments in quantum computing?"
      }
    ],
    "max_tokens": 500,
    "temperature": 0.7,
    "return_citations": true
  }'

const response = await fetch('https://api.perplexity.ai/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pplx-your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'sonar-small-chat',
    messages: [
      {
        role: 'system',
        content: 'You are a helpful assistant.'
      },
      {
        role: 'user',
        content: 'What are the latest developments in quantum computing?'
      }
    ],
    max_tokens: 500,
    temperature: 0.7,
    return_citations: true
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);
console.log('Citations:', data.citations);

import requests

url = 'https://api.perplexity.ai/chat/completions'
headers = {
    'Authorization': 'Bearer pplx-your-api-key',
    'Content-Type': 'application/json'
}
payload = {
    'model': 'sonar-small-chat',
    'messages': [
        {
            'role': 'system',
            'content': 'You are a helpful assistant.'
        },
        {
            'role': 'user',
            'content': 'What are the latest developments in quantum computing?'
        }
    ],
    'max_tokens': 500,
    'temperature': 0.7,
    'return_citations': True
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(data['choices'][0]['message']['content'])
print('Citations:', data.get('citations', []))

Connect Perplexity AI to AI

Deploy a Perplexity AI MCP server on IOX Cloud and connect it to Claude, ChatGPT, Cursor, or any AI client. Your AI assistant gets direct access to Perplexity AI through these tools:

perplexity_search Search the web with AI-powered summarization and get cited answers to queries in real-time

perplexity_focused_search Perform domain-specific searches (academic, news, reddit, youtube) with contextual AI responses

perplexity_verify_citations Validate the accuracy and relevance of citations in AI-generated responses

perplexity_stream_response Generate streaming AI responses for real-time conversational interfaces with progressive citations

perplexity_create_collection Create and manage conversation collections for maintaining context across multiple queries

Deploy in 60 seconds

Describe what you need, AI generates the code, and IOX deploys it globally.

Deploy Perplexity AI MCP Server →

Perplexity AI REST API

API Endpoints

Code Examples

Connect Perplexity AI to AI

Deploy in 60 seconds

Related APIs