Μετάβαση στο περιεχόμενο
GET /v1/search

Search by country name or code

Δοκιμάστε το ζωντανά

10 δωρεάν κλήσεις την ημέρα — χωρίς εγγραφή, χωρίς κλειδί API. Μέσω του gateway του oanor.

Προσαρμοσμένες κεφαλίδες (προαιρετικά)
api.oanor.com/gini-api

Δουλεύει. Πάρε ένα κλειδί API και χρησιμοποίησέ το στο έργο σου.

Λάβετε ένα κλειδί API

Αποσπάσματα κώδικα

curl "https://api.oanor.com/gini-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/gini-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/gini-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/gini-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Παράδειγμα απόκρισης

Πραγματική απόκριση αυτού του endpoint, από τον τελευταίο έλεγχο υγείας.

{
    "data": {
        "count": 2,
        "query": "south",
        "total": 2,
        "countries": [
            {
                "max": 64.8,
                "min": 57.8,
                "code": "ZA",
                "emoji": "🇿🇦",
                "alpha3": "ZAF",
                "latest": {
                    "gini": 63,
                    "year": 2014
                },
                "country": "South Africa",
                "history": [
                    {
                        "gini": 59.3,
                        "year": 1993
                    },
                    {
                        "gini": 57.8,
                        "year": 2000
                    },
                    {
                        "gini": 64.8,
                        "year": 2005
                    },
                    {
                        "gini": 63,
                        "year": 2008
                    },
                    {
                        "gini": 63.4,
                        "year": 2010
                    },
                    {
                        "gini": 63,
                        "year": 2014
                    }
                ]
            },
            {
                "max": 46.3,
                "min": 44,
                "code": "SS",
                "emoji": "🇸🇸",
                "alpha3": "SSD",
                "latest": {
                    "gini": 44,
                    "year": 2016
                },
                "country": "South Sudan",
                "history": [
                    {
                        "gini": 46.3,
                        "year": 2009
                    },
                    {
                        "gini": 44,
                        "year": 2016
                    }
                ]
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-08T18:25:06.548Z",
        "request_id": "de67bf71-5e63-47df-9631-19e031944992"
    },
    "status": "ok",
    "message": "Search results retrieved successfully",
    "success": true
}