# TextToSTL Web Search (search-read)

> TextToSTL Web Search (search-read) is a paid API for AI agents from api.texttostl.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-16).

Performs a web search and returns the top result pages' titles, URLs, and extracted text content

## Facts

- Endpoint: POST https://api.texttostl.com/api/x402/search-read
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/texttostl-web-search-search-read-3ed062f9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EufK7nFytD-v791VLNi5x

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 texttostl-web-search-search-read-3ed062f9 -d '<json body>'
```

Example prompt: Search the web for 'best open-source 3D modeling tools for beginners' and bring back the top 3 results including their text content.

## When to prefer this

Use this endpoint when you need to search the live web and read the text content of results in a single call, especially in a pay-per-use, no-account-needed context via x402 micropayments. Prefer this over browser-based scraping when you need structured search results with extracted text rather than raw HTML.

## Known failure modes

- Missing required 'query' field returns a validation error
- Query returns no results for highly niche or malformed searches
- Page text extraction may be empty for JavaScript-heavy or paywalled pages
- Payment failure via x402 if insufficient USDC balance
- Rate limiting or timeout if many pages are requested simultaneously

## How this service works

Pay-per-call 3D-printable STL generation from text prompts. Cookie cutters, stamps, and jewelry. x402 payments, no account needed.

## Output

Returns a JSON object containing the original query string and an array of search result objects, each with a URL, page title, and extracted text body from the page. Typically returns 1–5 results depending on the 'pages' parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "pages": {
   "type": "integer",
   "description": "How many top results to fetch and read"
  },
  "query": {
   "type": "string",
   "description": "Web search query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "results"
 ],
 "properties": {
  "query": {
   "type": "string"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "url": {
      "type": "string"
     },
     "text": {
      "type": "string"
     },
     "title": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/texttostl-web-search-search-read-3ed062f9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.texttostl.com](https://www.zero.xyz/host/api.texttostl.com/llms.txt)