Actigator API

Інтегруйте дані від Actigator у свій сайт, застосунок або бот за допомогою Actigator API.

Спробувати безкоштовно API Explorer

Отримайте API ключ безкоштовно

Зареєструйтесь в Actigator — API ключ буде доступний одразу в розділі Налаштування → Actigator API. 100 запитів на день безкоштовно. Зареєструватись →

Зміст

Швидкий старт
Аутентифікація
GET /v1/fish
GET /v1/spots
GET /v1/forecast
Ліміти
Приклади коду
API Explorer LIVE

Швидкий старт

Actigator API — це відкритий інтерфейс для інтеграції даних Actigator у ваші продукти. Усі відповіді надаються у форматі JSON.

Спробуйте у браузері

Скористайтеся нашим інтерактивним API Explorer щоб спробувати всі ендпоінти зі своїм ключем.

Зробіть перший запит

Прогноз клювання окуня в Києві (fish_id=14):
GET https://api.actigator.com/v1/forecast
    ?api_key=YOUR_API_KEY
    &fish_id=14
    &lat=50.4501
    &lng=30.5234
    &lang=uk
Відповідь:
{
  "fish": { "id": 14, "name": "Окунь звичайний" },
  "location": { "lat": 50.4501, "lng": 30.5234 },
  "forecast": {
    "today": {
      "date": "2026-05-14",
      "f_index": 74,
      "hourly": [45, 52, 68, 74, 71, 65, 58, 42]
    },
    "tomorrow": {
      "date": "2026-05-15",
      "f_index": 68,
      "hourly": [40, 48, 62, 68, 65, 58, 50, 38]
    },
    "day_after_tomorrow": {
      "date": "2026-05-16",
      "f_index": 55,
      "hourly": [30, 38, 50, 55, 52, 45, 40, 32]
    }
  }
}

Що таке F- Індекс?

F-Індекс — число від 0 до 100, яке показує наскільки активно клюватиме конкретна риба. Розраховується за допомогою регресійного аналізу на основі даних з реальних рибальських звітів, погоди, фази місяця та геомагнітної активності.

Аутентифікація

Усі запити до API потребують аутентифікації через API ключ. Передавайте його як параметр запиту:

GET https://api.actigator.com/v1/forecast?api_key=YOUR_API_KEY&...

Зберігайте ключ у безпеці

Не публікуйте API ключ у публічних репозиторіях або клієнтському коді. Якщо ключ скомпрометовано — перегенеруйте його в налаштуваннях акаунта.

Коди відповіді

КодОпис
200Успішно
400Невірний запит — відсутні або некоректні параметри
401Не авторизовано — невірний або відсутній API ключ
429Забагато запитів — добовий ліміт вичерпано
500Помилка сервера — погодний сервіс недоступний
GET

/v1/fish

Повертає список усіх видів риб, доступних для прогнозу. Використовуйте fish_id у запиті /v1/forecast.

Swagger
ПараметрТипОбов'язковоОпис
api_keystringтакВаш API ключ
langstringніМова: uk (за замовчуванням) або ru
Запит:
GET https://api.actigator.com/v1/fish?api_key=YOUR_API_KEY&lang=uk
Відповідь:
[
  { "id": 14, "name": "Окунь звичайний" },
  { "id": 27, "name": "Щука звичайна" },
  { "id": 8,  "name": "Короп звичайний" },
  ...
]
GET

/v1/spots

Повертає список місць риболовлі, доданих до вашого акаунту. Використовуйте spot_id у запиті /v1/forecast замість координат.

Swagger
ПараметрТипОбов'язковоОпис
api_keystringтакВаш API ключ
langstringніМова: uk (за замовчуванням) або ru
Запит:
GET https://api.actigator.com/v1/spots?api_key=YOUR_API_KEY
Відповідь:
[
  {
    "id": 42,
    "name": "Десна біля Чернігова",
    "location": "Чернігів, Україна",
    "lat": 51.4939,
    "lng": 31.2947
  },
  ...
]
GET

/v1/forecast

Головний ендпоінт. Повертає прогноз клювання F-Індекс на сьогодні, завтра та післязавтра для конкретної риби у заданому місці.

Swagger

Локація: два варіанти

Передайте або координати (lat + lng), або spot_id з /v1/spots. spot_id зручніший якщо ви використовуєте місця риболовлі збережені в Actigator.

