The Continent object represents a geographical continent in the Ping Proxies system. It serves as the highest level in the geographic hierarchy and contains essential information about continents including their identifiers, names, and aliases.

Key Attributes

AttributeTypeDescription
continent_idstringUnique identifier for the continent (e.g., eu for Europe)
continent_namestringFull name of the continent (e.g., Europe)
continent_aliasstringAlternative identifier or shorthand for the continent

Object Relationships

The Continent object sits at the top of the geographic hierarchy in the Ping Proxies API:

  • Countries: Each continent contains multiple countries
  • Subdivisions: Indirectly related through countries
  • Cities: Indirectly related through countries and subdivisions
  • Proxies: Proxies can be filtered or grouped by continent through their country associations

Continent

Countries

Subdivisions

Cities

Proxies

EndpointDescription
GET /public/user/continent/retrieve/{continent_id}Retrieve a specific continent by ID
GET /public/user/continent/searchSearch continents using various filters
GET /public/user/country/search?continent_id={continent_id}Find countries within a specific continent

Example Response

{
  "data": {
    "continent_id": "eu",
    "continent_name": "Europe",
    "continent_alias": "eu"
  },
  "message": "Continent successfully retrieved."
}

Usage Notes

  • Continents provide the broadest geographic categorization in the system
  • The continent_id typically uses a two-letter code (e.g., eu, na, as)
  • When filtering proxy locations, using continent-level filtering provides the broadest geographic targeting
  • The continent object is primarily used for reference and categorization rather than direct operations
  • For more precise geographic targeting, use the country, subdivision, or city objects instead

Continent Codes

The system uses the following standard continent codes:

CodeContinent
afAfrica
anAntarctica
asAsia
euEurope
naNorth America
ocOceania
saSouth America

These continent codes are consistent throughout the API and provide a standardized way to reference continents when performing geographic filtering or categorization.