Przejdź do treści
siecinfo.pl — strona główna

Dla firm

API dla firm

Sprawdzaj numery automatycznie — przy zamówieniu w sklepie, w systemie CRM albo przed oddzwonieniem w call center.

  • Plan numeracji i UKE

    Rodzaj numeru, strefa i operator, któremu przydzielono zakres.

  • Opinie użytkowników

    Zatwierdzone oceny i kategorie oraz bieżące fale zgłoszeń.

  • Zweryfikowane firmy

    Nazwa i źródło dla numerów firm i instytucji.

Zapytanie

Klucz przekazuj w nagłówku Authorization. Używaj go tylko po stronie serwera — nie umieszczaj klucza w aplikacji przeglądarkowej.

curl -H "Authorization: Bearer sk_TWOJ_KLUCZ" \
  https://siecinfo.pl/api/v1/numbers/221234567

Odpowiedź zawiera nagłówki X-RateLimit-Limit i X-RateLimit-Remaining.

Odpowiedź

{
  "number": "+48221234567",
  "national": "221234567",
  "kind": "FIXED",
  "zone": { "code": "22", "city": "Warszawa" },
  "originalOperator": "Orange Polska S.A.",
  "opinions": {
    "total": 12,
    "ratings": { "SAFE": 1, "NEUTRAL": 3, "SUSPICIOUS": 8 },
    "categories": { "TELEMARKETING": 9, "SPAM": 2, "AUTOMATED": 0, "POSSIBLE_FRAUD": 1, "OTHER": 0 },
    "comments": 4,
    "signal": "Przeważają oceny negatywne"
  },
  "wave": { "active": false },
  "business": null,
  "url": "https://siecinfo.pl/numer/221234567"
}

kind: MOBILE, FIXED, FREEPHONE, SHARED_COST, PREMIUM, NOMADIC, UNKNOWN. Operator pierwotny nie oznacza obecnej sieci — numer mógł zostać przeniesiony. API nie zwraca treści komentarzy ani żadnych danych o osobach zgłaszających.

Błędy

401 missing_api_key / invalid_api_key
Brak, błędny lub wyłączony klucz.
422 invalid_number
Numer nie jest poprawnym polskim numerem (9 cyfr, opcjonalnie +48).
429 daily_limit_exceeded
Wykorzystano dzienny limit; licznik zeruje się o północy UTC.
503 unavailable
Chwilowa niedostępność — ponów za kilka sekund.

Dostęp i pakiety

Klucz testowy i pakiety dopasowane do liczby zapytań przygotowujemy indywidualnie. Napisz na TWOJ@ADRES.pl — podaj nazwę firmy i przewidywaną liczbę zapytań dziennie.