Skip to main content
Core and Advanced plans are no longer available for purchase. Please consider migrating to the all-in-one Web Scraper API; check out the guide here.
The perplexity template is built to obtain conversational responses from Perplexity.
  • This target is available with Web API Advanced plans.
  • Real-time and Asynchronous integration methods are available for this template
  • Batch requests are not supported.

Input Parameters

Request parameters available for Perplexity template:
ParameterTypeRequiredDescription
targetstringTarget type must be set to perplexity.
promptstringThe prompt sent to Perplexity. Must be fewer than 8000 characters.
headlessstringBy default, JavaScript rendering is forced, omit parameter in the request.
Set to png to receive screenshot response. more information here.
parsebooleanAutomatically parses results when set to true.
Default value is false.
geostringSet the country to use when submitting the prompt.

Request Examples

# update 'TOKEN VALUE' with your authorization token
curl --request 'POST' \
        --url 'https://scraper-api.decodo.com/v2/task' \
        --header 'Accept: application/json' \
        --header 'Authorization: Basic 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"
    }
'

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 keyDescription
modelThe Perplexity model used.
prompt_queryThe original query submitted in the request.
displayed_tabsInterface tabs in Perplexity (e.g., shopping, images).
answer_resultsThe full response text.
answer_results_mdThe full response text in Markdown format.
related_queriesQueries list associated with the main prompt.
top_imagesA list of top images with associated titles, links.
top_sourcesA list of main citations, each with associated links and titles.
inline_productsA 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 KeyDescription
hotels_resultsA list of hotels with associated titles, links, addresses, and additional details.
places_resultsA list of places with associated titles, links, coordinates, and other metadata.
videos_resultsA list of videos with associated thumbnails, titles, links, and sources.
shopping_resultsA list of shopping items with associated titles, prices, links, and other metadata.
sources_resultsA list of citations, each with associated links and titles.
images_resultsA 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

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.