Country

​

Key Attributes

​

Object Relationships

• Continent: Each country belongs to a specific continent
• Subdivisions: Countries contain multiple subdivisions (states, provinces, regions)
• Cities: Countries contain multiple cities directly or through subdivisions
• Proxies: Proxies are physically located within countries
• Products: Products may be region-specific and tied to particular countries
• Services: Services may be region-specific and tied to particular countries

​

Related Endpoints

​

Example Response

{
  "data": {
    "continent_id": "eu",
    "country_alias": "fr",
    "country_id": "fr",
    "country_is_european_union": true,
    "country_name": "France"
  },
  "message": "Country successfully retrieved."
}

​

Usage Notes

• The country_id uses the ISO 3166-1 alpha-2 standard (e.g., “us” for United States, “gb” for United Kingdom)
• Country objects are most commonly used as filters when:
  • Searching for proxies in specific geographic regions
  • Generating residential proxy lists with geographic targeting
  • Purchasing region-specific proxy services
  • Analyzing usage patterns across different geographic regions
• The country_is_european_union flag is particularly useful for compliance with GDPR and other EU-specific regulations
• For more granular geographic targeting, combine country filters with subdivision and city filters
• When working with products and services, country_id is commonly used to identify region-specific offerings

​

Geographic Hierarchy

1. Continent: The broadest geographic division
2. Country: Countries within continents
3. Subdivision: States, provinces, or regions within countries
4. City: Specific cities within subdivisions