Perplexity

The Perplexity Search API endpoint fetches response data from a results page of a Perplexity prompt. Results can be returned in raw HTML format or as a structured JSON format.

cURL

curl --request GET \
--url "https://api.scraperapi.com/structured/perplexity/search/v1?api_key=API_KEY&\
query=QUERY&output_format=OUTPUT_FORMAT&include_html=Boolean"

Python

import requests

payload = {
    'api_key': 'API_KEY',
    'query': 'QUERY',
    'output_format': 'OUTPUT_FORMAT',
    'include_html': 'Boolean' #True/False
}

r = requests.get('https://api.scraperapi.com/structured/perplexity/search/v1',params=payload)

print(r.text)

NodeJS

import fetch from 'node-fetch';

fetch(
  'https://api.scraperapi.com/structured/perplexity/search/v1?api_key=API_KEY&query=QUERY&output_format=OUTPUT_FORMAT&include_html=Boolean'
)
  .then(response => response.json()) 
  .then(data => {
    console.log(data);
  })
  .catch(error => {
    console.error(error);
  });

PHP

<?php
$url = "https://api.scraperapi.com/structured/perplexity/search/v1?api_key=API_KEY&query=QUERY&output_format=OUTPUT_FORMAT&include_html=Boolean";

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HEADER, FALSE);

$response = curl_exec($ch);
curl_close($ch);

print_r($response);

Ruby

require 'net/http'
require 'json'

params = {
  :api_key => "API_KEY",
  :query => "QUERY",
  :output_format => "OUTPUT_FORMAT",
  :include_html => "Boolean" #True/False
}

uri = URI('https://api.scraperapi.com/structured/perplexity/search/v1')
uri.query = URI.encode_www_form(params)

website_content = Net::HTTP.get(uri)
print(website_content)

Java

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Main {
    public static void main(String[] args) {
        try {
            String apiKey = "API_KEY";
            String query = "QUERY";
            String output_format = "output_format";
            String include_html = "Boolean"; // True/False

            String urlStr = "https://api.scraperapi.com/structured/perplexity/search/v1?api_key=" 
                            + apiKey + "&query=" + query + "&coutput_format=" + output_format + "&include_html=" + include_html;

            URL url = new URL(urlStr);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");

            int responseCode = conn.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
                StringBuilder response = new StringBuilder();
                String line;
                while ((line = in.readLine()) != null) {
                    response.append(line);
                }
                in.close();
                System.out.println(response.toString());
            } else {
                System.out.println("Error in API Call. Response code: " + responseCode);
            }

        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
}

Supported Parameters

Parameters	Details
API_KEY (required)	Your API Key.
QUERY (required)	The prompt to send to Perplexity.
OUTPUT_FORMAT	json returns parsed structured data (default). html returns raw HTML.
INCLUDE_HTML	Determines whether raw HTML is included in the response (this can increase the size of the response). Can be set to true or false (default).

JSON Response

{
  "query": "string",              // the submitted prompt, echoed back
  "url": "string|null",           // result/thread URL for the answer
  "model": "string|null",         // model that produced the answer (see notes)
  "answer": "string",             // the full answer, in Markdown
  "sources": [                    // citations / web results (may be empty)
    {
      "title": "string",
      "url": "string",
      "domain": "string",         // bare hostname, www. stripped
      "snippet": "string"         // may be empty when the engine gives none
    }
  ],
  "related_queries": ["string"]   // follow-up suggestions (may be empty)
}

Field Reference

Field	Type	Always present?	Notes
query	string	yes	Echoed prompt
url	string | null	yes	Result/thread URL
model	string | null	yes	Best-effort. null when not surfaced
answer	string (Markdown)	yes	The answer body
sources[]	array of object	yes (may be empty)	{ title, url, domain, snippet }
related_queries[]	array of string	yes (may be empty)	Follow-up suggestions

All fields are always present in the JSON (empty array or null rather than omitted).

Specifics

model

• Populated for Perplexity. For example turbo.

sources

• Present in the response.

• snippet

• domain is normalized to a bare hostname (www. stripped) across all engines.

related_queries

• Present in the response (may be empty).

Example

{
  "query": "where to visit in Italy",
  "url": "https://www.perplexity.ai/search/6341fc7a-b727-4a08-8e66-49cbeef35407",
  "model": "turbo",
  "answer": "Italy offers a mix of history, cuisine, and scenery. Here are the must-see regions...\n\n- **Rome** ...\n- **Florence** ...",
  "sources": [
    {
      "title": "Best Places To Visit In Italy For The First Time",
      "url": "https://earthtrekkers.com/best-places-to-visit-in-italy/",
      "domain": "earthtrekkers.com",
      "snippet": "Some destinations stand out more than the rest..."
    }
  ],
  "related_queries": [
    "Best time of year to visit Italy",
    "How many days do you need in Italy"
  ]
}

Pricing

Perplexity queries run on ScraperAPI's standard credit system.

Request Type	Credits Charged
Any Parameter	25