Bright Data - 联盟 API 参考

初始设置

我们需要从销售/合作伙伴获取以下信息：

合作伙伴名称：仅限字母
他们希望使用的 DNS URL。该 DNS 名称应指向：brd.superproxy.io。
授权 IP，用于添加到我们的白名单。其他 IP 将被阻止调用我们的联盟 API。
从以下列表中选择要转售的产品：

代理类型	产品类型	所需信息
数据中心	旋转池	池大小、国家、每个国家的代理数量
	无限共享	国家列表、每个国家的 IP 数量
	无限专用	国家列表、每个国家的 IP 数量
ISP	旋转池	池大小、国家、每个国家的代理数量
	无限共享	国家列表、每个国家的 IP 数量
	无限专用	国家列表、每个国家的 IP 数量

高级联盟流程

为提供 Bright Data 代理服务，联盟应遵循以下流程：

在 Bright Data 设置联盟账户
对每个最终用户：在 Bright Data 中开通用户
对每个销售的产品：在 Bright Data 中设置区域（限制：每个用户最多 50 个区域）
每个区域将有自己的访问信息集：代理用户名和密码。

术语表

了解 Bright Data 的 /affiliate API 所需的重要术语。

合作伙伴前缀

Bright Data 分配给每个合作伙伴的两个字母前缀。所有用户/账户 ID 都会携带此前缀。本示例中使用 “tp_“。

用户/账户 ID

消费 Bright Data 服务的实体的唯一标识。每个联盟用户将获得一个以 tp_ 开头、后跟随机字母和数字的 Bright Data 账户 ID。例如：tp_fd821b5e

区域

在账户下，区域表示一个配置集。包含产品类型、数量及其他影响代理行为的信息。每个区域有自己的用户名和密码组合，即用户访问该区域代理服务所需的 PROXY 用户名和密码。

Superproxy

Bright Data 端的监听进程，接受初始代理请求，并建立到对等节点的隧道。Superproxy 接收请求并将其转发给对等节点。

对等节点

由代理 IP 地址标识的实际节点，将请求转发到目标。

用户名

为安全起见，代理用户名表示为长哈希。

示例

在本示例中，合作伙伴名称为 example，DNS URL 为 example.proxy.com。步骤 1：在 Bright Data 创建用户：

curl -X POST "https://api.brightdata.com/example/signup_shared_isp"

响应：

{"id":"tp_fd821b5e","zone":"shared_static_res","password":"g6n62fj88zju","api_token":"aca02446-392c-4283-ab51-71fd25fcb9da"}

用户/账户 ID 为 tp_fd821b5e，新区域名称为 shared_static_res。用户 ID 或账户 ID 等同于一个联盟用户。每个用户 ID（如 “account”）可在 Bright Data 上设置多个代理产品（“代理区域”），每个产品都有自己的配置和访问信息（代理用户/密码）。步骤 2：创建代理用户名以访问 Bright Data 代理服务（superproxy）

curl -X GET "https://api.brightdata.com/example/proxies?id=tp_fd821b5e&zone=shared_static_res"

注意请求查询参数，我们提供新的用户 ID 和区域名称。响应：

["example.proxy.com:31111:1a88cbd3954834b5050ae88acd14e9c48eb263207e742b87fedd41b3932b75525bec36774658924a6beaed9284635438:g6n62fj88zju"]

响应格式为 [PROXY_URL:PROXY_PORT:PROXY_USERNAME:PROXY_PASSWORD]步骤 3：测试代理区域

curl --proxy example.proxy.com:31111 --proxy-user 1a88cbd3954834b5050ae88acd14e9c48eb263207e742b87fedd41b3932b75525bec36774658924a6beaed9284635438:g6n62fj88zju "http://brdtest.com/myip.json"

步骤 4：控制使用限制默认情况下，用户创建时限额为 1KB。要扩展限额：

curl -X PUT "https://api.brightdata.com/example/usage_limit?id=tp_fd821b5e&zone=shared_static_res" -H "Content-Type: application/json" -d '{"limit": {"limit": 50000000}}'

响应：

{"unit":"bw","until":"2025-06-17T00:00:00.000Z","start":"2025-03-16T00:00:00.000Z","bust_action":"disable","limit":50000000,"zone":"shared_static_res"}

步骤 5：为同一用户创建另一个 dedicated_dc 类型的区域，名称为 new_dc，分配 2 个 IP

curl -X PUT "https://api.brightdata.com/example/zone?id=tp_fd821b5e&type=dedicated_dc&ips_amount=2&zone=new_dc"

响应：

{"id":"tp_fd821b5e","zone":"new_dc","password":"w1625fn55f4c"}

步骤 6：检查新区域分配的 IP

curl -X GET "https://api.brightdata.com/test_partner/ips?id=tp_fd821b5e&zone=new_dc"

响应：

{"ips":["152.39.152.207","168.151.126.63"]}

步骤 7：为每个 IP 创建访问新区域的代理用户名默认情况下 - 我们将轮换区域内的 IP。若要针对特定 IP，需要为每个 IP 生成一组用户/密码。生成方法：

curl -X GET "https://api.brightdata.com/example/proxies?id=tp_fd821b5e&zone=new_dc2&ips=168.151.126.63,152.39.152.207"

响应：

[
"example.proxy.com:31114:1a88cbd3954834b5050ae88acd14e9c4bd833ab19064869238b7c7213ae07b3e1b0bfb4e4f60f1b79ed72b1459c3091dba80251a30ee2773d9c848ccbe44fa50:u7yi034vn5ek",
"example.proxy.com:31111:1a88cbd3954834b5050ae88acd14e9c4bd833ab19064869238b7c7213ae07b3e8cdc0f32beb2ad83fa9032e8ac0da4693de714f411fee1764be3a524f4771a68:u7yi034vn5ek"
]

响应中，第一个数组元素使用 IP 152.39.152.207 的代理凭证，第二个为 168.151.126.63。注意：端口号可能从 31111 到 31114 不等，用于负载均衡。

待审核

无法访问的页面

Bright Data - 联盟 API 参考

初始设置

高级联盟流程

术语表

合作伙伴前缀

用户/账户 ID

区域

Superproxy

对等节点

用户名

示例

​初始设置

​高级联盟流程

​术语表

​合作伙伴前缀

​用户/账户 ID

​区域

​Superproxy

​对等节点

​用户名

​示例

初始设置

高级联盟流程

术语表

合作伙伴前缀

用户/账户 ID

区域

Superproxy

对等节点

用户名

示例