Country/state/city geotargeting

Targeting by Country

Add a –country– value to the username portion of the request string to target a specific country:

curl -x http://account-accountName-pipeline-pipelineName-country-US:[email protected]:7000 https://ipinfo.io

import requests

proxies = {
    'http': 'http://account-accountName-pipeline-pipelineName-country-US:[email protected]:7000',
    'https': 'https://account-accountName-pipeline-pipelineName-country-US:[email protected]:7000'
}

url = 'https://ipinfo.io'

response = requests.get(url, proxies=proxies)

print(response.status_code)
print(response.text)

const axios = require('axios');

const targetAddress = "http://ipinfo.io/json";
const getProxy = async () => {
  return {
    proxy: {
      host: "account-accountName-pipeline-pipelineName-country-US:[email protected]",
      port: 7000
    }
  }
}

const run = async () => {
  const res = await axios(targetAddress, getProxy());
  return res.data;
}


(async () => {
  var response = await run()
  console.log(response);
  console.log("DONE!")
})();

package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

func main() {
	proxyURL, err := url.Parse("http://account-accountName-pipeline-pipelineName-country-US:[email protected]:7000")
	if err != nil {
		fmt.Println(err)
		return
	}

	client := &http.Client{
		Transport: &http.Transport{
			Proxy: http.ProxyURL(proxyURL),
		},
	}

	url := "https://ipinfo.io"

	req, err := http.NewRequest("GET", url, nil)
	if err != nil {
		fmt.Println(err)
		return
	}

	resp, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer resp.Body.Close()

	fmt.Println(resp.StatusCode)

	body, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println(string(body))
}

Use ISO country codes to identify your target country, e.g. US, DE, BR (see the full list of ISO 3166 alpha-2 country codes). If no country parameter is specified, the target country will be randomized per each request.

If no peers are available in a supported country/state/city, Nimble IP will return a 525 response. For more information, see Nimble IP's Response Codes.

Targeting by US state

To target a US state, add a -state- value to the username:

curl -x http://account-accountName-pipeline-pipelineName-country-US-state-KS:[email protected]:7000 https://ipinfo.io

import requests

proxies = {
    'http': 'http://account-accountName-pipeline-pipelineName-country-US-state-KS:[email protected]:7000',
    'https': 'https://account-accountName-pipeline-pipelineName-country-US-state-KS:[email protected]:7000'
}

url = 'https://ipinfo.io'

response = requests.get(url, proxies=proxies)

print(response.status_code)
print(response.text)

const axios = require('axios');

const targetAddress = "http://ipinfo.io/json";
const getProxy = async () => {
  return {
    proxy: {
      host: "account-accountName-pipeline-pipelineName-country-US-state-KS:[email protected]",
      port: 7000
    }
  }
}

const run = async () => {
  const res = await axios(targetAddress, getProxy());
  return res.data;
}


(async () => {
  var response = await run()
  console.log(response);
  console.log("DONE!")
})();

package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

func main() {
	proxyURL, err := url.Parse("http://account-accountName-pipeline-pipelineName-country-US-state-KS:[email protected]:7000")
	if err != nil {
		fmt.Println(err)
		return
	}

	client := &http.Client{
		Transport: &http.Transport{
			Proxy: http.ProxyURL(proxyURL),
		},
	}

	url := "https://ipinfo.io"

	req, err := http.NewRequest("GET", url, nil)
	if err != nil {
		fmt.Println(err)
		return
	}

	resp, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer resp.Body.Close()

	fmt.Println(resp.StatusCode)

	body, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println(string(body))
}

Targeting a state is only available when the country parameter is set to US.

Targeting by city

To target a city, add a -city- value to the username:

curl -x http://account-accountName-pipeline-pipelineName-country-US-state-KS-city-wichita:[email protected]:7000 https://ipinfo.io

import requests

proxies = {
    'http': 'http://account-accountName-pipeline-pipelineName-country-US-state-KS-city-wichita:[email protected]:7000',
    'https': 'https://account-accountName-pipeline-pipelineName-country-US-state-KS-city-wichita:[email protected]:7000'
}

url = 'https://ipinfo.io'

response = requests.get(url, proxies=proxies)

print(response.status_code)
print(response.text)

const axios = require('axios');

const targetAddress = "http://ipinfo.io/json";
const getProxy = async () => {
  return {
    proxy: {
      host: "account-accountName-pipeline-pipelineName-country-US-state-KS-city-wichita:[email protected]",
      port: 7000
    }
  }
}

const run = async () => {
  const res = await axios(targetAddress, getProxy());
  return res.data;
}


(async () => {
  var response = await run()
  console.log(response);
  console.log("DONE!")
})();

package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

func main() {
	proxyURL, err := url.Parse("http://account-accountName-pipeline-pipelineName-country-US-state-KS-city-wichita:[email protected]:7000")
	if err != nil {
		fmt.Println(err)
		return
	}

	client := &http.Client{
		Transport: &http.Transport{
			Proxy: http.ProxyURL(proxyURL),
		},
	}

	url := "https://ipinfo.io"

	req, err := http.NewRequest("GET", url, nil)
	if err != nil {
		fmt.Println(err)
		return
	}

	resp, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer resp.Body.Close()

	fmt.Println(resp.StatusCode)

	body, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println(string(body))
}

You can retrieve a comprehensive list of supported countries, states, and cities by using the /location/cities endpoint of the Admin API.

Targeting geolocations with Authenticated IPs

When using an Authenticated IP, your geolocation targeting settings are defined only in the target pipeline's configuration. When defining/modifying a pipeline, you can choose a target location country, and states/cities will be displayed if they are available for the selected location.

You can create/modify your pipelines in one of two ways:

Using the Nimble IP page in the Nimble User Dashboard
Using the /account/pipelines endpoint of the Admin API.

PreviousNimble IP Functions NextControlling IP rotation

Last updated 1 year ago

hashtagTargeting by Country

hashtagTargeting by US state

hashtagTargeting by city

hashtagTargeting geolocations with Authenticated IPs

Targeting by Country

Targeting by US state

Targeting by city

Targeting geolocations with Authenticated IPs