Account management

  • Get total balance through API

    API endpoint: GET /api/customer/balance Sample Response: {"balance":456,"pending_costs":123} balance : the amount of money in your account pending_costs : the amount of money you will be billed for, as of this moment, in the next ...

  • Get Zone info

    API endpoint: GET /api/zone Sample Response: {"ips":"any","password":["PASSWORD"],"plans":[{"start":"2019-07-15T18:08:59.269Z","type":"static","ips_type":"shared","ip_alloc_preset":"shared_block","bandwidth":"payperusage"}]}   Shel...

  • Add a Zone

    API endpoint: POST /api/zone POST body : zone [JSON] [Required] name=NAME [string] - Zone name plan [JSON] [Required] type="static|resident|unblocker" [string] 'static' : Datacenter, ISP 'resident' : Residential, Mobile, SE...

  • Remove Zone

    API endpoint: DELETE /api/zone   Shell curl -X DELETE "https://api.brightdata.com/zone" -H "Content-Type: application/json" -H "Authorization: Bearer API_TOKEN" -d "{\"zone\":\"ZONE\"}" Node.js #!/usr/bin/env node require('request-...

  • Get Zone passwords

    API endpoint: GET /api/zone/passwords Sample Response: {"passwords":["psw1","psw2"]}   Shell curl "https://api.brightdata.com/zone/passwords?zone=ZONE" -H "Authorization: Bearer API_TOKEN" Node.js #!/usr/bin/env node require('reque...

  • Get Zone permissions

    API endpoint: GET /api/zone/permissions Sample Response: {"perms":["city","google"]}   Shell curl "https://api.brightdata.com/zone/permissions?zone=ZONE" -H "Authorization: Bearer API_TOKEN" Node.js #!/usr/bin/env node require('req...

  • Get Zone status

    API endpoint: GET /api/zone/status Sample Response: {"status":"active"}   Shell curl "https://api.brightdata.com/zone/status?zone=ZONE" -H "Authorization: Bearer API_TOKEN" Node.js #!/usr/bin/env node require('request-promise')({ ...

  • Get active Zones

    API endpoint: GET /api/zone/get_active_zones Sample Response: [{"name":"ZONE1","type":"dc"}]   Shell curl "https://api.brightdata.com/zone/get_active_zones" -H "Authorization: Bearer API_TOKEN" Node.js #!/usr/bin/env node require('...

  • Get Zone Static(Datacenter/ISP) IPs

    API endpoint: GET /api/zone/ips Optional Parameter: ip_per_country=true to get the total amount of IPs per country Sample Response: {"ips":[{"ip":"1.1.1.1","maxmind":"au","ext":{"dbip":"au","ip2location":"au","google":"us"}},{"ip":...

  • Get live status of Static(Datacenter/ISP) Zone and IPs with connectivity problem

    API endpoint: GET /api/zone/ips/unavailable Sample Response: {"zone1":["1.1.1.1","100.1.1.2"],"zone10":["2.1.1.1"]}   Shell curl "https://api.brightdata.com/zone/ips/unavailable" -H "Authorization: Bearer API_TOKEN" Node.js #!/usr/...

  • Add Static(Datacenter/ISP) IPs

    API endpoint: POST /api/zone/ips POST body Required : customer=CUSTOMER [string] zone=ZONE [string] count[integer] Optional : country: new IPs' country (e.g. us) country_city: new IPs' city (e.g. us-chicago)   Sample Response...

  • Remove Static(Datacenter/ISP) IPs

    API endpoint: DELETE /api/zone/ips Sample Response:Response will output the IPs removed.{"ips":["ip1","ip2"]}   Shell curl -X DELETE "https://api.brightdata.com/zone/ips" -H "Content-Type: application/json" -H "Authorization: Beare...

  • Remove dedicated residential IPs

    API endpoint: DELETE /api/zone/vips Sample Response:The response will output the dedicated residential IPs removed.["us_209_wa_seattle_0","us_7922_ca_fresno_0"]   Shell curl -X DELETE "https://api.brightdata.com/zone/vips" -H "Cont...

  • Refresh Static(Datacenter/ISP) IPs

    API endpoint: POST /api/zone/ips/refresh POST body Required : zone=ZONE [string] Optional : ips=["ip1","ip2"]: IPs to refresh* Note : If refresh is needed for all allocated IPs, then ips parameter should be omittedSee pricing fo...

  • Refresh dedicated residential IPs

    API endpoint: POST /api/zone/ips/refresh POST body Required : zone=ZONE [string] Optional : vips=["vip1","vip2"]: IPs to refresh* Note : If refresh is needed for all allocated IPs, then vips parameter should be omittedEach dedic...

  • Migrate Static(Datacenter/ISP) IPs between zones

    API endpoint: POST /api/zone/ips/migrate POST body from=ZONE1 Zone which IPs will be migrated from to=ZONE1 Zone to which IPs will be migrated ips=['ip1','ip2'] Array of ips which should be migrated   Sample Response :Response...

  • Switch 100% uptime ON/OFF in a Static zone

    API endpoint: POST /api/zone/switch_100uptime POST body zone=ZONE active=0|1 0: disable '100% uptime | 1: activate '100% uptime   Shell curl "https://api.brightdata.com/zone/switch_100uptime" -H "Content-Type: application/json...

  • Add domain to Zone whitelist/blacklist

    API endpoint: POST /api/zone/domain_perm POST body zone=ZONE type=whitelist|blacklist domain=d1.com d2.com space separated list of domains Sample Response :Response will output domains whitelist and blacklist in the Zone inclu...

  • Remove domain from Zone whitelist/blacklist

    API endpoint: DELETE /api/zone/domain_perm DELETE body zone=ZONE type=whitelist|blacklist domain=d1.com d2.com space separated list of domains Sample Response:Response will output the remaining domains in the specified 'type' ...

  • Turn on/off Zone

    API endpoint: POST /api/zone/change_disable POST body zone=ZONE disable=0|1 to activate the zone the value should be 0, otherwise 1 Sample Response : {"plan":{"start":"2019-07-15T18:08:59.269Z","type":"static","ips_type":"shar...

  • Get account status

    API endpoint: GET /api/status Sample Response: {"status":"active"}   Shell curl "https://api.brightdata.com/status" -H "Authorization: Bearer API_TOKEN" Node.js #!/usr/bin/env node require('request-promise')({ url: 'https://api.br...

  • Change account status

    API endpoint: PUT /api/status PUT body status=suspend_manual|active Sample Response : {"status":"suspend_manual"}   Shell curl -X PUT "https://api.brightdata.com/status" -H "Content-Type: application/json" -H "Authorization: B...

  • Get a list of whitelisted IPs for a specific Zone

    API endpoint: GET /api/zone/whitelist Parameter: zones=ZONE - To get a list of whitelisted IPs for all your Zones : zones=* Sample Response: {"ZONE":["127.0.0.1"]} {"ZONE1":["1.1.1.1","2.2.2.2"],"ZONE2":["any"]}   Shell curl "https...

  • Add IP to Zone whitelist

    API endpoint: POST /api/zone/whitelist POST body zone=ZONE - can be skipped to affect all your zones when adding a single IP / list of IP / IP subnet ip - can be in one of the following formats Add a single IP [string] - ip="1.2...

  • Remove IP from Zone whitelist

    API endpoint: DELETE /api/zone/whitelist DELETE body zone=ZONE - can be skipped to affect all your zones ip - can be in one of the following formats Delete a single IP [string] - ip="1.2.1.2" Delete a IP subnet [string] - ip="10...

  • Get a list of blacklisted IPs for a specific Zone

    API endpoint: GET /api/zone/blacklist Parameter: zones=ZONE - To get a list of blacklisted IPs for all your Zones : zones=* Sample Response: {"ZONE":["127.0.0.1"]} {"ZONE1":["127.0.0.1"],"ZONE2":["127.0.0.2"]}   Shell curl "https:/...

  • Add IP to Zone blacklist

    API endpoint: POST /api/zone/blacklist POST body zone=ZONE - can be skipped to affect all your zones ip - can be in one of the following formats Add a single IP [string] - ip="1.2.1.2" Add a IP range [string] - ip="1.2.1.2-1.2.1...

  • Remove IP from Zone blacklist

    API endpoint: DELETE /api/zone/blacklist DELETE body zone=ZONE - can be skipped to affect all your zones ip - can be in one of the following formats Delete a single IP [string] - ip="1.2.1.2" Delete a IP range [string] - ip="1.2...