# Metalift Web Search

> Metalift Web Search is a paid API for AI agents from app.metalift.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Accepts a search query and returns ranked SERP results (title, URL, snippet) as JSON, enabling AI agents to discover fresh URLs and sources without guessing links.

## Facts

- Endpoint: POST https://app.metalift.ai/v1/search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/metalift-web-search-09c5ca95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W5zn6z9Zg0FMoxQAopHqe

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 metalift-web-search-09c5ca95 -d '<json body>'
```

Example prompt: Search the web for 'best open-source LLM frameworks 2025' and give me the top ranked results with their titles, URLs, and snippets so I can decide which pages to look at next.

## When to prefer this

Use this endpoint when an AI agent needs to discover real URLs or sources before scraping, rather than guessing or hallucinating links. Prefer it over manual link construction when freshness matters, when you need ranked relevance, or when you don't have a search API key. Best suited as the first step in a search-then-scrape workflow. Choose this over a browser-based scrape when you only need surface-level discovery (title, URL, snippet) rather than full page content.

## Known failure modes

- Query too vague — returns low-quality or irrelevant results
- Insufficient USDC credits — payment rejected, request fails
- Rate limiting — too many requests in a short window
- Malformed request body — missing query field returns error
- Search index lag — very recent events may not appear in results

## Output

A JSON array of ranked SERP results, each containing a page title, URL, and text snippet extracted from the search result listing, ordered by relevance to the query.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1,
       "description": "Max results to return (default 10, max 20)"
      },
      "query": {
       "type": "string",
       "description": "Natural-language web search query. Returns ranked SERP hits (title, url, snippet) — not full page markdown."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/metalift-web-search-09c5ca95/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.metalift.ai](https://www.zero.xyz/host/app.metalift.ai/llms.txt)