ПараметрТипОбов'язковоОпис
api_keystringтакВаш API ключ
fish_idintegerтакID риби з /v1/fish
latfloatlat/lng або spot_idШирота
lngfloatlat/lng або spot_idДовгота
spot_idintegerlat/lng або spot_idID місця з /v1/spots
langstringніМова: uk (за замовчуванням) або ru
Варіант 1 — за координатами:
GET https://api.actigator.com/v1/forecast?api_key=YOUR_API_KEY&fish_id=27&lat=50.4501&lng=30.5234&lang=uk
Варіант 2 — за місцем риболовлі:
GET https://api.actigator.com/v1/forecast?api_key=YOUR_API_KEY&fish_id=27&spot_id=42&lang=uk
Відповідь:
{
  "fish": { "id": 27, "name": "Щука звичайна" },
  "location": { "lat": 50.4501, "lng": 30.5234 },
  "forecast": {
    "today": {
      "date": "2026-05-14",
      "f_index": 74,
      "hourly": [45, 52, 68, 74, 71, 65, 58, 42]
    },
    "tomorrow": {
      "date": "2026-05-15",
      "f_index": 61,
      "hourly": [30, 35, 55, 61, 58, 50, 44, 38]
    },
    "day_after_tomorrow": {
      "date": "2026-05-16",
      "f_index": 48,
      "hourly": [22, 28, 44, 48, 45, 40, 35, 30]
    }
  }
}

Інтерпретація F-Індекс

ЗначенняАктивність
0 — 33Низька — риба пасивна
34 — 66Середня — помірна активність
67 — 100Висока — гарний день для риболовлі

Погодинний прогноз

Масив hourly містить 8 значень F-Індекс для 3-годинних інтервалів: 00:00, 03:00, 06:00, 09:00, 12:00, 15:00, 18:00, 21:00 (місцевий час). Використовуйте це щоб знайти найкращий час доби для риболовлі.

Ліміти

Ліміти запитів до API залежать від вашого плану.

ПланЛімітRate limiting
Безкоштовно100 запитів на день60 на хвилину
ProБезліміт60 на хвилину

Ліміт вичерпано

При досягненні ліміту API повертає HTTP 429 Too Many Requests. Перейдіть на Pro для необмеженого доступу. Перейти на Pro →

Заголовки rate limit

X-Rate-Limit-Limit: 60
X-Rate-Limit-Remaining: 58
X-Rate-Limit-Reset: 42
  • X-Rate-Limit-Limit — максимум запитів на хвилину
  • X-Rate-Limit-Remaining — залишок запитів у поточному вікні
  • X-Rate-Limit-Reset — секунд до скидання вікна

Приклади коду

PHP (cURL)

<?php

$apiKey = 'YOUR_API_KEY';
$url = "https://api.actigator.com/v1/forecast?" . http_build_query([
    'api_key' => $apiKey,
    'fish_id' => 14,
    'lat'     => 50.4501,
    'lng'     => 30.5234,
    'lang'    => 'uk',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

$today = $data['forecast']['today'];

// Загальний індекс на день
echo "F-Index today: {$today['f_index']}\n";

// Почасовий прогноз
$hours = ['00:00', '03:00', '06:00', '09:00', '12:00', '15:00', '18:00', '21:00'];
foreach ($today['hourly'] as $i => $fIndex) {
    echo "{$hours[$i]} — F-Index: {$fIndex}\n";
}

JavaScript (fetch)

const params = new URLSearchParams({
    api_key: 'YOUR_API_KEY',
    fish_id: 14,
    lat: 50.4501,
    lng: 30.5234,
    lang: 'uk',
});

const res  = await fetch(`https://api.actigator.com/v1/forecast?${params}`);
const data = await res.json();

const today = data.forecast.today;

// Загальний індекс на день
console.log(`F-Index today: ${today.f_index}`);

// Почасовий прогноз
const hours = ['00:00', '03:00', '06:00', '09:00', '12:00', '15:00', '18:00', '21:00'];
today.hourly.forEach((fIndex, i) => {
    console.log(`${hours[i]} — F-Index: ${fIndex}`);
});

Готові спробувати?

Скористайтеся інтерактивним API Explorer (Swagger) щоб протестувати всі ендпоінти прямо з браузера.

Ми використовуємо cookies