Proxy API (synchronous)
Use the Bright Data Proxy REST API to proxy API (Synchronous). GET /request submits or retrieves async proxy jobs; returns 200 OK with JSON.
Authorizations
在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。
认证方法:
- 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
- 在请求的 Authorization 头中包含 API Key
- 格式:
Authorization: Bearer YOUR_API_KEY
示例:
了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?
Query Parameters
将为您的请求提供服务的代理区域名称。
请求的目标 URL。
通过代理请求原始 HTML 的格式为 raw。
请求 JSON 响应的格式为 json。
raw, json 通过代理请求 HTML 的方法为 GET。
请求通过的代理所在的国家代码。
请求通过的代理所在的城市名称,必须定义国家。
在数据中心和 ISP 区域中支持预配置城市,在住宅和移动网络中默认支持。
请求通过的代理所在的邮政编码,必须定义国家。
仅在住宅网络中支持。
请求通过的代理所在的 ASN 代码,必须定义国家。
仅在住宅网络中支持。
仅适用于移动网络:请求通过的运营商代码。
仅在移动网络中支持。
设置在代理上的客户端操作系统。
仅在住宅和移动网络中支持。
使用 local 或 remote 设置域名映射是在客户端本地还是在远程代理节点上完成。
local, remote 客户端传递的字符串以标记会话,所有具有相同 session 参数的请求将被传递到相同的代理节点。
在数据中心和 ISP 区域中:将请求转发到由 ip 标识的特定代理。
在 住宅 和 移动 区域中:将请求转发到由 gip 标识的特定代理组。
在请求中包含唯一的 c_tag 标志。响应中,业务端会在头部返回相同的标志。此无缝交换确保每个响应都绑定到其对应的请求,消除混淆并简化数据管理。
将参数设置为 true 会指示通过 Bright Data 超级代理(数据中心代理,而非代理节点本身)处理请求。
Response
成功