დოკუმენტაცია

curl "https://geoapi.ge/api/v1/brands?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/brands?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/brands?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/brands?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "1",
            "slug": "toyota",
            "name": "Toyota",
            "synonyms": [
                "Тойота"
            ],
            "is_lcv_or_commercial": false,
            "logo_url_light": null,
            "logo_url_dark": null,
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 120
    },
    "collection": {
        "count": 1,
        "total": 120,
        "pages": 120,
        "next": "/api/v1/brands?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/brands?page=1&limit=1",
        "last": "/api/v1/brands?page=120&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/brands/toyota/models?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/brands/toyota/models?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/brands/toyota/models?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/brands/toyota/models?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "690",
            "brand_id": "1",
            "slug": "camry",
            "name": "Camry",
            "markets": [
                "JP",
                "US"
            ],
            "has_generations": true,
            "generations_count": 1,
            "photo_url": "https://geoapi.ge/api/v1/models/690/photo",
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 40
    },
    "collection": {
        "count": 1,
        "total": 40,
        "pages": 40,
        "next": "/api/v1/brands/toyota/models?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/brands/toyota/models?page=1&limit=1",
        "last": "/api/v1/brands/toyota/models?page=40&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/models/690/years?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/models/690/years?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/models/690/years?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/models/690/years?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "2018",
            "year": 2018
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 8
    },
    "collection": {
        "count": 1,
        "total": 8,
        "pages": 8,
        "next": "/api/v1/models/690/years?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/models/690/years?page=1&limit=1",
        "last": "/api/v1/models/690/years?page=8&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/models/690/generations?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/models/690/generations?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/models/690/generations?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/models/690/generations?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "100",
            "model_id": "690",
            "slug": "xv70",
            "name": "XV70",
            "year_start": 2017,
            "year_end": 2024,
            "period_text": "2017–2024",
            "body_type": "sedan",
            "body_types": [
                "sedan"
            ],
            "chassis_code": "XV70",
            "steering_wheel": "left",
            "market": null,
            "display_label": "XV70 · 2017–2024",
            "photo_url": "https://geoapi.ge/api/v1/models/690/photo",
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 3
    },
    "collection": {
        "count": 1,
        "total": 3,
        "pages": 3,
        "next": "/api/v1/models/690/generations?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/models/690/generations?page=1&limit=1",
        "last": "/api/v1/models/690/generations?page=3&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/models/690/photo" \
  -H "Authorization: Bearer geoapi_sk_…" \
  -o photo.jpg

// Server-side only. Fetch the photo with the secret key, then serve or store it yourself.
const response = await fetch("https://geoapi.ge/api/v1/models/690/photo", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
if (response.ok) {
  const type = response.headers.get('Content-Type');
  const bytes = Buffer.from(await response.arrayBuffer());
}

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/models/690/photo", headers={'Authorization': 'Bearer geoapi_sk_…'})
with urllib.request.urlopen(request) as response:
    open('photo.jpg', 'wb').write(response.read())

$ch = curl_init("https://geoapi.ge/api/v1/models/690/photo");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
file_put_contents('photo.jpg', curl_exec($ch));

HTTP/1.1 200 OK
Content-Type: image/jpeg
ETag: W/"…"
X-Quota-Remaining: 999

<image bytes>

curl "https://geoapi.ge/api/v1/generations/100/modifications?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/generations/100/modifications?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/generations/100/modifications?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/generations/100/modifications?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "1000",
            "generation_id": "100",
            "name": "2.5",
            "engine_volume_cc": 2494,
            "transmission": "automatic",
            "drive_type": "fwd",
            "body_type": "sedan",
            "year_start": 2018,
            "year_end": 2024,
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 6
    },
    "collection": {
        "count": 1,
        "total": 6,
        "pages": 6,
        "next": "/api/v1/generations/100/modifications?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/generations/100/modifications?page=1&limit=1",
        "last": "/api/v1/generations/100/modifications?page=6&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/modifications/1000/specs" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/modifications/1000/specs", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/modifications/1000/specs", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/modifications/1000/specs");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": {
        "modification_id": "1000",
        "engine": {
            "volume_cc": 2494,
            "fuel": "petrol",
            "power_hp": 200
        },
        "transmission": {
            "type": "automatic",
            "drive": "fwd"
        },
        "dimensions": null,
        "performance": null,
        "consumption": {
            "city_l": 9.1,
            "highway_l": 5.9,
            "combined_l": 7.4,
            "unit": "L/100km"
        }
    }
}

curl "https://geoapi.ge/api/v1/modifications/1000/equipment" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/modifications/1000/equipment", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/modifications/1000/equipment", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/modifications/1000/equipment");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": {
        "modification_id": "1000",
        "standard": [
            {
                "id": "1",
                "category": "Safety",
                "name": "ABS",
                "value": null
            }
        ],
        "optional": [
            {
                "id": "2",
                "category": "Comfort",
                "name": "Sunroof",
                "value": null
            }
        ],
        "not_available": [],
        "unknown": []
    }
}

