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

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 omitted
    Each dedicated residential IP refreshed costs $0.02/refresh/IP
 
Sample Response :
Response will output all allocated dedicated residential IPs in the Zone including the refreshed dedicated residential IPs.
{"vips":[{"vip":"tr_9121_07_antalya_10","country":"tr"},{"vip":"tr_9121_07_antalya_17","country":"tr"}]}
 
Shell
curl "https://brightdata.com/api/zone/ips/refresh" -H "Authorization: Bearer API_TOKEN" -d "{\"zone\":\"ZONE\",\"vips\":[\"vip1\",\"vip2\"]}"

Node.js

#!/usr/bin/env node
require('request-promise')({
	method: 'POST',
	url: 'https://brightdata.com/api/zone/ips/refresh',
	json: {'zone':'ZONE','vips':['vip1','vip2']},
	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\",\"vips\":[\"vip1\",\"vip2\"]}";
    String res = Executor.newInstance()
      .addHeader("Authorization", "Bearer API_TOKEN")
      .execute(Request.Post("https://brightdata.com/api/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://brightdata.com/api/zone/ips/refresh"),
      Headers = {
        {"Authorization", "Bearer API_TOKEN"}
      },
      Content = new StringContent(JsonConvert.SerializeObject(new {
        zone = "ZONE", vips = [ "vip1", "vip2" ]
      }), 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','vips':['vip1','vip2']}
headers = {'Authorization': 'Bearer API_TOKEN'}
r = requests.post('https://brightdata.com/api/zone/ips/refresh', data=json.dumps(data), headers=headers)
print(r.content)

Was this article helpful?