Naar de inhoud
GET /v1/search

Find countries by (partial) name

Probeer het live

10 gratis calls per dag — geen registratie, geen API-key. Loopt via de oanor-gateway.

Aangepaste headers (optioneel)
api.oanor.com/countries-api

Het werkt. Haal een API-key op en gebruik hem in je project.

Verkrijg een API-sleutel

Codefragmenten

curl "https://api.oanor.com/countries-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/countries-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/countries-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/countries-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste health check.

{
    "data": {
        "count": 1,
        "query": "germany",
        "countries": [
            {
                "tld": [
                    ".de"
                ],
                "cca2": "DE",
                "cca3": "DEU",
                "ccn3": null,
                "name": "Germany",
                "latlng": [
                    51,
                    9
                ],
                "region": "Europe",
                "borders": [
                    "AUT",
                    "BEL",
                    "CZE",
                    "DNK",
                    "FRA",
                    "LUX",
                    "NLD",
                    "POL",
                    "CHE"
                ],
                "capital": [
                    "Berlin"
                ],
                "area_km2": 357114,
                "flag_png": "https://flagcdn.com/w320/de.png",
                "flag_svg": "https://flagcdn.com/de.svg",
                "languages": [
                    "German"
                ],
                "subregion": "Western Europe",
                "timezones": [],
                "continents": [
                    "Europe"
                ],
                "currencies": [
                    {
                        "code": "EUR",
                        "name": "euro",
                        "symbol": "€"
                    }
                ],
                "population": 83491249,
                "google_maps": null,
                "calling_code": "+49",
                "driving_side": null,
                "official_name": "Federal Republic of Germany"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-29T21:03:54.315Z",
        "request_id": "8b7febaa-a866-41fd-8b9f-d00404cd8c53"
    },
    "status": "ok",
    "message": "Search results retrieved successfully",
    "success": true
}