# Web Search: Ranked Results

> Web Search: Ranked Results is a paid API for AI agents from pyfile-agent.taile3ff35.ts.net:10000, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

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:10000/data/search
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/web-search-ranked-results-24652c8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mibepGjUJvxCjLmt0bAHd

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 web-search-ranked-results-24652c8c
```

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

## When to prefer this

Use this endpoint when you need lightweight, fast web search results consisting of ranked page titles and URLs — ideal for agent workflows that need to discover relevant web pages, gather links for further processing, or surface current information without full page content. Prefer it over heavier scraping or content-extraction endpoints when just titles and URLs suffice.

## Known failure modes

- Missing or empty 'q' parameter returns an error or empty results
- Very high 'limit' values may be capped or ignored
- Queries returning no results yield an empty results array
- Network or upstream search provider downtime returns a 5xx error
- Malformed query strings may return unexpected results

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

## 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/web-search-ranked-results-24652c8c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pyfile-agent.taile3ff35.ts.net:10000](https://www.zero.xyz/host/pyfile-agent.taile3ff35.ts.net%3A10000/llms.txt)