web-unlocker

# Web Unlocker API 参考 ## 目录 - [概述](#概述) - [身份验证](#身份验证) - [REST API (推荐)](#rest-api-推荐) - [代理接口](#代理接口) - [所有请求参数](#所有请求参数) - [特殊标头](#特殊标头) - [响应结构](#响应结构) - [异步请求](#异步请求) - [输出格式](#输出格式) - [功能](#功能) - [计费模式](#计费模式) - [最佳实践](#最佳实践) - [反模式](#反模式) --- ## 概述 Web Unlocker 是 Bright Data 基于 HTTP 的解锁代理。它自动选择最佳代理网络，处理反机器人保护，解决验证码，并重试失败的请求。适用于非交互式数据提取，您可以通过简单的 HTTP 请求获取网页的 HTML、JSON、markdown 或截图。 **何时使用 Web Unlocker 与其他 API：** | 需求 | 使用 | |------|-----| | 按 URL 抓取任何网页 | Web Unlocker | | 搜索引擎结果 (Google, Bing) | SERP API | | 从已知平台获取结构化数据 | Web Scraper API | | 点击、滚动、填写表单、运行 JS | Browser API | | 浏览器自动化库 (Playwright/Puppeteer) | Browser API, 非 Web Unlocker | --- ## 身份验证 从 Bright Data 控制面板 → 账户设置，或从您区域的概览选项卡获取您的 API 密钥。 bash # 环境变量 (推荐) export BRIGHTDATA_API_KEY="your-api-key" export BRIGHTDATA_UNLOCKER_ZONE="your-zone-name" --- ## REST API (推荐) **端点:** `POST https://api.brightdata.com/request` **标头:** `Authorization: Bearer YOUR_API_KEY` ### 最小请求 python import requests response = requests.post( "https://api.brightdata.com/request", headers={"Authorization": f"Bearer {API_KEY}"}, json={ "zone": "YOUR_ZONE_NAME", "url": "https://example.com", "format": "raw" } ) print(response.text) javascript const response = await fetch("https://api.brightdata.com/request", { method: "POST", headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ zone: "YOUR_ZONE_NAME", url: "https://example.com", format: "raw" }) }); const html = await response.text(); bash curl -H "Authorization: Bearer $BRIGHTDATA_API_KEY" -H "Content-Type: application/json" -d '{"zone":"'"$BRIGHTDATA_UNLOCKER_ZONE"'","url":"https://example.com","f