# Perplexity Web Search

> Perplexity Web Search is a paid API for AI agents from pplx.x402.paysponge.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12, last successful call 2026-07-17).

Search the web and retrieve relevant page contents including titles, URLs, snippets, and dates with filtering options.

## Facts

- Endpoint: POST https://pplx.x402.paysponge.com/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Last successful call: 2026-07-17
- Success rate: 67% of calls made through Zero
- Rating: 4.0 / 5 from 1 review
- Activations on Zero: 3
- Tags: x402
- Canonical page: https://www.zero.xyz/c/perplexity-web-search-75e58732
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zrZm9Wi-uRzMARxn0aNTW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability perplexity-web-search-75e58732 -d '<json body>'
```

Example prompt: Search the web for the latest developments in quantum computing from the past week, returning up to 10 results and limiting to english-language pages.

## When to prefer this

Choose this endpoint when you need live web search results with actual page content snippets and metadata (dates, URLs) rather than a conversational AI-generated answer. Ideal for research tasks requiring source attribution, recency filtering, or domain-scoped searches. Prefer over the Agent/Sonar endpoints when you want raw search results rather than a synthesized response.

## Known failure modes

- Query missing — returns 422 if 'query' field is absent
- Country code invalid — must be exactly 2-character ISO 3166-1 alpha-2
- Date filter format errors — dates must be supplied as MM/DD/YYYY
- Domain filter exceeds 20 entries — returns validation error
- Payment failure — x402 payment of $0.01 USDC not fulfilled, returns 402
- max_results out of range — must be between 1 and 20
- Language code invalid — must be 2-character ISO 639-1 codes

## How this service works

Search the Web

## Output

An array of up to 20 web page results, each containing the page title, URL, a content snippet, publication date, and last-updated date, plus a response ID and server timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "allOf": [
  {
   "type": "object",
   "required": [
    "query"
   ],
   "properties": {
    "query": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "array",
       "items": {
        "type": "string"
       }
      }
     ],
     "title": "Query",
     "description": "Search query (required)"
    },
    "country": {
     "type": "string",
     "maxLength": 2,
     "minLength": 2,
     "description": "ISO 3166-1 alpha-2 country code"
    },
    "max_tokens": {
     "type": "integer",
     "default": 10000,
     "maximum": 1000000,
     "minimum": 1,
     "description": "Maximum tokens for context"
    },
    "max_results": {
     "type": "integer",
     "default": 10,
     "maximum": 20,
     "minimum": 1,
     "description": "Maximum number of results to return"
    },
    "max_tokens_per_page": {
     "type": "integer",
     "default": 4096,
     "maximum": 1000000,
     "minimum": 1,
     "description": "Maximum tokens per page"
    },
    "search_language_filter": {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2
     },
     "maxItems": 20,
     "description": "ISO 639-1 language codes (2-character max)"
    }
   }
  },
  {
   "type": "object",
   "title": "SearchDomainFilter",
   "properties": {
    "search_domain_filter": {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 253
     },
     "maxItems": 20,
     "description": "Limit search results to specific domains (max 20)"
    }
   }
  },
  {
   "type": "object",
   "title": "DateFilters",
   "properties": {
    "search_recency_filter": {
     "enum": [
      "hour",
      "day",
      "week",
      "month",
      "year"
     ],
     "type": "string",
     "title": "SearchRecencyFilter",
     "description": "Time-based recency filter for search results"
    },
    "search_after_date_filter": {
     "type": "string",
     "title": "Date",
     "description": "Input: MM/DD/YYYY, Output: YYYY-MM-DD"
    },
    "last_updated_after_filter": {
     "type": "string",
     "title": "Date",
     "description": "Input: MM/DD/YYYY, Output: YYYY-MM-DD"
    },
    "search_before_date_filter": {
     "type": "string",
     "title": "Date",
     "description": "Input: MM/DD/YYYY, Output: YYYY-MM-DD"
    },
    "last_updated_before_filter": {
     "type": "string",
     "title": "Date",
     "description": "Input: MM/DD/YYYY, Output: YYYY-MM-DD"
    }
   }
  }
 ],
 "ti
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ApiSearchResponse",
 "required": [
  "results",
  "id"
 ],
 "properties": {
  "id": {
   "type": "string",
   "title": "Id"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ApiSearchPage",
    "required": [
     "title",
     "url",
     "snippet"
    ],
    "properties": {
     "url": {
      "type": "string",
      "title": "Url",
      "description": "URL of the page"
     },
     "date": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Date",
      "description": "Publication date of the page"
     },
     "title": {
      "type": "string",
      "title": "Title",
      "description": "Title of the page"
     },
     "snippet": {
      "type": "string",
      "title": "Snippet",
      "description": "Content snippet extracted from the page"
     },
     "last_updated": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Last Updated",
      "description": "Date the page was last updated"
     }
    },
    "description": "A single page from search results"
   },
   "title": "Results"
  },
  "server_time": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Server Time"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/perplexity-web-search-75e58732/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pplx.x402.paysponge.com](https://www.zero.xyz/host/pplx.x402.paysponge.com/llms.txt)