Perplexity

The perplexity template is built to obtain conversational responses from Perplexity.

Useful Links

The Perplexity template uses the Premium Proxy Pool by default.
Asynchronous integration method is recommended for this template.
Batch requests are supported.

Input Parameters

Request parameters available for Perplexity template:

Parameter	Type	Required	Description
`target`	string	✅	Target type must be set to `perplexity`.
`prompt`	string	✅	The prompt sent to Perplexity. Must be fewer than 8000 characters.
`headless`	string		By default, JavaScript rendering is forced, omit parameter in the request. Set to `png` to receive screenshot response. Read more.
`parse`	boolean		Automatically parses results when set to `true`. Default value is `false`.
`geo`	string		Set the country to use when submitting the prompt. Read more.

Request Examples

# update 'TOKEN VALUE' with your API KEY
curl --request 'POST' \
        --url 'https://data.decodo.com/v1/task' \
        --header 'Accept: application/json' \
        --header 'Authorization: Bearer TOKEN VALUE' \
        --header 'Content-Type: application/json' \
        --data '
    {
     	"target": "perplexity",
     	"prompt": "Top 3 tips to improve productivity while working from home?",
     	"parse": true,
     	"geo": "United States"
    }
'

const scrape = async() => {
  const response = await fetch("https://data.decodo.com/v1/task", {
    method: "POST",
    body: JSON.stringify({
      "target": "perplexity",
      "prompt": "Top 3 tips to improve productivity while working from home?",
      "parse": true,
      "geo": "United States"
    }),
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer TOKEN" // update with your API KEY
    },
  }).catch(error => console.log(error));

  console.log(await response.json())
}

scrape()

import requests
  
url = "https://data.decodo.com/v1/task"
  
payload = {
      "target": "perplexity",
      "prompt": "Top 3 tips to improve productivity while working from home?",
      "parse": True,
      "geo": "United States"
}
  
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer TOKEN" # update with your API KEY
}
  
response = requests.post(url, json=payload, headers=headers)
  
print(response.text)

The response returns a task id. Once the task status is done, fetch the result with GET https://data.decodo.com/v1/task/{task_id}/results. See Asynchronous Requests for polling and batch examples.

Output

As an output, you will get a JSON file. Descriptions for fields in the parsed JSON content section are provided in the table below. Keep in mind that the number of fields can vary according to the provided prompt.

Content key	Description
`url`	The URL of the Perplexity answer page.
`model`	The Perplexity model used.
`prompt_query`	The original query submitted in the request.
`displayed_tabs`	Interface tabs in Perplexity (e.g., shopping, images).
`answer_results`	The response as an array of blocks: paragraphs and headings as strings, bullet lists as `list` objects, and cited sentences as arrays followed by their `link_title` / `link_url` sources. List items can contain cited sentences too.
`answer_results_md`	The full response text in Markdown format.
`related_queries`	Queries list associated with the main prompt. May be empty.
`top_images`	A list of top images with associated titles, links.
`inline_products`	A list of inline products with associated titles, prices, links, and other metadata.

In addition to the main AI response, we provide extra data under additional_results. Descriptions for these fields can be found in the table below. Keep in mind that the number of fields can vary according to the provided prompt.

Additional results Key	Description
`hotels_results`	A list of hotels with associated titles, links, addresses, and additional details.
`places_results`	A list of places with associated titles, links, coordinates, and other metadata.
`videos_results`	A list of videos with associated thumbnails, titles, links, and sources.
`shopping_results`	A list of shopping items with associated titles, prices, links, and other metadata.
`sources_results`	A list of citations, each with associated links and titles.
`images_results`	A list of related images with associated titles, image links, and source page links.

Response Example

Returned by GET https://data.decodo.com/v1/task/{task_id}/results:

