# Vaaya Firecrawl Search

> Vaaya Firecrawl Search is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Performs a web search using Firecrawl under the hood, returning crawled and structured web results for a given query

## Facts

- Endpoint: POST https://vaaya.ai/api/run/firecrawl/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-firecrawl-search-83d26234
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uglUs5bn1mTV7G9oyeVuj

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 vaaya-firecrawl-search-83d26234 -d '<json body>'
```

Example prompt: Search the web for recent information about AI agent frameworks in 2024 and give me a summary of what you find.

## When to prefer this

Choose this endpoint when you need real-time or recent web search results without managing your own Firecrawl API key or account. It is ideal for AI agents that need to gather information from the open web as part of a workflow — such as contact enrichment, competitive research, or content generation — and want a single pay-per-call interface without setup overhead.

## Known failure modes

- Empty results if the search query is too niche or obscure
- Rate limiting or timeout if the underlying Firecrawl service is overloaded
- Payment failure if the calling wallet has insufficient USDC balance for the $0.01 per-call fee
- Malformed or missing query parameter causing a 400-level error
- Results may be stale if Firecrawl's index has not recently crawled the relevant pages

## How this service works

Firecrawl — Search the web and return scraped results.

## Output

Returns structured web search results including URLs, page titles, and content snippets or crawled text from matching web pages relevant to the input query.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "query": {
       "type": "string",
       "minLength": 1
      },
      "limit": {
       "type": "integer",
       "exclusiveMinimum": 0
      }
     },
     "required": [
      "query"
     ],
     "additionalProperties": true,
     "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaaya-firecrawl-search-83d26234/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)