Perplexity

Learn how to send prompts to Perplexity and get structured responses using the Web Scraper API. Find out more about its request parameters and structured output.

The perplexity source lets you send prompts and capture complete responses directly from Perplexity. It returns both the generated text and relevant metadata in a structured format, along with a Markdown version of the result.

Request samples

The code examples below illustrate how to send prompts to Perplexity and retrieve parsed responses.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "perplexity",
        "prompt": "top 3 smartphones in 2025, compare pricing across US marketplaces",
        "geo_location": "United States",
        "parse": true
    }'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'perplexity',
    'prompt': 'top 3 smartphones in 2025, compare pricing across US marketplaces',
    'geo_location': 'United States',
    'parse': True
}

# Get a response.
response = requests.post(
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload
)

# Print prettified response to stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "perplexity",
    prompt: "top 3 smartphones in 2025, compare pricing across US marketplaces",
    geo_location: "United States",
    parse: true
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

https://realtime.oxylabs.io/v1/queries?source=perplexity&prompt=top%203%20smartphones%20in%202025%2C%20compare%20pricing%20across%20US%20marketplaces&geo_location=United%20States&parse=true&access_token=12345abcde

<?php

$params = array(
    'source' => 'perplexity',
    'prompt' => 'top 3 smartphones in 2025, compare pricing across US marketplaces',
    'geo_location' => 'United States',
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");


$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":       "perplexity",
		"prompt":       "top 3 smartphones in 2025, compare pricing across US marketplaces",
		"geo_location": "United States",
		"parse":        true,
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := io.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new
            {
                source = "perplexity",
                prompt = "top 3 smartphones in 2025, compare pricing across US marketplaces",
                geo_location = "United States",
                parse = true
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "perplexity");
        jsonObject.put("prompt", "top 3 smartphones in 2025, compare pricing across US marketplaces");
        jsonObject.put("geo_location", "United States");
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

Our examples use the Realtime (synchronous) integration method. To use Proxy Endpoint or Push-Pull (asynchronous), refer to the integration methods section.

By default, all requests to Perplexity use JavaScript rendering. Make sure to set a sufficient timeout (e.g. 180s) when using the Realtime integration method.

Request parameter values

Generic

Basic setup and configuration parameters for retrieving Perplexity responses.

Parameter

Description

Default Value

source

Sets the scraper.

perplexity

prompt

The prompt or question to submit to Perplexity.

parse

Returns parsed data when set to true.

false

geo_location

Specify a country to send the prompt from. More info.

callback_url

URL to your callback endpoint. More info.

- mandatory parameter

Structured data

Web Scraper API returns either an HTML document or a JSON object of Perplexity's output, which contains structured data from the results page.

perplexity structured output

{
  "results": [
    {
      "content": {
        "url": "https://www.perplexity.ai/search/top-3-smartphones-in-2025-comp-wvA0dso7TgW3NpgF8Jd8tg",
        "model": "turbo",
        "top_images": [
          {
            "url": "https://d2u1z1lopyfwlx.cloudfront.net/thumbnails/cca0fd5c-8a96-543c-89ff-3191b4be9c42/57288799-40bc-5d1f-90fe-b936b0a65cd1.jpg",
            "title": "Top Smartphones of 2025 with AI-Driven Features"
          },
          {
            "url": "https://d2u1z1lopyfwlx.cloudfront.net/thumbnails/2cc6543a-e4ef-594b-801f-c5b60308c33a/aec8f940-3469-5597-816f-0dd903b3407c.jpg",
            "title": "The best phone 2025: top smartphones in the US right now ..."
          },
          {
            "url": "https://d2u1z1lopyfwlx.cloudfront.net/thumbnails/26dedbf8-baca-5d1f-ac97-bd70b76c61a3/aec8f940-3469-5597-816f-0dd903b3407c.jpg",
            "title": "Best phones 2025 tested \u2014 Our top picks | Tom's Guide"
          },
          {
            "url": "https://d2u1z1lopyfwlx.cloudfront.net/thumbnails/0a3be7b1-a63d-5c96-b3f5-10b3ab84249c/6a4747ad-0c64-581e-8c1d-a7d907f27628.jpg",
            "title": "Best phones to buy in 2025 reviewed and ranked | Stuff"
          }
        ],
        "top_sources": [
          {
            "url": "https://www.youtube.com/watch?v=EYMe2jy-urg",
            "title": "Top 5 BEST Smartphones of 2025\u2026 So Far - YouTube",
            "source": "youtube"
          },
          {
            "url": "https://www.zdnet.com/article/best-phone/",
            "title": "The best phones to buy in 2025 - ZDNET",
            "source": "ZDNET"
          },
          {
            "url": "https://www.tomsguide.com/best-picks/best-phones",
            "title": "Best phones 2025 tested \u2014 Our top picks | Tom's Guide",
            "source": "Tom's Guide"
          },
          {
            "url": "https://www.wired.com/story/best-cheap-phones/",
            "title": "8 Best Cheap Phones (2025), Tested and Reviewed - WIRED",
            "source": "WIRED"
          }
        ],
        "prompt_query": "top 3 smartphones in 2025, compare pricing across US marketplaces",
        "answer_results": [
          "The top 3 smartphones in 2025 based on expert reviews and market consensus are:",
          {
            "list": [
              [
                [
                  [
                    "Samsung Galaxy S25 Ultra"
                  ]
                ]
              ],
              [
                [
                  [
                    "Apple iPhone 16 Pro Max"
                  ]
                ]
              ],
              [
                [
                  [
                    "Google Pixel 9 Pro XL"
                  ],
                  " (or alternatively the Pixel 9a as a value option)"
                ]
              ]
            ]
          },
          "Pricing Comparison Across US Marketplaces (Approximate MSRP & Market Prices):",
          {
            "table": [
              {
                "table_columns": [
                  [
                    "Smartphone Model"
                  ],
                  [
                    "MSRP (Official)"
                  ],
                  [
                    "Amazon Price (2025)"
                  ],
                  [
                    "T-Mobile Price (2025)"
                  ],
                  [
                    "Notes"
                  ]
                ]
              },
              {
                "table_rows": [
                  [
                    [
                      "Samsung Galaxy S25 Ultra"
                    ],
                    [
                      "$1,300"
                    ],
                    [
                      "Around $949.50 (256GB)"
                    ],
                    [
                      "Around $830 - $1,000"
                    ],
                    [
                      "Prices vary by storage, with deals around $950 for 256GB variants; offers S Pen and premium camera features[2][11][12]"
                    ]
                  ],
                  [
                    [
                      "Apple iPhone 16 Pro Max"
                    ],
                    [
                      "$1,200"
                    ],
                    [
                      "Around $1,200"
                    ],
                    [
                      "$830 (iPhone 16 base)"
                    ],
                    [
                      "Pro Max model typically $1,200 MSRP; iPhone 16 base model available around $830 at carriers[2][10]"
                    ]
                  ],
                  [
                    [
                      "Google Pixel 9 Pro XL"
                    ],
                    [
                      "$900"
                    ],
                    [
                      "Not specifically listed"
                    ],
                    [
                      "N/A"
                    ],
                    [
                      "MSRP $900; Pixel 9a variant offers strong value under $500[2][4][10]"
                    ]
                  ]
                ]
              }
            ]
          },
          "Notes on these smartphones:",
          {
            "list": [
              [
                "Samsung Galaxy S25 Ultra",
                " is considered the best overall phone with a large 6.9\" display, powerful Snapdragon 8 Elite processor, 5,000mAh battery, versatile cameras including 200MP sensor, and built-in S Pen productivity features. It commands a premium price but can be found with discounts below MSRP on platforms like Amazon and T-Mobile[2][12]."
              ],
              [
                "Apple iPhone 16 Pro Max",
                " stands as the best iPhone with Apple's A18 Pro Bionic chip, a similarly large 6.9\" screen, and up to 1TB storage, priced around $1,200 MSRP. Carrier deals can sometimes bring the effective cost lower for the base iPhone 16 (not Pro Max)[2][10]."
              ],
              [
                "Google Pixel 9 Pro XL",
                " offers a solid camera and software experience with Google\u2019s Tensor G4 chip at a lower price point (~$900). For those seeking excellent value, the Pixel 9a offers impressive cameras and performance under $500 but is not a flagship competitor[2][4]."
              ]
            ]
          },
          "Marketplaces Overview:",
          {
            "list": [
              [
                [
                  [
                    "Amazon"
                  ],
                  " typically offers slightly discounted flagship prices\u2014Samsung Galaxy S25 Ultra (256GB) found near $949.50, OnePlus 13 and other flagships similarly discounted[11][12]."
                ]
              ],
              [
                [
                  [
                    "Carrier stores like T-Mobile"
                  ],
                  " sometimes provide financing and promotional prices\u2014iPhone 16 starting near $830 with plans, Samsung Galaxy S25 varies but can approach MSRP or lower under contracts[10][11]."
                ]
              ],
              [
                "Other marketplaces (Best Buy, Walmart) generally align with Amazon and carrier pricing but may vary with bundles and seasonal promotions."
              ]
            ]
          },
          "In summary, the premium flagship tier in 2025 centers around the Samsung Galaxy S25 Ultra and Apple iPhone 16 Pro Max, with Google\u2019s Pixel 9 Pro XL key as a powerful, slightly more affordable flagship alternative. Pricing varies but flagship devices routinely range from $900 to $1,300 in the US market, with discounts commonly available through Amazon and carriers[2][10][11][12].",
          {
            "enumerated_references": [
              {
                "num": 1,
                "url": "https://www.youtube.com/watch?v=EYMe2jy-urg"
              },
              {
                "num": 2,
                "url": "https://www.zdnet.com/article/best-phone/"
              },
              {
                "num": 3,
                "url": "https://www.tomsguide.com/best-picks/best-phones"
              },
              {
                "num": 4,
                "url": "https://www.wired.com/story/best-cheap-phones/"
              },
              {
                "num": 5,
                "url": "https://www.techradar.com/news/best-phone"
              },
              {
                "num": 6,
                "url": "https://www.counterpointresearch.com/insight/top-10-bestselling-smartphones-q1-2025/"
              },
              {
                "num": 7,
                "url": "https://uptradeit.com/blog/what-iphones-will-stop-working"
              },
              {
                "num": 8,
                "url": "https://www.stuff.tv/features/best-phone/"
              },
              {
                "num": 9,
                "url": "https://www.youtube.com/watch?v=93wZbN9tecs"
              },
              {
                "num": 10,
                "url": "https://www.cnet.com/tech/mobile/best-phone/"
              },
              {
                "num": 11,
                "url": "https://www.pcmag.com/picks/the-best-phones"
              },
              {
                "num": 12,
                "url": "https://www.gsmarena.com/best_flagship_phones_buyers_guide-review-2027.php"
              }
            ]
          }
        ],
        "displayed_tabs": [
          "search",
          "images",
          "sources"
        ],
        "related_queries": [
          "How do the prices of the top 3 smartphones compare across US marketplaces",
          "What features make the Galaxy S25 Ultra stand out as the best in 2025",
          "Why is the Pixel 9a considered a top budget option despite its lower price",
          "How does the iPhone 16 Pro Max's pricing differ from Samsung and Google models",
          "What factors should I consider when choosing among these top smartphones in 2025"
        ],
        "answer_results_md": "\nThe top 3 smartphones in 2025 based on expert reviews and market consensus are:\n\n1. **Samsung Galaxy S25 Ultra**\n2. **Apple iPhone 16 Pro Max**\n3. **Google Pixel 9 Pro XL** (or alternatively the Pixel 9a as a value option)\n\n### Pricing Comparison Across US Marketplaces (Approximate MSRP & Market Prices):\n\n| Smartphone Model        | MSRP (Official) | Amazon Price (2025) | T-Mobile Price (2025)  | Notes                        |\n|------------------------|-----------------|---------------------|-----------------------|------------------------------|\n| Samsung Galaxy S25 Ultra| $1,300          | Around $949.50 (256GB)| Around $830 - $1,000  | Prices vary by storage, with deals around $950 for 256GB variants; offers S Pen and premium camera features[2][11][12]|\n| Apple iPhone 16 Pro Max | $1,200          | Around $1,200         | $830 (iPhone 16 base)  | Pro Max model typically $1,200 MSRP; iPhone 16 base model available around $830 at carriers[2][10]|\n| Google Pixel 9 Pro XL   | $900            | Not specifically listed | N/A                   | MSRP $900; Pixel 9a variant offers strong value under $500[2][4][10]|\n\n### Notes on these smartphones:\n\n- **Samsung Galaxy S25 Ultra** is considered the best overall phone with a large 6.9\" display, powerful Snapdragon 8 Elite processor, 5,000mAh battery, versatile cameras including 200MP sensor, and built-in S Pen productivity features. It commands a premium price but can be found with discounts below MSRP on platforms like Amazon and T-Mobile[2][12].\n\n- **Apple iPhone 16 Pro Max** stands as the best iPhone with Apple's A18 Pro Bionic chip, a similarly large 6.9\" screen, and up to 1TB storage, priced around $1,200 MSRP. Carrier deals can sometimes bring the effective cost lower for the base iPhone 16 (not Pro Max)[2][10].\n\n- **Google Pixel 9 Pro XL** offers a solid camera and software experience with Google\u2019s Tensor G4 chip at a lower price point (~$900). For those seeking excellent value, the Pixel 9a offers impressive cameras and performance under $500 but is not a flagship competitor[2][4].\n\n### Marketplaces Overview:\n\n- **Amazon** typically offers slightly discounted flagship prices\u2014Samsung Galaxy S25 Ultra (256GB) found near $949.50, OnePlus 13 and other flagships similarly discounted[11][12].\n- **Carrier stores like T-Mobile** sometimes provide financing and promotional prices\u2014iPhone 16 starting near $830 with plans, Samsung Galaxy S25 varies but can approach MSRP or lower under contracts[10][11].\n- Other marketplaces (Best Buy, Walmart) generally align with Amazon and carrier pricing but may vary with bundles and seasonal promotions.\n\nIn summary, the premium flagship tier in 2025 centers around the Samsung Galaxy S25 Ultra and Apple iPhone 16 Pro Max, with Google\u2019s Pixel 9 Pro XL key as a powerful, slightly more affordable flagship alternative. Pricing varies but flagship devices routinely range from $900 to $1,300 in the US market, with discounts commonly available through Amazon and carriers[2][10][11][12].\n\n[1] https://www.youtube.com/watch?v=EYMe2jy-urg\n[2] https://www.zdnet.com/article/best-phone/\n[3] https://www.tomsguide.com/best-picks/best-phones\n[4] https://www.wired.com/story/best-cheap-phones/\n[5] https://www.techradar.com/news/best-phone\n[6] https://www.counterpointresearch.com/insight/top-10-bestselling-smartphones-q1-2025/\n[7] https://uptradeit.com/blog/what-iphones-will-stop-working\n[8] https://www.stuff.tv/features/best-phone/\n[9] https://www.youtube.com/watch?v=93wZbN9tecs\n[10] https://www.cnet.com/tech/mobile/best-phone/\n[11] https://www.pcmag.com/picks/the-best-phones\n[12] https://www.gsmarena.com/best_flagship_phones_buyers_guide-review-2027.php\n",
        "parse_status_code": 12000,
        "additional_results": {
          "images_results": [
            {
              "title": "Top Smartphones of 2025 with AI-Driven Features",
              "image_url": "https://img-cdn.thepublive.com/filters:format(webp)/industry-wired/media/media_files/2025/01/04/A9hU8NmTl0weavNM5Cmb.jpg",
              "image_from_url": "https://industrywired.com/ai/top-smartphones-of-2025-with-ai-driven-features-8590046"
            },
            {
              "title": "The best phone 2025: top smartphones in the US right now ...",
              "image_url": "https://cdn.mos.cms.futurecdn.net/CuSm3XePuDdXHxmbeoZF8M.jpg",
              "image_from_url": "https://www.techradar.com/news/best-phone"
            },
            {
              "title": "Best phones 2025 tested \u2014 Our top picks | Tom's Guide",
              "image_url": "https://cdn.mos.cms.futurecdn.net/M4nigVN3vvA5EEnNX9atxY.jpg",
              "image_from_url": "https://www.tomsguide.com/best-picks/best-phones"
            },
            {
              "title": "Best phones to buy in 2025 reviewed and ranked | Stuff",
              "image_url": "https://www.stuff.tv/wp-content/uploads/sites/2/2024/07/Best-smartphones-on-sale-2024-lead.jpg",
              "image_from_url": "https://www.stuff.tv/features/best-phone/"
            },
            {
              "title": "The best mid-range phones to buy in 2025 - PhoneArena",
              "image_url": "https://m-cdn.phonearena.com/images/article/133911-wide-two_1200/The-best-mid-range-phones-to-buy-in-2025.jpg",
              "image_from_url": "https://www.phonearena.com/news/best-mid-range-phones_id133911"
            },
            {
              "title": "The best smartphones of 2025, tried and tested \u2013 but are ...",
              "image_url": "https://www.telegraph.co.uk/content/dam/recommended/2025/05/20/TELEMMGLPICT000425244583_17477562398800_trans_NvBQzQNjv4BqqVzuuqpFlyLIwiB6NTmJwfSVWeZ_vEN7c6bHu2jJnT8.jpeg?imwidth=640",
              "image_from_url": "https://www.telegraph.co.uk/recommended/tech/best-smartphones/"
            },
            {
              "title": "Best Phones in 2025 | Top-Rated Smartphones and Cellphones ...",
              "image_url": "https://www.cnet.com/a/img/resize/b84fd97fe29bbe2ec4d397caf63db53bf8bea241/hub/2022/03/30/e841545d-e55c-47fc-b24a-003bf14e58c8/oneplus-10-pro-cnet-review-12.jpg?auto=webp&fit=crop&height=900&width=1200",
              "image_from_url": "https://www.cnet.com/tech/mobile/best-phone/"
            },
            {
              "title": "The 7 Best Smartphones to Buy in 2025 - Best Smartphone Reviews",
              "image_url": "https://hips.hearstapps.com/hmg-prod/images/best-smartphones-2025-67afc62def800.jpg?crop=0.503xw:0.671xh;0.338xw,0.218xh&resize=1120:*",
              "image_from_url": "https://www.bestproducts.com/tech/electronics/g60318873/best-smartphones/"
            },
            {
              "title": "Which Smartphones Are Most Popular in 2025? The Winner Might ...",
              "image_url": "https://i.pcmag.com/imagery/articles/00lQQsbajdRLVSbeeBwioC0-2.fit_lim.size_1050x.webp",
              "image_from_url": "https://www.pcmag.com/news/2025-smartphone-sales-rankings-reveal-a-surprise-leader-and-a-red-flag"
            }
          ],
          "sources_results": [
            {
              "url": "https://www.youtube.com/watch?v=EYMe2jy-urg",
              "title": "Top 5 BEST Smartphones of 2025\u2026 So Far - YouTube"
            },
            {
              "url": "https://www.zdnet.com/article/best-phone/",
              "title": "The best phones to buy in 2025 - ZDNET"
            },
            {
              "url": "https://www.tomsguide.com/best-picks/best-phones",
              "title": "Best phones 2025 tested \u2014 Our top picks | Tom's Guide"
            },
            {
              "url": "https://www.wired.com/story/best-cheap-phones/",
              "title": "8 Best Cheap Phones (2025), Tested and Reviewed - WIRED"
            },
            {
              "url": "https://www.techradar.com/news/best-phone",
              "title": "The best phone 2025: top smartphones in the US right now"
            },
            {
              "url": "https://www.counterpointresearch.com/insight/top-10-bestselling-smartphones-q1-2025/",
              "title": "iPhone 16 Leads Global Smartphone Sales in Q1 2025"
            },
            {
              "url": "https://uptradeit.com/blog/what-iphones-will-stop-working",
              "title": "What iPhones Will Stop Working in 2025 - UpTrade"
            },
            {
              "url": "https://www.stuff.tv/features/best-phone/",
              "title": "Best phones to buy in 2025 reviewed and ranked - Stuff"
            },
            {
              "url": "https://www.youtube.com/watch?v=93wZbN9tecs",
              "title": "Best Phones of 2025 (so far) | Mid-Range, Camera, Gaming & More"
            },
            {
              "url": "https://www.cnet.com/tech/mobile/best-phone/",
              "title": "Best Phones in 2025 | Top-Rated Smartphones and ... - CNET"
            },
            {
              "url": "https://www.pcmag.com/picks/the-best-phones",
              "title": "The Best Phones We've Tested (July 2025) - PCMag"
            },
            {
              "url": "https://www.gsmarena.com/best_flagship_phones_buyers_guide-review-2027.php",
              "title": "Best flagship phones 2025 - buyer's guide - GSMArena.com tests"
            }
          ]
        }
      },
      "created_at": "2025-07-16 12:14:32",
      "updated_at": "2025-07-16 12:15:28",
      "page": 1,
      "url": "https://www.perplexity.ai/search/top-3-smartphones-in-2025-comp-wvA0dso7TgW3NpgF8Jd8tg",
      "job_id": "7351222707934990337",
      "is_render_forced": false,
      "status_code": 200,
      "parser_type": "perplexity",
      "parser_preset": null
    }
  ]
}

Output data dictionary

HTML example

JSON structure

The structured perplexity output includes fields such as url, model, answer_results, and more. The table below breaks down the page elements we parse, along with descriptions, data types, and relevant metadata.

The number of items and fields for a specific result type may vary depending on the submitted prompt.

Field

Description

Type

url

The URL of Perplexity's conversation.

string

page

Page number.

integer

content

An object containing parsed Perplexity page data.

object

model

Perplexity model used to generate the answer.

string

prompt_query

The original prompt submitted to Perplexity.

string

displayed_tabs

Tabs displayed in Perplexity's interface (e.g., shopping, images).

list

answer_results

The complete Perplexity response containing text or nested content.

list or string

answer_results_md

The entire answer rendered in Markdown format.

string

related_queries

A list of queries related to the main prompt.

list

top_images

A list of top images with their titles and URLs.

array

top_sources

A list of top cited sources with their titles, sources, and URLs.

array

inline_products

A list of inline products with titles, prices, links, and other metadata.

array

additional_results.hotels_results

A list of hotels with titles, URLs, addresses, and other hotel details.

array

additional_results.places_results

A list of places with titles, URLs, coordinates,, and other metadata.

array

additional_results.videos_results

A list of videos with thumbnails, titles, URLs, and sources.

array

additional_results.shopping_results

A list of shopping items with titles, prices, URLs, and other product metadata.

array

additional_results.sources_results

A list of cited sources with their titles and URLs.

array

additional_results.images_results

A list of related images with titles, image URLs, and source page URLs.

array

parse_status_code

Status code of the parsing operation.

integer

created_at

The timestamp when the scraping job was created.

timestamp

updated_at

The timestamp when the scraping job was finished.

timestamp

job_id

The ID of the job associated with the scraping job.

string

geo_location

Proxy location from which the prompt was submitted.

string

status_code

The status code of the scraping job. You can see the scraper status codes described here.

integer

parser_type

The type of the parser used for breaking down the HTML content.

string

Additional results and inline products

Along with the main AI response, we return extra data under additional_results, such as

images_results
sources_results
shopping_results
videos_results
places_results
hotels_results

These arrays are extracted from the tabs on the original results page and are included only if relevant content is available:

Moreover, the inline_products array contains products that are directly embedded in the response:

PreviousChatGPT NextNorth American E-Commerce

Last updated 2 months ago

Was this helpful?

Good evening

Request samples

Request parameter values

Generic

Structured data

Output data dictionary

HTML example

JSON structure

Additional results and inline products