# Vaaya Firecrawl Extract

> Vaaya Firecrawl Extract 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).

Extracts structured data from web pages using Firecrawl's extraction engine via Vaaya's agent-ready proxy, billed per call with no API key setup required.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/firecrawl/extract
- 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-extract-4959285a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bZlCYS2Kv-WDeFQGLoSD7

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-extract-4959285a -d '<json body>'
```

Example prompt: Extract the company name, founding year, CEO name, and headquarters location from https://openai.com/about — give me the results as structured fields.

## When to prefer this

Choose this endpoint when you need to extract structured data from a specific webpage without setting up a Firecrawl account or managing API keys. It is ideal for agent workflows that need one-off or frequent web data extraction billed per call via x402, especially when orchestrating multiple tools through Vaaya's unified interface.

## Known failure modes

- Target URL is behind a login wall or bot protection — returns empty or partial results
- URL is unreachable or returns a non-200 status — extraction fails with an error
- Requested fields not present on the page — returns null or empty values for those fields
- Ambiguous extraction prompt leads to inconsistent field mapping
- Rate limits or payment failure at $0.01 USDC per call — transaction rejected

## How this service works

Firecrawl — Extract structured data from URLs using a schema.

## Output

Returns structured JSON containing the extracted fields from the target URL as defined by the provided schema or prompt. Typically includes the requested data points parsed from the page content, along with metadata about the extraction.

## 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": {
      "urls": {
       "type": "array",
       "items": {
        "type": "string",
        "format": "uri"
       }
      },
      "prompt": {
       "type": "string"
      },
      "schema": {
       "type": "object",
       "additionalProperties": {}
      }
     },
     "required": [
      "urls"
     ],
     "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-extract-4959285a/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)
