# UptimeScout API: регіональна доступність сервісів для ваших застосунків і ШІ

URL: https://uptimescout.com/uk/blog/uptimescout-api-launch/

Author: Michael Johnson

Коли зовнішня платформа перестає відповідати, це швидко стає вашою проблемою: не проходить авторизація, зависає інтеграція, зростає черга звернень до служби підтримки. Водночас той самий сервіс може виглядати по-різному для користувачів із різних країн. Загального статусу «все працює» у такій ситуації недостатньо.



Ми запускаємо [UptimeScout API на jsonscraper](https://jsonscraper.com/uk/services/uptimescout-api?region=RU). Він надає вашим застосункам і ШІ-асистентам регіональні сигнали доступності зовнішніх сервісів — з історією, часом спостереження та чітким зазначенням свіжості даних. Уже доступні REST, MCP і SDK для шести мов. Почати можна з безкоштовного тарифу.




## Перевіряйте сервіс із потрібної країни



Для команди підтримки важливе просте запитання: що відбувається із сервісом там, де перебуває користувач? UptimeScout дає змогу вибрати країну, отримати поточний сигнал і зіставити його зі спостереженнями з інших регіонів.



Наприклад, ви можете перевірити GitHub для Росії та Німеччини, а потім переглянути історію за доступний період. Це додає контекст до ваших власних журналів і допомагає обрати наступний крок розслідування. У перевіреній відповіді API від 19 листопада 2026 року були доступні 72 регіони. Поточне покриття переглядайте в `available_regions`: для різних сервісів воно може відрізнятися.



Кожна відповідь містить час спостереження `observed_at` і ознаку застарілих даних `stale`. Мову опису вибирають окремо від країни: можна отримувати спостереження для Японії з описом українською або англійською. Загалом підтримується 20 мов опису.



Регіональний сигнал допомагає помітити проблему. Він не визначає її причину й не підтверджує глобальний збій. Для розслідування зіставляйте його з власними перевірками та офіційним статусом провайдера; статистика спостережень не є вимірюванням часу безперервної роботи чи SLA.




## Відкрийте карту спостережень



Виберіть країну або знайдіть потрібний сервіс. Перемикайтеся між глобусом і картою, щоб побачити регіональні відмінності та час останніх спостережень.



[Відкрити карту UptimeScout](https://uptimescout.com/uk/blog/uptimescout-api-launch/#explore-map)



На карті показано збережений знімок даних, який оновлюється у фоновому режимі приблизно раз на хвилину. Час спостереження залишається видимим: якщо свіжих даних немає, стан не можна вважати підтвердженим.




## Від зовнішнього сигналу до корисної дії



Додайте UptimeScout до процесу, який ваша команда вже використовує. На інформаційній панелі він надасть контекст щодо зовнішніх залежностей. У службі підтримки допоможе перевірити скаргу з конкретної країни. В автоматизації стане джерелом даних для власного звіту чи сповіщення.



![Концептуальна ілюстрація: регіональні спостереження об’єднуються у структуровану відповідь API](https://uptimescout.com/static/editorial/launch-20261119/regions.webp)

Регіональний контекст для ваших інтеграцій. Концептуальна ілюстрація, а не реальні вимірювання.


- 01 **Виберіть контекст** Потрібний сервіс і країну вашої аудиторії.

- 02 **Перевірте спостереження** Статус, час і свіжість даних в одній відповіді.

- 03 **Використайте результат** На інформаційній панелі, у службі підтримки або ШІ-асистенті.


Для кількох залежностей скористайтеся пакетним запитом. Щоб порівняти країни, виконайте окремий запит для кожного регіону. А перш ніж надсилати користувачам тривожне сповіщення, перевірте сигнал за допомогою додаткових джерел.




## Один API для трьох завдань



### Знайти сервіс



`/v1/services` — пошук у каталозі. Почніть із нього, щоб вибрати потрібну залежність.



### Зрозуміти поточну картину



`/v1/status` повертає сигнал одного сервісу, `/v1/statuses` — кількох одразу, а `/v1/summary` формує зведення.



### Переглянути зміни



`/v1/history` надає історію, `/v1/stats` — статистику спостережень, `/v1/incidents` — нещодавні сигнали про підвищену ймовірність проблем.



Усі сім методів доступні й через MCP: наприклад, `uptimescout_status` і `uptimescout_history`. Повний перелік параметрів наведено у [специфікації OpenAPI](https://uptimescout.com/openapi.json).




## Перший запит — за кілька хвилин



Виберіть [безкоштовний тариф](https://jsonscraper.com/uk/services/uptimescout-api#pricing), отримайте ліцензійний ключ через Evelode та збережіть його на сервері в `UPTIMESCOUT_LICENSE_KEY`. Один ключ підходить для REST, MCP і всіх SDK UptimeScout.



```bash
curl --get 'https://api.uptimescout.com/v1/status' \
  --header "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY" \
  --data-urlencode 'service=github' \
  --data-urlencode 'region=RU' \
  --data-urlencode 'lang=ru'
```



Якщо ви працюєте з Python, установіть готовий клієнт із релізу на GitHub:



```bash
python -m pip install "git+https://github.com/jsonscraper/uptimescout-api-python.git@0.1.3"
```



```python
import os
from uptimescout import Client

client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
response = client.status("github", region="RU", lang="ru")
service = response["service"]
print(service["status"], service["observed_at"], service["stale"])
```



Окрім [Python](https://github.com/jsonscraper/uptimescout-api-python), доступні SDK для [Node.js](https://github.com/jsonscraper/uptimescout-api-node), [PHP](https://github.com/jsonscraper/uptimescout-api-php), [Go](https://github.com/jsonscraper/uptimescout-api-go), [Java](https://github.com/jsonscraper/uptimescout-api-java) та [.NET](https://github.com/jsonscraper/uptimescout-api-dotnet). У кожному репозиторії є інструкції та приклади запитів.



Під час обробки відповіді розрізняйте два поля: верхньорівневе `status` описує виконання запиту до API, а `service.status` — сигнал вибраного сервісу. Відображаючи результат, враховуйте країну, час спостереження та `stale`.




## Що надходить у відповіді



Нижче — скорочена реальна відповідь UptimeScout для GitHub у Росії, отримана 19 листопада 2026 року. Це приклад структури даних, а не поточний статус сервісу; поля ліцензії та використання квоти пропущено.



GET /v1/statusJSON · RU



```json
{
  "status": "ok",
  "region": "RU",
  "service": {
    "id": "github",
    "name": "GitHub",
    "status": "operational",
    "stale": false,
    "observed_at": "2026-11-19T13:46:49.188257Z",
    "signal": "reported_availability",
    "scope": "regional"
  },
  "generated_at": "2026-11-19T13:48:48.782598Z",
  "stale_after_seconds": 600
}
```



`service.status`Сигнал вибраного сервісу; тут — operational.



`region`Країна спостереження, а не мова відповіді.



`observed_at`Час самого спостереження в UTC.



`stale`Ознака того, що спостереження вже застаріло.



Поле `generated_at` показує час формування відповіді. Воно не замінює `observed_at`: дані можуть бути старшими за саму відповідь.




## Той самий API — у розмові з асистентом



Якщо зручніше почати без власного коду, підключіть `https://mcp.uptimescout.com` до сумісного ШІ-клієнта. В [інструкції MCP](https://mcp.uptimescout.com/connect?ui_locales=uk) описано авторизацію через Evelode або ліцензійний ключ. Також доступний [загальний конектор jsonscraper](https://jsonscraper.com/uk/services/uptimescout-api#connect).



«Перевір GitHub у Росії та Німеччині. Для кожної країни вкажи час спостереження та свіжість даних. Якщо сигнали різняться, поясни, що відомо і які перевірки варто виконати далі».



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




## Три способи підключити ті самі дані



Виберіть звичний інтерфейс. REST підходить для прямих HTTP-запитів, SDK — для застосунку, MCP — для AI-асистента. Регіон, свіжість спостереження та значення статусів в усіх випадках залишаються однаковими.



![UptimeScout](https://uptimescout.com/static/icon.svg)

**UptimeScout API**Сервіс · країна · час спостереження


- **REST**Прямі HTTP-запити

- **SDK**Готовий клієнт для застосунку

- **MCP**Інструменти AI-асистента




## Безкоштовний старт із прозорими лімітами



Тариф Free передбачає **1 000 успішних запитів за період ліцензії**, до **60 запитів на хвилину**, до **5 сервісів в одному пакеті** та історію за **7 днів**. Можна спробувати REST, SDK і MCP з однією ліцензією.



Успішний пакетний запит у межах ліміту тарифу витрачає один запит. Кожна наступна сторінка історії рахується як окремий виклик. Квота прив’язана до періоду ліцензії та скидається під час її поновлення або зміни тарифу, а не першого числа місяця. Історія містить лише ті періоди, за які справді збиралися спостереження.



Цього достатньо, щоб ознайомитися з API та створити прототип. Для постійного моніторингу співвіднесіть частоту запитів із квотою; для більших навантажень доступні тарифи Starter, Builder, Pro та Scale. Поточні умови опубліковані на [сторінці тарифів](https://jsonscraper.com/uk/services/uptimescout-api#pricing).




## Почніть з однієї залежності



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



**[Відкрити UptimeScout API й почати безкоштовно →](https://jsonscraper.com/uk/services/uptimescout-api?region=RU)**
