Jak używać Watchlist?

Watchlist pozwala monitorować firmy które są dla Ciebie ważne. Dodaj je raz — system sprawdza zmiany każdego dnia i dostarcza typowane eventy dla każdej wykrytej różnicy. Ten przewodnik pokazuje jak skonfigurować monitoring i efektywnie konsumować eventy.

Dodawanie firm

Dodaj firmy po ich identyfikatorze — NIP, REGON9 lub KRS. Możesz przesłać do 100 identyfikatorów w jednym żądaniu. Żądanie jest asynchroniczne — otrzymujesz natychmiastowe potwierdzenie i powiadomienie e-mail gdy wszystkie podmioty są gotowe do monitorowania.

POST /api/v1/companies/add

curl -X POST https://alexambros.com/api/v1/companies/add \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name":  "NIP",
    "value": ["5270103391", "7221234567", "9876543210"]
  }'

{
  "success": true,
  "message": "Accepted for processing."
}

Jeśli firma jest już w bazie rejestru, jest dodawana natychmiast. Jeśli nie, przechodzi przez pełny pipeline importu. W każdym przypadku otrzymujesz e-mail gdy wszystko jest gotowe.

Przeglądanie watchlisty

W każdej chwili możesz zobaczyć wszystkie firmy na swojej watchliście. Każdy wpis pokazuje nazwę firmy, główny identyfikator, datę dodania, datę ostatniego wykrytego eventu i łączną liczbę eventów. Ten endpoint jest bezpłatny — kredyty nie są pobierane.

GET /api/v1/companies/watched

curl "https://alexambros.com/api/v1/companies/watched?page=1" \
  -H "Authorization: Bearer sk_api_xxxx"

Pobieranie eventów

Są dwa sposoby konsumowania eventów z Twojej watchlisty.

GET /api/v1/watchlist/events

curl "https://alexambros.com/api/v1/watchlist/events?from_date=2026-03-01&to_date=2026-03-24" \
  -H "Authorization: Bearer sk_api_xxxx"

Struktura eventu

Każdy event ma tę samą strukturę — typ eventu, stara wartość, nowa wartość, data eventu i poziom ważności. Gdy old_value wynosi null, pole zostało nowo dodane. Gdy new_value wynosi null, zostało usunięte.

{
  "primary_identifier": "543701794",
  "name":               "CAR-PRO MAX DETAILING",
  "event_type":         "COMPANY_NAME_CHANGED",
  "old_value":          "CAR-PRO DETAILING",
  "new_value":          "CAR-PRO MAX DETAILING",
  "event_date":         "2026-03-02",
  "severity":           "info"
}

Usuwanie firm

Usuń firmy z watchlisty używając tego samego formatu identyfikatorów co przy dodawaniu. Codzienny monitoring zatrzymuje się natychmiast. Odpowiedź mówi dokładnie które identyfikatory zostały usunięte, których nie znaleziono i których nie było na Twojej watchliście.

DELETE /api/v1/companies/watched

curl -X DELETE https://alexambros.com/api/v1/companies/watched \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name":  "NIP",
    "value": ["5270103391"]
  }'

Wskazówka — codzienna rutyna
Typowa integracja odpytuje /watchlist/events raz dziennie z wczorajszą datą jako from_date. Daje to czysty dzienny feed wszystkich zmian we wszystkich monitorowanych firmach.