Skip to main content
GET
cURL
GET /trials/free_tier 端点返回您的 Bright Data 账户的免费套餐积分:免费套餐是否已启用,以及包含、已用和剩余的积分数量。返回值与控制面板账单概览页面上的免费积分卡片一致。
将您的 API key 粘贴到授权字段中。要获取 API key,请创建账号,并查看如何生成新的 API key?

如何查看我的免费套餐积分?

使用您的 API key 调用 GET /trials/free_tier。此端点不接受任何参数:
响应是一个包含四个字段的 JSON 对象:
如只需输出剩余积分,可使用 jq 过滤响应:

响应结构是怎样的?

响应始终包含相同的四个字段,字段类型也始终相同: 当 is_enabled 为 false 时,included_credits、used_credits 和 left_credits 均为 0。

如何判断免费套餐积分是否已用完?

同时检查 is_enabled 和 left_credits。如果响应中 is_enabled: true 且 left_credits: 0,表示免费套餐仍处于启用状态,但本月积分已用完。免费积分在每月 1 日续期,详见免费套餐。 如果响应中 is_enabled: false,表示您的账户未启用免费套餐,三个 *_credits 字段均为 0。

GET /trials/free_tier 的速率限制是多少?

GET /trials/free_tier 允许每个 IP 地址每分钟 600 个请求、每小时 36,000 个请求。超出限制后,Bright Data 会减慢传入请求的处理速度,而不会阻止这些请求。

GET /trials/free_tier 会返回特定错误吗?

不会。GET /trials/free_tier 没有针对此端点的错误代码。

相关页面

  • 免费套餐。每月 5,000 个免费积分适用的产品,以及各产品的积分消耗方式。
  • 总余额。账户余额、信用额度、预付款和待付用量费用。
  • 费用明细导出。按产品、zone、数据集或爬虫拆分的每日账户费用。

授权

Authorization
string
header
必填

在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。

认证方法:

  1. 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
  2. 在请求的 Authorization 头中包含 API Key
  3. 格式: Authorization: Bearer YOUR_API_KEY

示例:

了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?

响应

200 - application/json

成功

is_enabled
boolean
必填

账户已启用免费套餐时为 true,包括所有积分已用完的情况。为 false 时,所有 *_credits 字段均为 0。

示例:

true

included_credits
number
必填

当前周期包含的免费积分。

示例:

5000

used_credits
number
必填

当前周期已使用的免费积分。

示例:

3

left_credits
number
必填

当前周期剩余的免费积分。

示例:

4997