Targeting Options

This Endpoint returns available targeting parameters for different proxy types. Use these options to build precise proxy configuration requests.

Endpoint Permalink to Endpoint

GET https://api.evomi.com/public/settings

Authentication Permalink to Authentication

Requires API key in either:

• x-apikey header
• apikey query parameter

Example Request Permalink to Example Request

curl -X GET "https://api.evomi.com/public/settings" 
  -H "x-apikey: YOUR_API_KEY"

Response Structure Permalink to Response Structure

{
  "success": true,
  "data": {
    "rp": {
      "countries": {
       ...
      },
      "cities": {
        "data": [...]
      },
      "regions": {
        "data": [...]
      },
      "isp": {
        ...
      },
      "continents": {
        "europe": {
          "name": "Europe",
          "countries": {
           ...
          }
        }
      }
    }
  }
}

Proxy Types Permalink to Proxy Types

Field Breakdown Permalink to Field Breakdown

Countries Permalink to Countries

• Two-letter ISO country codes mapped to full names
• Example: "IN": "India"

Cities Permalink to Cities

• Nested structure with:
  • City names
  • Regional codes

ISP Targeting Permalink to ISP Targeting

"ISP_NAME": {
  "value": "network_identifier",
  "countryCode": "ISO_COUNTRY_CODE"
}

Continents Permalink to Continents

• Pre-grouped country sets
• Contains:
  • Continent name
  • Country name-to-code mapping
  • Example:

    "europe": {
      "name": "Europe",
      "countries": {
        "Germany": "DE",
        "France": "FR"
      }
    }

Usage Guidelines Permalink to Usage Guidelines

1. Use values exactly as returned in API responses
2. Combine multiple parameters for granular targeting:

   {
     "country": "DE",
     "city": "berlin",
   }
3. Missing parameters? Contact support for network expansions

Error States Permalink to Error States

{
  "error": "Internal server error",
  "success": false
}

• 401 Unauthorized: Invalid/missing API key
• 500 Internal Error: Temporary data unavailability