Back

Search the web

This query returns the top ranked web results from Perplexity for the search you provide, each with its title, link, and a snippet.

Developer info

API endpoint slug: perplexity.search_the_web
Runtime method: performQuery("perplexity.search_the_web"}

Query fields

Query Text input > Title

Label: Search query
Helper text: The words or phrase to search the web for. Perplexity returns the most relevant ranked results.
Slug: query
Required: true
Can have default value: true

Number of results Text input > Other

Label: Number of results
Helper text: How many results to return, from 1 to 20. Leave blank for the default of 10.
Slug: number_of_results
Required: false
Can have default value: true

Search recency Dropdown list

Label: Search recency
Helper text: Optionally restrict results to recent pages. Leave blank to search across all time.
Slug: search_recency
Required: false
Can have default value: true

Ingredients

Top result title The title of the top ranked search result.

Slug: top_result_title
Filter code: Perplexity.searchTheWeb.TopResultTitle
Type: String
Example: James Webb Space Telescope - NASA

Top result url The link to the top ranked search result.

Slug: top_result_url
Filter code: Perplexity.searchTheWeb.TopResultUrl
Type: Web URL
Example: https://www.nasa.gov/webb

Top result snippet A short excerpt from the top ranked search result.

Slug: top_result_snippet
Filter code: Perplexity.searchTheWeb.TopResultSnippet
Type: String
Example: The James Webb Space Telescope is the largest, most powerful space telescope ever built.

Top result date The publication date of the top ranked search result, when Perplexity could determine one.

Slug: top_result_date
Filter code: Perplexity.searchTheWeb.TopResultDate
Type: String
Example: 2026-01-15

All result urls A newline-separated list of the links for every returned search result.

Slug: all_result_urls
Filter code: Perplexity.searchTheWeb.AllResultUrls
Type: String
Example: https://www.nasa.gov/webb https://en.wikipedia.org/wiki/James_Webb_Space_Telescope

All result titles A newline-separated list of the titles for every returned search result, aligned with AllResultUrls.

Slug: all_result_titles
Filter code: Perplexity.searchTheWeb.AllResultTitles
Type: String
Example: James Webb Space Telescope - NASA James Webb Space Telescope - Wikipedia

Result count How many results were returned, as a string.

Slug: result_count
Filter code: Perplexity.searchTheWeb.ResultCount
Type: String
Example: 10

Applets using this Query