# pyfile-agent Web Search

> pyfile-agent Web Search 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-09-15).

Returns ranked web search results (title + URL) for a given query string, with optional result count limit

## Facts

- Endpoint: GET https://pyfile-agent.taile3ff35.ts.net/data/search
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pyfile-agent-web-search-7dc61cea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ps64EXbdkghsnBxv8Wh-K

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-agent-web-search-7dc61cea
```

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

## When to prefer this

Choose this endpoint when you need ranked web search results (title + URL pairs) returned quickly and cheaply at $0.003/call via x402 micropayment. Prefer it for lightweight discovery tasks where you only need titles and URLs rather than full page content. It is especially suited to agentic workflows that need to programmatically search the web without a browser or a full scraping pipeline.

## Known failure modes

- Missing or empty 'q' parameter returns no results or an error
- Very long or malformed query strings may cause unexpected results
- limit parameter exceeding reasonable bounds may be ignored or clamped
- Service may return fewer results than requested if web index coverage is limited
- Network timeout on the upstream search backend returns a 5xx error
- Rate limiting or payment failure returns a 402 or 429 response

## 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 echoed query string and an array of ranked result objects, each with a 'title' (page title) and 'url' (page URL) field, ordered by relevance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string"
      },
      "limit": {
       "type": "number"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "query": {
     "type": "string"
    },
    "results": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "url": {
        "type": "string"
       },
       "title": {
        "type": "string"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pyfile-agent-web-search-7dc61cea/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)