Garmin Personal API to oficjalny dostęp do danych z Twojego własnego konta Garmin Connect. Tworzysz klucz w ustawieniach konta, a potem pobierasz aktywności i dane zdrowotne na swój komputer, także jako pliki .FIT z jazd. Przydaje się, jeśli chcesz analizować wiele treningów poza Garmin Connect albo wrzucać dane do własnego arkusza czy narzędzia AI. Jeśli potrzebujesz jednego pliku z jednej jazdy, nie jest Ci to potrzebne, bo wystarczy zwykły eksport z poziomu portalu Connect.
Stan na październik 2026. Program jest świeży, więc szczegóły mogą się zmieniać.
Czym jest Garmin Personal API?
Garmin ponownie otworzył Connect Developer Program 21 października 2026, po kilku miesiącach przerwy w przyjmowaniu nowych zgłoszeń.
Główna zmiana polega na legalnym, stabilnym dostępie do własnej historii bez ryzyka zablokowania konta za łamanie regulaminu web scrapingu.
Jakie dane możemy pobrać przez API Garmina?
Dla kolarza kluczowa jest zawartość pakietu danych treningowych. Personal API udostępnia dane w dwóch formatach: surowych strukturach JSON oraz spakowanych plikach .FIT.
Jak wygenerować klucz API krok po kroku
Klucz generuje się bezpośrednio w przeglądarkowej wersji Garmin Connect:
Ważne: Klucz API wyświetla się tylko raz. Jeśli go zamkniesz bez skopiowania, nie ma opcji podejrzenia – musisz go unieważnić i wygenerować nowy. Garmin wysyła e-mail z przypomnieniem o wygaśnięciu na około tydzień przed końcem ważności.
Pierwsze pobranie danych: konfiguracja i Python
Klucz osobisty nie służy do bezpośredniej autoryzacji każdego zapytania GET. Działa w standardzie OAuth2: klucz wymieniasz na krótkoterminowy token dostępowy (Bearer token ważny 24 godziny).
Garmin przygotował oficjalną bibliotekę oraz narzędzie CLI w języku Python: pakiet garmin-connect-personal-api-python (wymaga Pythona w wersji 3.12 lub nowszej).
Instalacja biblioteki
(Pakiet dostarcza zarówno moduł Pythona, jak i konsolowe narzędzie gc-personal).
Klucz zapisz w zmiennej środowiskowej GARMIN_PERSONAL_API_KEY albo w pliku i wskaż go opcją --api-key-file. Opcji --api-key lepiej unikać, bo klucz zostaje w historii terminala.
Dwie komendy na start, czyli lista jazd od wybranej daty i pobranie jednej z nich:
Numer aktywności weźmiesz z listy. W ZIP-ie będzie plik z aktywnością.
Pobieranie danych przez skrypt
Ten skrypt pobiera listę 50 ostatnich aktywności od wskazanej daty, zapisuje ją do pliku activities.json i ściąga plik z jednej jazdy. Klucz czyta z pliku poza folderem projektu, więc nie trafia do kodu.
Zamiast 123456789 wstaw numer aktywności z pliku activities.json. W ZIP-ie znajdziesz plik .FIT.
Własny dashboard z danymi Garmina
Dane z Garmin Personal API możesz zamienić w prywatny dashboard z wykresami mocy, objętości i stref, który odświeża się automatycznie. Krok po kroku opiszę w kolejnym poradniku (jest w trakcie przygotowania!)
Co zrobić z danymi z Garmin Personal API na rowerze
Garmin Personal API a zwykły eksport
Nie każdy potrzebuje API. Dla większości kolarzy ręczny eksport wystarczy.
Wybierz API, jeśli stale analizujesz dane albo chcesz połączyć jazdy z danymi o śnie i regeneracji. W pozostałych przypadkach szkoda czasu na konfigurację.
