Whitelisting

Reference for whitelisting endpoints for Per GB Residential Proxies.

Use whitelisting to limit Residential proxy access to approved source IPs.

Whitelisting controls who can connect.

Country, city, and ISP control where the proxy exits from.

To add or update allowed IPs, use IP Whitelist.

Format requirements

When you pass country, city, or ISP, use the values returned by the lookup APIs.

Use Locations (Per ISP) to fetch valid country and city values.

Example response:

[
  {
    "country": {
      "name": "Spain",
      "value": "-co-Spain",
      "locations": [
        {
          "label": "Adra, Andalusia",
          "value": "-co-Spain-st-Andalusia-ci-Adra",
          "country": "Spain",
          "state": "Andalusia",
          "city": "Adra"
        },
        {
          "label": "Aguadulce, Andalusia",
          "value": "-co-Spain-st-Andalusia-ci-Aguadulce",
          "country": "Spain",
          "state": "Andalusia",
          "city": "Aguadulce"
        }
      ]
    }
  }
]

Use:

• country: Spain

• city: Adra

Get the correct ISP format

Use ISP (Per Location) with the location query parameter.

Then use the returned ISP value.

Example response:

[
  {
    "name": "AS174 Cogent Communications, LLC",
    "country": "Spain",
    "value": "174",
    "available": true
  }
]

Use:

• carrier: 174

Example

If you want Spain, Adra, Andalusia, and carrier AS174, use:

country=Spain
city=Adra
carrier=174