1. Bright Data
  2. API documentation
  3. Account management

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 omitted
    See pricing for refreshing datacenter IPs
  • country: new IPs' country (e.g. us)
  • country_city: new IPs' city (e.g. us-chicago)
 
Sample Response :
Response will output all allocated IPs in the Zone including the refreshed IPs.
{"ips":["1.1.1.1","1.1.1.2","1.1.1.3"],"new_ips":["1.1.1.1","1.1.1.3"]}
 
Shell
curl "https://api.brightdata.com/zone/ips/refresh" -H "Content-Type: application/json" -H "Authorization: Bearer API_TOKEN" -d "{\"zone\":\"ZONE\",\"ips\":[\"ip1\",\"ip2\"]}"

Node.js

#!/usr/bin/env node
require('request-promise')({
	method: 'POST',
	url: 'https://api.brightdata.com/zone/ips/refresh',
	json: {'zone':'ZONE','ips':['ip1','ip2']},
	headers: {'Authorization': 'Bearer API_TOKEN'},
}).then(function(data){ console.log(data); },
	function(err){ console.error(err); });

Java

package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
  public static void main(String[] args) throws Exception {
    String body = "{\"zone\":\"ZONE\",\"ips\":[\"ip1\",\"ip2\"]}";
    String res = Executor.newInstance()
      .addHeader("Authorization", "Bearer API_TOKEN")
      .execute(Request.Post("https://api.brightdata.com/zone/ips/refresh")
      .bodyString(body, ContentType.APPLICATION_JSON))
      .returnContent().asString();

    System.out.println(res)
  }
}

C#

using System;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;

public class Program {
  public static async Task Main() {
    var client = new HttpClient();
    var requestMessage = new HttpRequestMessage {
      Method = HttpMethod.Post,
      RequestUri = new Uri("https://api.brightdata.com/zone/ips/refresh"),
      Headers = {
        {"Authorization", "Bearer API_TOKEN"}
      },
      Content = new StringContent(JsonConvert.SerializeObject(new {
        zone = "ZONE", ips = [ "ip1", "ip2" ]
      }), Encoding.UTF8, "application/json"))
    };
    var response = await client.SendAsync(requestMessage);
    var responseString = await response.Content.ReadAsStringAsync();
    Console.WriteLine(responseString);
  }
}

Python

#!/usr/bin/env python
print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
import requests

data = {'zone': 'ZONE','ips':['ip1','ip2']}
headers = {'Authorization': 'Bearer API_TOKEN'}
r = requests.post('https://api.brightdata.com/zone/ips/refresh', data=data, headers=headers)
print(r.content)

Was this article helpful?