Отворени данни

Публичен API на ТокТук

Локациите на станциите, цените и състоянието на всяко гнездо в реално време — като обикновени JSON файлове, без регистрация и без ключ. За навигации, приложения, карти и AI асистенти. Само за четене: през API не може да се стартира или спира зареждане.

Адреси

Каталог

GET https://api.toktuk.bg/v1/locations.geojson

Всички публични станции като GeoJSON FeatureCollection: координати, адрес, квартал, брой гнезда (Type 2), мощност, EVSE ID, цени и статус на станцията (active — работи, planned/installed — предстои). Обновява се на 1 минута; може да се кешира до 5 минути.

На живо

GET https://api.toktuk.bg/v1/live.json

Състоянието на всяко гнездо: status (Available, Preparing, Charging, SuspendedEV, Finishing, Faulted, Unavailable, Offline), available (true/false — ползвай това за решения), status_updated_at. Обновява се на 5 секунди; не го изтегляй по-често от веднъж на 15 секунди.

Общ формат: schema_version (сега 1), generated_at в UTC (ISO 8601), координатите в GeoJSON са [дължина, ширина]. Непознати полета се игнорират — ще добавяме нови, без да махаме стари. При временна грешка пазете последния валиден отговор и показвайте часа му.

Пример

{
  "schema_version": 1,
  "generated_at": "2026-10-11T12:00:05+00:00",
  "license": "CC-BY-4.0",
  "stations": [
    {
      "id": "TT-SOF-MUS-001",
      "status": "active",
      "online": true,
      "out_of_service": false,
      "evses": [
        { "evse_no": 1, "evse_id": "BG*TTK*E*SOF*MUS*001*1", "plug_type": "Type 2",
          "status": "Available", "available": true,
          "status_updated_at": "2026-10-11T11:58:40+00:00" }
      ]
    }
  ]
}

Условия

  • Лиценз CC BY 4.0. Данните може да се ползват свободно, включително търговски, с посочване на източника „ТокТук — toktuk.bg“.
  • Както са. Състоянието е моментно: гнездо, свободно сега, може да е заето след минута. Не носим отговорност за решения, взети по тези данни.
  • Без лични данни. Публикуваме само състояние на оборудване, никога информация за клиенти или сесии.
  • Разумно ползване. Файловете са малки; при по-висок обем или въпроси пишете на office@toktuk.bg.

Планираме MCP сървър за AI асистенти, когато мрежата порасне. Дотогава асистентите могат да четат двата файла директно.

Виж станциите на картата.

Станции Контакти