GET
https://spideriq.di-atomic.com
/
api
/
v1
/
locations
/
countries
List Countries
curl --request GET \
  --url https://spideriq.di-atomic.com/api/v1/locations/countries \
  --header 'Authorization: Bearer <token>'
{
  "countries": [
    {
      "country_code": "<string>",
      "country_name": "<string>",
      "location_count": 123
    }
  ],
  "total": 123
}

​
Overview

Retrieve a list of all 240 countries in the location database, sorted alphabetically with location counts for each.

​
Response

​
countries
array
Array of country objects
​
total
integer
Total number of countries

​
Example

curl https://spideriq.di-atomic.com/api/v1/locations/countries \
  -H "Authorization: Bearer <your_token>"
Response: 
{
  "countries": [
    {
      "country_code": "AF",
      "country_name": "Afghanistan",
      "location_count": 58
    },
    {
      "country_code": "AL",
      "country_name": "Albania",
      "location_count": 35
    },
    {
      "country_code": "DZ",
      "country_name": "Algeria",
      "location_count": 156
    },
    {
      "country_code": "DE",
      "country_name": "Germany",
      "location_count": 2108
    },
    {
      "country_code": "FR",
      "country_name": "France",
      "location_count": 1140
    }
  ],
  "total": 240
}

​
Use Cases

  • Campaign planning: See available countries before creating campaigns
  • Coverage verification: Check which countries have location data
  • Region selection: Find country codes for filtering