{
  "results": [
    {
      "content": {
        "url": "https://www.perplexity.ai/search/39ca6865-4f70-4516-a621-6244f86d4d03",
        "model": "turbo",
        "prompt_query": "Top 3 tips to improve productivity while working from home?",
        "displayed_tabs": [
          "Answer",
          "Links",
          "Images"
        ],
        "answer_results": [
          "The three highest-impact habits are to structure your day, protect focused work time, and make a clear separation between work and home. Start small: apply one change for a week, then adjust based on what actually disrupts your attention.",
          "1. Plan priorities and time blocks",
          "Before you begin, choose ",
          "one important outcome",
          " for the day, plus two or three smaller tasks. Put dedicated blocks on your calendar for the highest-value work—ideally during the part of the day when you are naturally most alert.",
          {
            "list": [
              [
                "Turn a vague item such as “work on report” into a concrete next action: “Draft the three findings sections.”"
              ],
              [
                [
                  "Work in focused blocks with notifications silenced, then take short breaks to reset.",
                  {
                    "link_title": [
                      "upwork"
                    ],
                    "link_url": "https://www.upwork.com/resources/productivity-tips-working-from-home"
                  }
                ]
              ],
              [
                "Avoid filling every minute: leave time for email, messages, and surprises."
              ]
            ]
          },
          [
            "Task lists, reminders, timers, and checklists can support focus, and a practical framework is to reserve a substantial early block for your most important project before moving to shorter or maintenance tasks.",
            {
              "link_title": [
                "health.clevelandclinic"
              ],
              "link_url": "https://health.clevelandclinic.org/how-to-work-from-home-still-be-productive"
            },
            {
              "link_title": [
                "asana"
              ],
              "link_url": "https://asana.com/resources/how-to-be-productive-at-home"
            }
          ]
        ],
        "answer_results_md": "\nThe three highest-impact habits are to structure your day, protect focused work time, and make a clear separation between work and home. Start small: apply one change for a week, then adjust based on what actually disrupts your attention.\n\n## 1. Plan priorities and time blocks\n\nBefore you begin, choose **one important outcome** for the day, plus two or three smaller tasks. Put dedicated blocks on your calendar for the highest-value work—ideally during the part of the day when you are naturally most alert.\n\n- Turn a vague item such as “work on report” into a concrete next action: “Draft the three findings sections.”\n- Try a focused interval: 25–50 minutes of work, then a 5–10 minute break.\n- Avoid filling every minute: leave time for email, messages, and surprises.\n\nTask lists, reminders, timers, and checklists can support focus, and a practical framework is to reserve a substantial early block for your most important project before moving to shorter or maintenance tasks.[health.clevelandclinic](https://health.clevelandclinic.org/how-to-work-from-home-still-be-productive)[asana](https://asana.com/resources/how-to-be-productive-at-home)\n\n",
        "related_queries": [],
        "additional_results": {
          "sources_results": [
            {
              "title": "How You Can Work From Home and Still Be Productive",
              "url": "https://health.clevelandclinic.org/how-to-work-from-home-still-be-productive"
            },
            {
              "title": "Working from Home Advice: 10 Tips to Improve Productivity - CCL.org",
              "url": "https://www.ccl.org/articles/leading-effectively-articles/working-from-home-advice-10-tips/"
            },
            {
              "title": "12 Work From Home Tips to Help You Stay Productive | SELF",
              "url": "https://www.self.com/story/remote-work-productivity-tips"
            }
          ]
        },
        "parse_status_code": 12000
      },
      "created_at": "2026-10-01 12:59:50",
      "updated_at": "2026-10-01 13:00:27",
      "page": 1,
      "url": "https://www.perplexity.ai/search/39ca6865-4f70-4516-a621-6244f86d4d03",
      "is_render_forced": false,
      "status_code": 200,
      "type": "parsed",
      "parser_type": "",
      "parser_preset": null,
      "task_id": "7511409543344030721",
      "geo": "United States"
    }
  ]
}

Support

Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.

Feedback

Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.

ABOUT

RESIDENTIAL PROXIES

STATIC RESIDENTIAL (ISP) PROXIES

DATACENTER PROXIES

FREE PROXIES

SITE UNBLOCKER

WEB DATA API

VIDEO DOWNLOADER

DECODO TOOLS

AI

INTEGRATIONS

ACCOUNT & DASHBOARD

PAYMENTS

TROUBLESHOOTING

TIPS & TRICKS

USEFUL LINKS

Useful Links

Input Parameters

Request Examples

Output

Response Example

Support

Feedback

​Useful Links

​Input Parameters

​Request Examples

​Output

​Response Example

Support

Feedback

Useful Links

Input Parameters

Request Examples

Output

Response Example