Perplexity
Web Scraping API Perplexity Target
The perplexity target is built to obtain conversational responses from Perplexity.
This target is available with Web API Advanced plans.
We recommend using Asynchronous integration methods for this template, however Real-time is available as well. Batch requests are not supported.
Input Parameters
Request parameters available for Perplexity target:
| 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. more information here. | |
parse | boolean | Automatically parses results when set to true. Default value is false. | |
geo | string | Set the country to use when submitting the prompt. Full list of locations available for Advanced plan can be found here. |
Request Examples
curl --request 'POST' \
--url 'https://scraper-api.decodo.com/v2/task' \
--header 'Accept: application/json' \
--header 'Authorization: Basic TOKEN VALUE' \ // update with your authorization token
--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://scraper-api.decodo.com/v2/scrape", {
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": "Basic TOKEN" // update with your authorization token
},
}).catch(error => console.log(error));
console.log(await response.json())
}
scrape()
import requests
url = "https://scraper-api.decodo.com/v2/scrape"
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": "Basic TOKEN" # update with your authorization token
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)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 amount of fields can vary according to the provided prompt.
| Content key | Description |
|---|---|
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 full response text. |
answer_results_md | The full response text in Markdown format. |
related_queries | Queries list associated with the main prompt. |
top_images | A list of top images with associated titles, links. |
top_sources | A list of main citations, each with associated links and titles. |
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 amount 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
{
"results": [
{
"content": {
"results": {
"url": "https://www.perplexity.ai/search/top-3-tips-to-improve-producti-b8lqANjhQbmQYeQ_lcNHVg",
"model": "turbo",
"top_sources": [
{
"url": "https://www.indeed.com/career-advice/career-development/productivity-tips-working-from-home",
"title": "20 Tips for Working From Home: How To Be Productive Outside the ...",
"source": "indeed career guide"
},
{
"url": "https://brainhub.eu/library/stay-productive-working-remotely",
"title": "Staying Productive While Working From Home - Tips & Tricks",
"source": "brainhub.eu"
},
{
"url": "https://www.unitemps.com/career-advice/working-from-home-tips/",
"title": "15 working from home tips for productivity and wellbeing - Unitemps",
"source": "unitemps"
},
{
"url": "https://www.bamboohr.com/blog/tips-for-working-remotely",
"title": "How to Work From Home: Tips to Boost Productivity",
"source": "bamboohr.com"
}
],
"prompt_query": "Top 3 tips to improve productivity while working from home?",
"answer_results": [
"The top 3 tips to improve productivity while working from home are:",
{
"list": [
[
[
[
"Create a dedicated workspace:"
],
" Set up a specific area in your home, ideally separate from your living or relaxing spaces, that is organized, comfortable, and designed for work. This physical separation helps signal to your brain that it’s time to focus and can minimize distractions[3][12]."
]
],
[
[
[
"Establish a consistent routine and clear working hours:"
],
" Begin your day with a morning routine and set regular work hours. Treat your remote workday like you would in an office—get dressed, start at a set time, and plan breaks. This helps reinforce structure, making it easier to concentrate and maintain boundaries between work and personal life[1][5][12]."
]
],
[
[
[
"Limit distractions and take regular breaks:"
],
" Proactively manage potential distractions, such as household chores, social media, or family members. Use productivity techniques like time blocking or the Pomodoro Method (working for set intervals, then taking short breaks) to enhance concentration and reduce burnout[1][3][9]."
]
]
]
},
"Implementing these three strategies will help most remote workers boost focus, efficiency, and overall well-being while working from home.",
{
"enumerated_references": [
{
"num": 1,
"url": "https://www.indeed.com/career-advice/career-development/productivity-tips-working-from-home"
},
{
"num": 2,
"url": "https://brainhub.eu/library/stay-productive-working-remotely"
},
{
"num": 3,
"url": "https://www.unitemps.com/career-advice/working-from-home-tips/"
},
{
"num": 4,
"url": "https://www.bamboohr.com/blog/tips-for-working-remotely"
},
{
"num": 5,
"url": "https://asana.com/resources/how-to-be-productive-at-home"
},
{
"num": 6,
"url": "https://dev.to/thinkers/guide-to-stay-productive-while-working-from-home-4m69"
},
{
"num": 7,
"url": "https://www.reddit.com/r/productivity/comments/160qb1r/wfh_peeps_what_are_some_tips_you_can_share/"
},
{
"num": 8,
"url": "https://www.networksolutions.com/blog/work-from-home-best-practices/"
},
{
"num": 9,
"url": "https://www.upwork.com/resources/productivity-tips-working-from-home"
},
{
"num": 10,
"url": "https://porch.com/advice/stay-productive-working-home"
},
{
"num": 11,
"url": "https://www.highspot.com/blog/36-tips-to-stay-productive-while-working-from-home/"
},
{
"num": 12,
"url": "https://www.nextiva.com/blog/working-from-home-tips.html"
},
{
"num": 13,
"url": "https://theeverygirl.com/productivity-hacks-work-from-home/"
}
]
}
],
"displayed_tabs": [
"search",
"sources",
"tasks"
],
"related_queries": [
"What are the most effective routines to start and end my workday at home",
"How can I minimize distractions like social media and household chores",
"Which technology tools can boost my productivity while working remotely",
"How do I set healthy boundaries with my household and coworkers",
"What are some personal habits that can enhance my focus and efficiency at home"
],
"answer_results_md": "\nThe top 3 tips to improve productivity while working from home are:\n\n- **Create a dedicated workspace:** Set up a specific area in your home, ideally separate from your living or relaxing spaces, that is organized, comfortable, and designed for work. This physical separation helps signal to your brain that it’s time to focus and can minimize distractions[3][12].\n- **Establish a consistent routine and clear working hours:** Begin your day with a morning routine and set regular work hours. Treat your remote workday like you would in an office—get dressed, start at a set time, and plan breaks. This helps reinforce structure, making it easier to concentrate and maintain boundaries between work and personal life[1][5][12].\n- **Limit distractions and take regular breaks:** Proactively manage potential distractions, such as household chores, social media, or family members. Use productivity techniques like time blocking or the Pomodoro Method (working for set intervals, then taking short breaks) to enhance concentration and reduce burnout[1][3][9].\n\nImplementing these three strategies will help most remote workers boost focus, efficiency, and overall well-being while working from home.\n\n[1] https://www.indeed.com/career-advice/career-development/productivity-tips-working-from-home\n[2] https://brainhub.eu/library/stay-productive-working-remotely\n[3] https://www.unitemps.com/career-advice/working-from-home-tips/\n[4] https://www.bamboohr.com/blog/tips-for-working-remotely\n[5] https://asana.com/resources/how-to-be-productive-at-home\n[6] https://dev.to/thinkers/guide-to-stay-productive-while-working-from-home-4m69\n[7] https://www.reddit.com/r/productivity/comments/160qb1r/wfh_peeps_what_are_some_tips_you_can_share/\n[8] https://www.networksolutions.com/blog/work-from-home-best-practices/\n[9] https://www.upwork.com/resources/productivity-tips-working-from-home\n[10] https://porch.com/advice/stay-productive-working-home\n[11] https://www.highspot.com/blog/36-tips-to-stay-productive-while-working-from-home/\n[12] https://www.nextiva.com/blog/working-from-home-tips.html\n[13] https://theeverygirl.com/productivity-hacks-work-from-home/\n",
"parse_status_code": 12000,
"additional_results": {
"sources_results": [
{
"url": "https://www.indeed.com/career-advice/career-development/productivity-tips-working-from-home",
"title": "20 Tips for Working From Home: How To Be Productive Outside the ..."
},
{
"url": "https://brainhub.eu/library/stay-productive-working-remotely",
"title": "Staying Productive While Working From Home - Tips & Tricks"
},
{
"url": "https://www.unitemps.com/career-advice/working-from-home-tips/",
"title": "15 working from home tips for productivity and wellbeing - Unitemps"
},
{
"url": "https://www.bamboohr.com/blog/tips-for-working-remotely",
"title": "How to Work From Home: Tips to Boost Productivity"
},
{
"url": "https://asana.com/resources/how-to-be-productive-at-home",
"title": "Be Productive at Home: 11 Tips to Promote Efficiency [2025] - Asana"
},
{
"url": "https://dev.to/thinkers/guide-to-stay-productive-while-working-from-home-4m69",
"title": "How to Stay Productive While Working from Home: A Complete Guide"
},
{
"url": "https://www.reddit.com/r/productivity/comments/160qb1r/wfh_peeps_what_are_some_tips_you_can_share/",
"title": "WFH peeps, what are some tips you can share? - productivity - Reddit"
},
{
"url": "https://www.networksolutions.com/blog/work-from-home-best-practices/",
"title": "20 Work From Home Best Practices for Boosting Productivity"
},
{
"url": "https://www.upwork.com/resources/productivity-tips-working-from-home",
"title": "25 Top Tips for Work Productivity from Home in 2025 - Upwork"
},
{
"url": "https://porch.com/advice/stay-productive-working-home",
"title": "Easy Tips to Help you Stay Productive While Working from Home"
},
{
"url": "https://www.highspot.com/blog/36-tips-to-stay-productive-while-working-from-home/",
"title": "36 Tips to Stay Productive While Working from Home"
},
{
"url": "https://www.nextiva.com/blog/working-from-home-tips.html",
"title": "24 Work From Home Tips to Drive Better Productivity"
},
{
"url": "https://theeverygirl.com/productivity-hacks-work-from-home/",
"title": "Productivity Hacks for Work From Home Employees | The Everygirl"
}
]
}
},
"errors": [],
"status_code": 12000,
"task_id": "7355837545495677953"
},
"headers": {
"date": "Tue, 29 Jul 2025 05:52:26 GMT",
"vary": "RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch, Accept-Encoding",
"cf-ray": "966a59a63b0a09f5-LAS",
"server": "cloudflare",
"content-type": "text/html; charset=utf-8",
"x-powered-by": "Next.js",
"cache-control": "private, no-cache, no-store, max-age=0, must-revalidate",
"x-firefox-spdy": "h2",
"cf-cache-status": "DYNAMIC",
"x-frame-options": "DENY",
"content-encoding": "gzip",
"content-security-policy": "object-src 'none'; base-uri 'self'; form-action 'self' https://onedrive.live.com https://*.sharepoint.com; frame-ancestors 'self' https://onedrive.live.com https://*.sharepoint.com https://app.athina.ai; block-all-mixed-content; upgrade-insecure-requests;",
"strict-transport-security": "max-age=15552000; includeSubDomains; preload"
},
"cookies": [
{
"key": "m",
"path": "/",
"value": "912dbae5-6ec9-470a-8297-afa3b1f5ff64321a7d",
"domain": "m.stripe.com",
"secure": true,
"comment": "",
"expires": 1788328356,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "pplx.visitor-id",
"path": "/",
"value": "33d3e98b-9f20-422e-a4fd-6421ec4c9d8f",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": 1785304338,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "pplx.session-id",
"path": "/",
"value": "a42cc928-c2e5-4e9c-9d15-65964fc19602",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": -1,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "__cf_bm",
"path": "/",
"value": "t6fowQdTSSFC.8BvfJKRMJQl2vrrp2X5eZCTqNhaaWk-1753768338-1.0.1.1-eyaXAaQF6JFcXXzyvgstCzX7JKFDzdTab2XXt3lEtWqGTxVVwuUAX6cM19z2KJovFiYktIxHoUW7kPViIcdSmxPNbgSjMnS6_snbX0UW3YM",
"domain": ".perplexity.ai",
"secure": true,
"comment": "",
"expires": 1753770138,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "__cflb",
"path": "/",
"value": "02DiuDyvFMmK5p9jVbVnMNSKYZhUL9aGkRrsFKFDUXmLg",
"domain": "www.perplexity.ai",
"secure": true,
"comment": "",
"expires": 1753851138,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "segmented-control-popover-studio",
"path": "/",
"value": "1",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": 1785304342,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "next-auth.csrf-token",
"path": "/",
"value": "0f29983dd9cef1af8097db3e9dea8d296a3504c581ba8dcdeaf5697a5d2f31e9%7C8fca4b8f36614ef650ad66f0dbdfc444db3da837392cdf3e9d4a32d1e86fd6e4",
"domain": "www.perplexity.ai",
"secure": true,
"comment": "",
"expires": -1,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "comet-custom-color-themes-enabled",
"path": "/",
"value": "true",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": -1,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "_dd_s",
"path": "/",
"value": "aid=6ace56ec-f8be-4e65-add6-b800f95d62a9&rum=2&id=03e7f657-643c-4c79-ad4c-1bdbe467737a&created=1753768339902&expire=1753769247456&logs=0",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": 1753769247,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "cf_clearance",
"path": "/",
"value": "lg51YL07Hejhsr4U9dixz0x0fxwKABC6bZc.KxlZR60-1753768347-1.2.1.1-iHQve.BmqgAiabDecZM47J_zyx1mRogKZep0J7j.lAD8wBTS9t.RPVD2u1YSrvUv3DQWFxd3DNDRB9_avcse.ceo0QIIQ.hwArNeoJNtuSOoShU.rnrtxYfPwCneA2.Fb7zIsF9NPxCrGVB5WGPl6bXl9cl5FU0JPj0W1qX0EIrpDYsiFDXxm6nS5pvIYa3OQGzX9EnNCt7DKQUxBrNzVoHsmDyNeRBhvCgL1KPAUOg",
"domain": ".perplexity.ai",
"secure": true,
"comment": "",
"expires": 1785304348,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "next-auth.callback-url",
"path": "/",
"value": "https%3A%2F%2Fwww.perplexity.ai%2Fapi%2Fauth%2Fsignin-callback%3Fredirect%3Dhttps%253A%252F%252Fwww.perplexity.ai",
"domain": "www.perplexity.ai",
"secure": true,
"comment": "",
"expires": -1,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "AWSALB",
"path": "/",
"value": "Y8Gu8sgxuQgsSmDLCDTXQakmD5jfXKeVkNL1VOOl4lcZcWWoRE0TqlMND8AyUJoIUnBrWYDIZ12BbgQvNh2MsUb8fDclHiuGgWtLY2ZTvgMC9l4FX2PYGfQSRPVV",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": 1754373149,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "AWSALBCORS",
"path": "/",
"value": "Y8Gu8sgxuQgsSmDLCDTXQakmD5jfXKeVkNL1VOOl4lcZcWWoRE0TqlMND8AyUJoIUnBrWYDIZ12BbgQvNh2MsUb8fDclHiuGgWtLY2ZTvgMC9l4FX2PYGfQSRPVV",
"domain": "www.perplexity.ai",
"secure": true,
"comment": "",
"expires": 1754373149,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "sidebarHiddenHubs",
"path": "/",
"value": "[]",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": 1788328349,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "pplx.la-status",
"path": "/",
"value": "allowed",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": -1,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "pplx.metadata",
"path": "/",
"value": "{%22qc%22:1%2C%22qcr%22:0%2C%22qcdr%22:0%2C%22qcs%22:0%2C%22qcd%22:1%2C%22hli%22:false%2C%22hcga%22:false%2C%22hcds%22:false%2C%22hso%22:false%2C%22hfo%22:false%2C%22fqa%22:1753768349192%2C%22lqa%22:1753768349192}",
"domain": "www.perplexity.ai",
"secure": false,
"comment": "",
"expires": 1788328354,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "__stripe_mid",
"path": "/",
"value": "1e8097f1-fca4-4b97-9a8a-550f0794b87d047262",
"domain": ".www.perplexity.ai",
"secure": true,
"comment": "",
"expires": 1785304356,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
},
{
"key": "__stripe_sid",
"path": "/",
"value": "321769ee-a763-4151-bc30-ffe5a6cd7b25fb1183",
"domain": ".www.perplexity.ai",
"secure": true,
"comment": "",
"expires": 1753770156,
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
}
],
"status_code": 200,
"task_id": "7355837545495677953",
"created_at": "2025-07-29 05:52:15",
"updated_at": "2025-07-29 05:52:40"
}
]
}Support
Still can't find an answer? Want to say hi? We take pride in our 24/7 customer support. Alternatively, you can reach us via our support email at [email protected].
Updated about 15 hours ago