Countries
Free reference endpointGET
/v1/countriesList countries supported by country-based detection and filtering options.
Try in playgroundParameters
Optional
string
Search by country name, CCA2, or CCA3.
Americas | Europe | Africa | Asia | Oceania | Antarctic
Filter countries by region.
Status codes
200Country list returned.
400Invalid query params.
401Invalid, missing, or revoked API key.
429Rate limit exceeded.
Examples
cURL
curl "https://api.animaldetect.com/v1/countries?region=Europe" -H "Authorization: Bearer $ANIMAL_DETECT_API_KEY"Python
import os
import requests
response = requests.get(
"https://api.animaldetect.com/v1/countries?region=Europe",
headers={
"Authorization": "Bearer " + os.environ["ANIMAL_DETECT_API_KEY"],
"User-Agent": "MyApp/1.0 (ops@example.com)",
},
)
response.raise_for_status()
data = response.json()Node.js / Express
const response = await fetch(
'https://api.animaldetect.com/v1/countries?region=Europe',
{
headers: {
Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
},
}
)
const data = await response.json()Example response
{
"countries": [
{
"name": "France",
"cca2": "FR",
"cca3": "FRA",
"region": "Europe"
}
],
"total": 1
}