geoapi.ge
ავტომობილების მონაცემების API

ბრენდები, მოდელები, თაობები და სპეციფიკაციები — ერთი API-ით

მიიღეთ ბრენდების, მოდელების, თაობების, მოდიფიკაციებისა და ტექნიკური მახასიათებლების სტრუქტურირებული მონაცემები. გამოიყენეთ REST API ან მზა ვიჯეტი.

Free გეგმა · 0 ₾ · 1 000 წარმატებული მოთხოვნა თვეში

თქვენი აპლიკაცია · მოთხოვნა
GET/api/v1/brands/toyota/models
Authorization: Bearer geoapi_sk_••••
GeoAPI
brand → model → generation → modification
პასუხი · JSON200 OKX-Quota-Remaining
{
  "data": [{ "id": "10", "slug": "camry",
             "name": "Camry", "generations_count": 1 }],
  "meta": { "page": 1, "per_page": 100, "total": 1 }
}
მაგალითი OpenAPI სპეციფიკაციიდან
კატალოგი

2026-11-02 · GET /api/v1/coverage

  1. 315ბრენდი
  2. 4 727მოდელი
  3. 10 277თაობა
  4. 421 613მოდიფიკაცია
  • 421 613 სპეციფიკაცია ·ძრავი, გადაცემათა კოლოფი, წამყვანი, ზომები, საწვავი
  • 3 070 მოდელის ბაზარი
  • 47 მლნ+ კომპლექტაციის ჩანაწერი
  • 951 ფოტო ·API v1-ში, photo_url-ით
რას იღებთ

ექვსი დონე — ბრენდიდან აღჭურვილობამდე

ყველა დონე თავისი endpoint-ით, ფილტრებით და pagination-ით.

01

ბრენდი

id, slug, name, synonyms[], logo_url_light/dark

GET /brands
02

მოდელი

brand_id, slug, name, markets[], generations_count

GET /brands/{slug}/models
03

თაობა

name, year_start, year_end, body_types[], chassis_code

GET /models/{id}/generations
04

მოდიფიკაცია

engine_volume_cc, transmission, drive_type, body_type

GET /generations/{id}/modifications
05

სპეციფიკაციები

engine{volume_cc, fuel, power_hp}, transmission, consumption

GET /modifications/{id}/specs
06

აღჭურვილობა

standard / optional / not_available

GET /modifications/{id}/equipment
ერთი მოთხოვნა

სტრუქტურირებული JSON — მზა გამოსაყენებლად

ფილტრები: year_from, year_to, body, fuel, drive, transmission, q, modified_after. გვერდზე 100 ჩანაწერი (max 1000).

ლიმიტები ყოველ პასუხში: X-RateLimit-* და X-Quota-* შეცდომები ერთ ფორმატში: {error:{code,message}} კოდის მაგალითები: cURL, JavaScript, Node.js, Python, PHP
# გასაღები მხოლოდ Authorization header-ში
curl https://geoapi.ge/api/v1/modifications/1000/specs \
  -H "Authorization: Bearer $GEOAPI_API_KEY"
200 OKX-RateLimit-Limit: 15 · X-Quota-Limit: 1000
{
  "data": {
    "modification_id": "1000",
    "engine": { "volume_cc": 2494, "fuel": "petrol",
                "power_hp": 200 },
    "dimensions": null
  }
}
ინტეგრაცია

აირჩიეთ თქვენთვის მოსახერხებელი გზა

REST API

14 GET endpoint, JSON, Bearer ავტორიზაცია, pagination და ფილტრები.

ჩასაშენებელი ვიჯეტი

მზა კასკადური არჩევა თქვენს საიტზე. საჯარო გასაღები geoapi_pk_ და დაშვებული origin-ები.

◇ ახალი

SDK · CLI · MCP

TypeScript SDK და CLI ჩამოიტვირთება geoapi.ge-დან. MCP სერვერი AI ასისტენტებისთვის: Claude, Codex და Cursor.

როგორ დავიწყოთ

ოთხი ნაბიჯი პირველ პასუხამდე

01

დარეგისტრირდით

Free გეგმა — 0 ₾, 1 000 წარმატებული მოთხოვნა თვეში.

02

დაადასტურეთ ელფოსტა

საიდუმლო გასაღების შექმნისთვის აუცილებელია.

03

შექმენით პროექტი და გასაღები

geoapi_sk_ ჩანს მხოლოდ ერთხელ — შეინახეთ.

04

გაგზავნეთ პირველი მოთხოვნა

REST API ან ვიჯეტი — ერთი მრიცხველით.

კითხვები

ხშირად დასმული კითხვები

სხვა კითხვა? მოგვწერეთ: hello@geoapi.ge

რომელი მოთხოვნები ითვლება ლიმიტში?

მხოლოდ წარმატებული (HTTP 200) პასუხები, მათ შორის ცარიელი სია. შეცდომები ლიმიტს არ ხარჯავს.

რა მოხდება ლიმიტის ამოწურვისას?

API აბრუნებს 429-ს კოდით MONTHLY_QUOTA_EXCEEDED. გეგმის წუთის ლიმიტის გადაჭარბებისას (Free — წუთში 15 მოთხოვნა) — RATE_LIMIT_EXCEEDED და Retry-After.

შემიძლია ვიჯეტის და API-ს ერთად გამოყენება?

დიახ. ორივე ერთ მრიცხველს იყენებს, რომელსაც ანგარიშის ყველა პროექტი იზიარებს.

VIN დეკოდირება გაქვთ?

არა — ეს მიმდინარე მოცულობაში არ შედის.

დაიწყეთ უფასოდ

1 000 წარმატებული მოთხოვნა თვეში. გეგმის გაზრდა — ნებისმიერ დროს, შემცირება — გადახდილი ვადის ბოლოს.

ანგარიშის შექმნა ტარიფები