# Bright Data Web Unlocker via Vaaya

> Bright Data Web Unlocker via Vaaya is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Fetches pages protected by anti-bot systems (Cloudflare, DataDome, PerimeterX, CAPTCHAs) by rotating residential IPs and solving challenges, returning the final HTML or JSON envelope

## Facts

- Endpoint: POST https://vaaya.ai/api/run/brightdata/unblock?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bright-data-web-unlocker-via-vaaya-dcd3b0ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RmfAZPjKiryOpceXgJDLq

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 bright-data-web-unlocker-via-vaaya-dcd3b0ec -d '<json body>'
```

Example prompt: Fetch the product listing page at https://example-retailer.com/products/sneakers — it's behind Cloudflare and blocks bots, so use the residential IP unlocker with JavaScript rendering enabled and pull the raw HTML back.

## When to prefer this

Use this endpoint when a target URL actively blocks scrapers with Cloudflare, DataDome, PerimeterX, or CAPTCHA challenges that standard HTTP clients or data-center proxies cannot solve. It is the right choice when you need real residential exit IPs with automatic challenge-solving and retry logic, especially for geo-fenced content requiring a specific country. Prefer it over simpler fetch tools when the page has known bot detection or when previous scrape attempts returned block pages instead of content.

## Known failure modes

- URL is unreachable or returns a permanent error (site down)
- Country code is invalid or unsupported, causing a 400 error
- Anti-bot system is too aggressive even for residential IPs, resulting in a failed unblock
- Render timeout if JavaScript execution takes too long
- Rate limit or quota exceeded on the Bright Data backend
- Malformed URL input causing validation failure

## How this service works

Bright Data Web Unlocker — Fetch a page that actively BLOCKS scrapers: Cloudflare/DataDome/PerimeterX walls, CAPTCHA challenges, aggressive bot detection, geo-fenced content. Bright Data rotates residential exit IPs, solves challenges and retries internally, then returns the final page as `{ raw: "<html>…" }`. Pass `url`; optional `country` (2-letter geo), `render` (execute JS first), `format` ("raw" page, default, or "json" for their envelope with status/headers). This is the FIRST escalation …

## Output

Returns a JSON object with a `raw` field containing the final rendered or static HTML of the requested page after all anti-bot challenges have been solved; optionally returns a `json` format envelope including HTTP status code and response headers alongside the page body.

## 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",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri"
      },
      "format": {
       "enum": [
        "raw",
        "json"
       ],
       "type": "string"
      },
      "render": {
       "type": "boolean"
      },
      "country": {
       "type": "string",
       "maxLength": 2,
       "minLength": 2
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "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/bright-data-web-unlocker-via-vaaya-dcd3b0ec/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)