# Pyfile x402 Web Search API

> Pyfile x402 Web Search API is a paid API for AI agents from pyfile-agent.taile3ff35.ts.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-02).

Returns ranked web search results (title + URL) for a given query, powered by DuckDuckGo, via pay-per-call x402 micropayment.

## Facts

- Endpoint: GET https://pyfile-agent.taile3ff35.ts.net/web/search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pyfile-x402-web-search-api-b85560df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qPaZdqRdShxG77dAg9Fre

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 pyfile-x402-web-search-api-b85560df
```

Example prompt: Search the web for 'x402 agent payments protocol' and give me the top 8 results with their titles and URLs.

## When to prefer this

Choose this endpoint when an AI agent needs live, ranked web search results without a large API contract or subscription — especially in x402-enabled micropayment environments. It is ideal for agents that need occasional or low-volume web lookups priced at $0.003 per call, and where DuckDuckGo's privacy-respecting index is acceptable. Prefer it over heavyweight search APIs (Google Custom Search, Bing) when cost-per-call simplicity and x402 compatibility matter more than volume discounts or advanced filtering.

## Known failure modes

- Empty results array if query matches no indexed pages
- Rate limiting or payment failure if x402 micropayment is not processed
- Malformed or missing 'q' parameter returns an error or empty response
- DuckDuckGo backend unavailability causes 5xx or timeout
- Result count less than requested 'limit' if fewer results exist

## How this service works

Web search: ranked results (title + url) for a query. ?q=x402+agent+payments&limit=8

## Output

A JSON object containing the original query string, the source (duckduckgo.com/html), a count of results returned, and an array of result objects each with a 'title' and 'url' field, ranked by relevance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "query": "x402 agent payments",
  "source": "duckduckgo.com/html",
  "results": [
   {
    "url": "https://x402.org",
    "title": "x402: Internet-native payments"
   },
   {
    "url": "https://example.com/agent-payments",
    "title": "Agent payments guide"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pyfile-x402-web-search-api-b85560df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pyfile-agent.taile3ff35.ts.net](https://www.zero.xyz/host/pyfile-agent.taile3ff35.ts.net/llms.txt)