curl "https://geoapi.ge/api/v1/modifications/1000" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/modifications/1000", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/modifications/1000", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/modifications/1000");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": {
        "id": "1000",
        "name": "2.5",
        "engine_volume_cc": 2494,
        "transmission": "automatic",
        "drive_type": "fwd",
        "body_type": "sedan",
        "year_start": 2018,
        "year_end": 2024,
        "brand": {
            "id": "1",
            "slug": "toyota",
            "name": "Toyota"
        },
        "model": {
            "id": "690",
            "slug": "camry",
            "name": "Camry"
        },
        "generation": {
            "id": "100",
            "name": "XV70"
        },
        "modified": "2026-01-01T00:00:00Z"
    }
}

curl "https://geoapi.ge/api/v1/modifications?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/modifications?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/modifications?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/modifications?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "1000",
            "name": "2.5",
            "brand_id": "1",
            "model_id": "690",
            "generation_id": "100",
            "engine_volume_cc": 2494,
            "transmission": "automatic",
            "drive_type": "fwd",
            "body_type": "sedan",
            "fuel": "petrol",
            "year_start": 2018,
            "year_end": 2024,
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 5000
    },
    "collection": {
        "count": 1,
        "total": 5000,
        "pages": 5000,
        "next": "/api/v1/modifications?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/modifications?page=1&limit=1",
        "last": "/api/v1/modifications?page=5000&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/engines?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/engines?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/engines?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/engines?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "1000",
            "volume_cc": 2494,
            "fuel": "petrol",
            "power_hp": 200,
            "brand_id": "1",
            "model_id": "690",
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 5000
    },
    "collection": {
        "count": 1,
        "total": 5000,
        "pages": 5000,
        "next": "/api/v1/engines?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/engines?page=1&limit=1",
        "last": "/api/v1/engines?page=5000&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/bodies?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/bodies?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/bodies?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/bodies?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "sedan",
            "name": "sedan",
            "count": 1520,
            "modified": null
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 12
    },
    "collection": {
        "count": 1,
        "total": 12,
        "pages": 12,
        "next": "/api/v1/bodies?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/bodies?page=1&limit=1",
        "last": "/api/v1/bodies?page=12&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/fuel?limit=1" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/fuel?limit=1", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/fuel?limit=1", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/fuel?limit=1");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "1000",
            "fuel": "petrol",
            "city_l": 9.1,
            "highway_l": 5.9,
            "combined_l": 7.4,
            "brand_id": "1",
            "model_id": "690",
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 1,
        "total": 5000
    },
    "collection": {
        "count": 1,
        "total": 5000,
        "pages": 5000,
        "next": "/api/v1/fuel?page=2&limit=1",
        "prev": null,
        "first": "/api/v1/fuel?page=1&limit=1",
        "last": "/api/v1/fuel?page=5000&limit=1"
    }
}

curl "https://geoapi.ge/api/v1/colors?limit=2" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/colors?limit=2", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/colors?limit=2", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/colors?limit=2");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "data": [
        {
            "id": "690",
            "model_id": "690",
            "brand_id": "1",
            "name": "white",
            "verified": true,
            "photo_url": "https://geoapi.ge/api/v1/models/690/photo",
            "modified": "2026-01-01T00:00:00Z"
        },
        {
            "id": "12",
            "model_id": "12",
            "brand_id": "1",
            "name": "red",
            "verified": false,
            "photo_url": null,
            "modified": "2026-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 2,
        "total": 2400
    },
    "collection": {
        "count": 2,
        "total": 2400,
        "pages": 1200,
        "next": "/api/v1/colors?page=2&limit=2",
        "prev": null,
        "first": "/api/v1/colors?page=1&limit=2",
        "last": "/api/v1/colors?page=1200&limit=2"
    }
}

curl "https://geoapi.ge/api/v1/coverage" \
  -H "Authorization: Bearer geoapi_sk_…"

// Server-side only: a geoapi_sk_ key must never reach the browser. In a web page use the widget (geoapi_pk_).
const response = await fetch("https://geoapi.ge/api/v1/coverage", {
  headers: { Authorization: 'Bearer geoapi_sk_…' },
});
console.log(await response.json());

import urllib.request
request = urllib.request.Request("https://geoapi.ge/api/v1/coverage", headers={'Authorization': 'Bearer geoapi_sk_…'})
print(urllib.request.urlopen(request).read().decode())

$ch = curl_init("https://geoapi.ge/api/v1/coverage");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer geoapi_sk_…'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

{
    "brands_count": 120,
    "models_count": 1800,
    "generations_count": 4200,
    "models_with_generations_count": 1650,
    "models_without_generations_count": 150,
    "modifications_count": 52000,
    "photos_count": 556,
    "generations_with_photo_urls_count": 410,
    "measured_at": "2026-01-01T00:00:00Z"
}