Overview

Geo-targeting is one of the most powerful features of the Geonode Proxy API. It allows you to route your proxy requests through specific geographic locations, giving you precise control over where your traffic appears to originate from. This is essential for location-specific testing, content access, market research, and compliance with regional requirements.

What is Geo-Targeting?

Geo-targeting enables you to specify the geographic location of the IP address that will be used for your proxy requests. Instead of getting a random IP from anywhere in the world, you can target:

• Countries: Route traffic through specific countries (e.g., United States, United Kingdom, Germany)
• States/Regions: Narrow down to specific states or provinces within a country
• Cities: Target specific cities for even more precise location control
• ISPs/ASNs: Route through specific Internet Service Providers or Autonomous System Numbers

Why Use Geo-Targeting?

Geo-targeting allows you to route your proxy requests through specific geographic locations, giving you control over where your traffic appears to originate from.

Targeting Levels

Geonode supports multiple levels of geo-targeting, from broad to highly specific:

Country-Level Targeting

The broadest level of targeting. Simply append -country-<country_code> to your username to route traffic through a specific country. This is ideal when you need traffic from a particular country but don't need more specific location control.

Example: username-country-US routes traffic through the United States.

State-Level Targeting

For countries with states or provinces, you can target specific regions. This is useful when you need traffic from a particular state but don't need city-level precision.

Example: username-country-US-state-california routes traffic through California.

City-Level Targeting

The most precise geographic targeting option. Target specific cities within a country for maximum location accuracy.

Example: username-country-US-city-newyork routes traffic through New York City.

ISP/ASN-Level Targeting

For advanced use cases, you can target specific Internet Service Providers or Autonomous System Numbers. This is useful when you need traffic from a particular ISP or network infrastructure.

Example: username-type-residential-country-US-asn-12345 routes traffic through a specific ASN in the United States.

Available Endpoints

This section provides endpoints for different geo-targeting options:

• Perform Country Targeting: Route traffic through specific countries
• Perform State Targeting: Target specific states or regions
• Perform City Targeting: Target specific cities
• Perform ISP/ASN Targeting: Route through specific ISPs or ASNs

Finding Available Locations

Before you can target a location, you need to know what locations are available. Use the Retrieve Available Geo-locations endpoint to get a comprehensive list of:

• Available countries and their codes
• Cities within each country
• States/regions within each country
• ISPs and ASNs available in each location

Best Practices

Before targeting a location, verify that it's available using the available geo-locations endpoint. Choose the appropriate level of targeting for your needs—use country-level if you don't need more specific location control.