tarifebi.ge Developer API

საქართველოს საწვავის სადგურების, აფთიაქებისა და ვალუტის გადამცვლელი პუნქტების ფასები და ლოკაციები — ერთი REST API-ით. მონაცემი ცოცხლად ახლდება (ფასები დღეში 2-ჯერ, ვალუტა ყოველ 2 საათში).

Authentication

ყველა /v1/* მოთხოვნას სჭირდება API გასაღები. გადმოეცი header-ით:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://dev.tarifebi.ge/v1/fuel/prices"

ალტერნატივა: X-Api-Key: YOUR_API_KEY. გასაღები სერვერის მხარეს უნდა ინახებოდეს — არასდროს ატვირთო ბრაუზერის/მობილურის კოდში.

Endpoints

GET /v1/fuel/prices

ბრენდების საწვავის ფასები. პარამეტრი: ?brand=socar (არასავალდებულო).

GET /v1/fuel/stations

საწვავის სადგურების ლოკაციები. ?brand= ?city= ?near=lat,lng&radius=km ?limit= ?offset=.

GET /v1/pharmacies

აფთიაქების ფილიალების ლოკაციები. იგივე location-პარამეტრები.

GET /v1/currency/rates

NBG ოფიციალური + კომერციული ბანკების ყიდვა/გაყიდვის კურსი. ?currency=USD ?bank=bog.

GET /v1/currency/exchanges

ვალუტის გადამცვლელი პუნქტების ლოკაციები. location-პარამეტრები.

GET /v1/me

შენი გასაღების plan, scopes და დღევანდელი გამოყენება. GET /v1/health — auth-ის გარეშე.

Example response

{
  "dataset": "fuel", "type": "stations",
  "as_of": "2026-06-30 03:00:12",
  "count": 2,
  "data": [
    { "id": 6719, "name": "ვისოლი", "brand": "ვისოლ",
      "address": "შალვა ნუცუბიძის ქუჩა, 125",
      "lat": 41.7271703, "lng": 44.7341864,
      "hours": "24/7", "distance_km": 1.204 }
  ]
}

Errors & limits

პასუხის header-ები: X-RateLimit-Limit, X-RateLimit-Remaining, X-Quota-Limit, X-Quota-Used, Retry-After.

გამოწერა

API გასაღების მისაღებად და plan-ის ასარჩევად დაგვიკავშირდი: info@tarifebi.ge. მიუთითე რომელი dataset-(ებ)ი გჭირდება (fuel / pharmacy / currency) და სავარაუდო მოცულობა.