For the complete documentation index, see llms.txt. This page is also available as Markdown.

Perplexity

通过提交提示词提取 Perplexity 响应,提供解析数据,包括答案文本、Markdown 输出、相关查询、引用来源、图片、内嵌产品等。

perplexity source 允许您提交提示并接收完全解析、结构化的响应,包括格式化答案、使用的网页来源、相关查询和显示的 UI 标签页。与产品相关的提示可返回购物结果和内联产品列表。

请求示例

下面的代码示例演示如何使用 Perplexity 发送提示 Push-Pull.

curl 'https://data.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \\
-H 'Content-Type: application/json' \\
-d '{
        "source": "perplexity",
        "prompt": "best supplements for better sleep",
        "geo_location": "United States",
        "parse": true,
        "callback_url": "https://your-server.com/oxylabs-callback"
    }'
import requests
from pprint import pprint


# 结构化载荷。
payload = {
    'source': 'perplexity',
    'prompt': 'top 3 smartphones in 2025, compare pricing across US marketplaces',
    'geo_location': 'United States',
    'parse': True,
    'callback_url': 'https://your-server.com/oxylabs-callback'
}

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

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

注意: 所有 LLM 来源默认启用 JavaScript 渲染。您无需在请求负载中包含渲染参数。

使用以下方式提交作业 Push-Pull 集成(包括 批量查询) 方法会立即返回作业 ID,而不是结果。一旦作业状态为 done,即可获取解析后的响应。参见 集成方式 LLMs 和 AI 页面上的完整提交与检索流程。

请求参数

用于抓取 Perplexity 响应的基本设置和配置参数。

参数
描述
默认值

source

设置爬虫目标。使用 perplexity.

prompt

提交给 Perplexity 的提示或问题。必须少于 8000 个字符。

callback_url

推荐。 作业完成后我们发送通知的 URL。 更多信息.

解析

设置为 true 用于结构化 JSON 数据。

false

geo_location

指定请求路由所在的国家/地区。 更多信息.

browser_instructions

渲染 JavaScript 时的可选自定义浏览器指令。 更多信息.

- 必填参数

结构化数据

一旦通过 Push-Pull 结果端点检索到任务,网页爬虫API 将返回 HTML 文档或 Perplexity 输出的 JSON 对象,其中包含结果页中的结构化数据。

perplexity 结构化输出

输出数据字典

HTML 示例

JSON 结构

所有 LLM 目标返回相同的顶层 作业results[] 封装。参见 LLMs 和 AI 以查看完整的元数据参考。

下表显示 Perplexity 特有的 results[].content 字段:

特定结果类型的项数和字段数可能因提交的提示而异。

字段
描述
类型

prompt_query

提交的提示或搜索查询。

字符串

model

响应所使用的 Perplexity 模型(例如, turbo).

字符串

answer_results

以 Markdown JSON 树形式生成的答案。

数组

answer_results_md

以 Markdown 形式生成的答案

字符串

additional_results

分组的 UI 元素。 sources_results – Perplexity 使用的网页来源列表(titleurl)。可包括 images_results, hotels_results, places_results, videos_results,以及 shopping_results.

对象

top_images

Perplexity 在“Images”标签页上的图片结果。对象包括 urltitle.

数组

top_sources

Perplexity 排名靠前的来源结果。对象包括 url, title,以及 source.

数组

inline_products

由与产品相关的查询触发的购物结果。

数组

related_queries

Perplexity 建议的后续问题。

字符串数组

displayed_tabs

解析后页面上可见的 UI 标签页(例如 Answer、Links、Images)。

字符串数组

url

此查询对应的 Perplexity 搜索页面 URL。

字符串

parse_status_code

12000 – 成功。否则,解析器未能提取部分或全部结构化字段。

整数

– 条件返回,仅在内容出现在 LLM 响应中时返回。

额外结果和内联产品

除了主要的 AI 响应外,我们还会在 additional_results下返回额外数据,例如

  • sources_results

  • images_results

  • shopping_results

  • videos_results

  • places_results

  • hotels_results

这些数组从原始结果页的标签页中提取,仅在存在相关内容时包含:

inline_products 数组还包含直接嵌入响应中的产品:

最后更新于

这有帮助吗?