Dokumentacja API Atlasu Przetargów

Pierwsze zapytanie nie wymaga rejestracji. Pobierz 5 najnowszych ogłoszeń budowlanych z Mazowsza:

curl "https://atlasprzetargow.pl/api/tenders?cpv=45&province=PL14&per_page=5"

Z kluczem (większa pula i rozliczanie per klucz, nie per adres IP) dodaj nagłówek X-Api-Key:

curl "https://atlasprzetargow.pl/api/tenders?noticeKind=opening&dateFrom=2026-09-01&sort=newest&per_page=200" \
  -H "X-Api-Key: atlas_TWOJ_KLUCZ" \
  -H "User-Agent: moja-firma-sync/1.0 (kontakt@moja-firma.pl)"

Ten sam pobór w Pythonie:

import requests

session = requests.Session()
session.headers.update({
    "X-Api-Key": "atlas_TWOJ_KLUCZ",
    "User-Agent": "moja-firma-sync/1.0 (kontakt@moja-firma.pl)",
})

page = 1
while True:
    resp = session.get(
        "https://atlasprzetargow.pl/api/tenders",
        params={"noticeKind": "opening", "dateFrom": "2026-09-01", "sort": "newest",
                "per_page": 200, "page": page},
        timeout=30,
    )
    resp.raise_for_status()
    body = resp.json()
    for tender in body["data"]:
        print(tender["id"], tender["title"])
    print("zostało dziś:", resp.headers.get("X-RateLimit-Remaining"))
    if page >= body["pages"]:
        break
    page += 1

Limity liczymy na dobę (doba UTC, reset o 00:00 UTC, czyli 02:00 czasu polskiego latem i 01:00 zimą). Niezależnie od tego obowiązuje limit chwilowy 500 wywołań na minutę na adres IP.

Klucz tworzysz w Moje konto, zakładka API. Pokazujemy go tylko raz, zaraz po utworzeniu; potem widzisz wyłącznie jego początek i dzisiejsze zużycie. Klucz przekazuj w nagłówku X-Api-Key. Parametr ?api_key= też działa, ale klucz ląduje wtedy w logach i historii przeglądarki, więc traktuj go jako wyjście awaryjne.

Każda odpowiedź z danymi niesie nagłówki stanu limitu:

Odpowiedzi z cache (zwykłe przeglądanie stron, nagłówek X-Cache-Status: HIT) nie zużywają puli. Wywołania z klientów programistycznych i wszystkie wywołania z kluczem zawsze trafiają do serwera i są liczone.

Błędy zwracamy jako JSON z polem error (stały identyfikator) i message po polsku.

Przykład odpowiedzi 429 po wyczerpaniu puli:

HTTP/1.1 429 Too Many Requests
Retry-After: 21600
X-RateLimit-Limit: 1500
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1757116800
X-RateLimit-Scope: anonymous

{
  "error": "quota_exceeded",
  "scope": "anonymous",
  "limit": 1500,
  "resets_at": "2026-09-06T00:00:00Z",
  "retry_after": 21600,
  "message": "Przekroczono dobowy limit 1500 wywołań bez klucza dla tego adresu IP. ...",
  "docs": "https://atlasprzetargow.pl/dokumentacja-api"
}

Profile liczone z ogłoszeń: liczba postępowań, wartości, najczęstsze kody CPV, partnerzy. Identyfikatorem jest NIP (10 cyfr, bez myślników). Parametry dateFrom i dateTo zawężają okres statystyk.

Dane osób fizycznych prowadzących działalność publikujemy w zakresie zminimalizowanym (miejscowość i województwo zamiast adresu). Szczegóły w metodologii.

Orzeczenia Krajowej Izby Odwoławczej sparsowane z PDF: sygnatury, strony, skład, rozstrzygnięcie, artykuły PZP, koszty, powiązanie z ogłoszeniem BZP/TED. Każde orzeczenie linkuje do przetargu i odwrotnie.

Umowy jednostek sektora finansów publicznych (od 1 lipca 2026): strony, przedmiot, wartość, okres, aneksy, adnotacje o utajnieniu. Umowy łączymy po NIP z profilami podmiotów i po numerze z ogłoszeniami.

• Synchronizuj przyrostowo: sort=newest z dateFrom ustawionym na ostatni pobór i per_page=200. Pełne przejście po wszystkich stronach co godzinę to kilkaset wywołań, których nie potrzebujesz.
• Przy 429 odczekaj tyle, ile mówi Retry-After. Ponawianie w pętli tylko szybciej wyczerpie pulę.
• Podaj własny User-Agent z kontaktem. Gdy coś pójdzie nie tak po naszej stronie, będziemy wiedzieć, do kogo napisać.
• Cache’uj profile podmiotów i orzeczenia lokalnie; zmieniają się rzadko.
• Potrzebujesz całej bazy albo codziennego zrzutu? Feed dzienny jest tańszy dla obu stron niż paginacja: kontakt@atlasprzetargow.pl.

Atlas ma oficjalny serwer MCP (Model Context Protocol), dzięki któremu Claude, ChatGPT czy Cursor mogą przeszukiwać przetargi, profile podmiotów i wyroki KIO w rozmowie. Klucz API przekazujesz zmienną środowiskową ATLAS_API_KEY.

{
  "mcpServers": {
    "atlas-przetargow": {
      "command": "npx",
      "args": ["-y", "@atlasprzetargow/mcp"],
      "env": { "ATLAS_API_KEY": "atlas_TWOJ_KLUCZ" }
    }
  }
}

Dane źródłowe (Biuletyn Zamówień Publicznych, TED, orzeczenia KIO, Centralny Rejestr Umów) są informacją publiczną. Opracowanie Atlasu (normalizacja, powiązania, profile, agregaty) udostępniamy na licencji CC BY 4.0. Możesz je wykorzystywać także komercyjnie, pod warunkiem podania źródła:

Źródło: Atlas Przetargów (https://atlasprzetargow.pl)

W produktach publicznych link do atlasprzetargow.pl powinien być klikalny. Dane prezentujemy w dobrej wierze, bez gwarancji kompletności; przy decyzjach formalnych sprawdzaj publikację źródłową w BZP lub TED. Jak liczymy i czego nie liczymy, opisujemy w metodologii danych.

Zmiany łamiące kompatybilność zapowiadamy na tej stronie z wyprzedzeniem. Historia: 5 września 2026, klucze API, limity dobowe i nagłówki X-RateLimit-*.