# Targeting Options

Source: https://docs.evomi.com/public-api/endpoints/settings/

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

## Endpoint
`GET https://api.evomi.com/public/settings`

## Authentication
Requires API key in either:
- `x-apikey` header
- `apikey` query parameter

## Example Request
```bash
curl -X GET "https://api.evomi.com/public/settings" 
  -H "x-apikey: YOUR_API_KEY"
```

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

## Proxy Types
| Code | Proxy Type          |
|------|---------------------|
| rp   | Premium Residential | 
| rpc  | Core Residential    | 
| mp   | Mobile              |
| dcp  | Datacenter          | 

## Field Breakdown

### Countries
- Two-letter ISO country codes mapped to full names
- Example: `"IN": "India"`

### Cities
- Nested structure with:
  - City names
  - Regional codes

### ISP Targeting
```json
"ISP_NAME": {
  "value": "network_identifier",
  "countryCode": "ISO_COUNTRY_CODE"
}
```

### Continents
- Pre-grouped country sets
- Contains:
  - Continent name
  - Country name-to-code mapping
  - Example:
    ```json
    "europe": {
      "name": "Europe",
      "countries": {
        "Germany": "DE",
        "France": "FR"
      }
    }
    ```

## Usage Guidelines
1. Use values exactly as returned in API responses
2. Combine multiple parameters for granular targeting:
   ```json
   {
     "country": "DE",
     "city": "berlin",
   }
   ```
3. Missing parameters? Contact support for network expansions

## Error States
```json
{
  "error": "Internal server error",
  "success": false
}
```
- `401 Unauthorized`: Invalid/missing API key
- `500 Internal Error`: Temporary data unavailability