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.

This template is available via both Real-time and Asynchronous integration methods, however this target does not support batch requests.


Input parameters

Request parameters available for Perplexity target:

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. Full list of locations available for Advanced plan can be found here.

Request example

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"
    }
'

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 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 amount 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"
        }
    ]
}