cURL
curl --request GET \
--url https://api.brightdata.com/trials/free_tier \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.brightdata.com/trials/free_tier"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.brightdata.com/trials/free_tier', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.brightdata.com/trials/free_tier",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.brightdata.com/trials/free_tier"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.brightdata.com/trials/free_tier")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brightdata.com/trials/free_tier")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"is_enabled": true,
"included_credits": 5000,
"used_credits": 3,
"left_credits": 4997
}账户与状态
获取免费套餐积分
使用 Bright Data 账号管理 API 的 GET /trials/free_tier 获取账户的免费套餐是否已启用,以及包含、已用和剩余的免费套餐积分。此端点不接受任何参数,响应始终包含 4 个字段,速率限制为每个 IP 地址每分钟 600 个请求、每小时 36,000 个请求。
GET
/
trials
/
free_tier
cURL
curl --request GET \
--url https://api.brightdata.com/trials/free_tier \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.brightdata.com/trials/free_tier"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.brightdata.com/trials/free_tier', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.brightdata.com/trials/free_tier",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.brightdata.com/trials/free_tier"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.brightdata.com/trials/free_tier")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brightdata.com/trials/free_tier")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"is_enabled": true,
"included_credits": 5000,
"used_credits": 3,
"left_credits": 4997
}GET /trials/free_tier 端点返回您的 Bright Data 账户的免费套餐积分:免费套餐是否已启用,以及包含、已用和剩余的积分数量。返回值与控制面板账单概览页面上的免费积分卡片一致。
将您的 API key 粘贴到授权字段中。要获取 API key,请创建账号,并查看如何生成新的 API key?
如何查看我的免费套餐积分?
使用您的 API key 调用GET /trials/free_tier。此端点不接受任何参数:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.brightdata.com/trials/free_tier"
{
"is_enabled": true,
"included_credits": 5000,
"used_credits": 3,
"left_credits": 4997
}
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.brightdata.com/trials/free_tier" \
| jq '.left_credits'
响应结构是怎样的?
响应始终包含相同的四个字段,字段类型也始终相同:| 字段 | 类型 | 说明 |
|---|---|---|
is_enabled | boolean | 账户已启用免费套餐时为 true,包括所有积分已用完的情况 |
included_credits | number | 当前周期包含的免费积分 |
used_credits | number | 当前周期已使用的免费积分 |
left_credits | number | 当前周期剩余的免费积分 |
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 没有针对此端点的错误代码。
相关页面
授权
在 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
示例:
Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df
了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?
此页面对您有帮助吗?