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" }
    }
  }
}

Pakiet: @atlasprzetargow/mcp (npm), kod źródłowy na GitHubie, wpis w katalogu glama.ai.

Narzędzia MCP (8)

• search_tendersWyszukiwanie przetargów z BZP i TED po frazie, mieście, województwie, kodzie CPV, wartości i terminie.
• get_tenderPełne dane jednego ogłoszenia po ID: zamawiający, terminy, wartość, CPV, wykonawca z wyniku, opcjonalnie streszczenie AI.
• search_entitiesWyszukiwanie zamawiających albo wykonawców po nazwie; zwraca NIP, lokalizację i skalę działalności.
• get_buyerProfil zamawiającego po NIP: statystyki, ostatnie ogłoszenia, najczęściej wygrywający wykonawcy.
• get_contractorProfil wykonawcy po NIP: liczba i wartość wygranych, zamawiający, u których wygrywa.
• search_cpvWyszukiwanie kodów CPV po polskim słowie kluczowym: kod, nazwa, dział, liczba przetargów w historii.
• get_category_statsStatystyki kategorii CPV: liczba postępowań, wartości, średnia liczba ofert, typowy termin składania.
• get_province_statsStatystyki dla 16 województw albo jednego miasta: najwięksi zamawiający i dominujące kategorie CPV.

Zasoby (4)

• atlas://glossaryIndeks ponad 90 haseł słownika zamówień publicznych (Markdown).
• atlas://glossary/{slug}Pełna definicja jednego hasła słownika.
• atlas://knowledgeIndeks artykułów bazy wiedzy o zamówieniach publicznych w Polsce.
• atlas://knowledge/{slug}Pełna treść jednego artykułu bazy wiedzy.

Prompty (3)

• analyze-tenderAnaliza ogłoszenia BZP/TED: kluczowe warunki, kryteria oceny, ryzyka, terminy, wadium.
• buyer-due-diligenceDue diligence zamawiającego: historia zamówień, typowi wykonawcy, wzorce, sygnały ostrzegawcze.
• find-opportunitiesAktywne przetargi dopasowane do profilu firmy: kategoria CPV, lokalizacja, przedział wartości.

Trzy publiczne końcówki do czytania przez asystentów AI (bez klucza, limit 30 wywołań na minutę na adres IP). Zwracają Markdown gotowy do cytowania albo zwięzły JSON z kanonicznymi adresami stron; indeks dla agentów jest pod /llms.txt. Strony ogłoszeń wskazują swoją wersję Markdown przez <link rel="alternate" type="text/markdown">.

curl "https://atlasprzetargow.pl/api/llm/tender/2026-BZP-00429585"

curl "https://atlasprzetargow.pl/api/llm/entity/n5252248481-miasto-stoleczne-warszawa"

curl "https://atlasprzetargow.pl/api/llm/tenders?city=Warszawa&cpv=72&onlyActive=1&limit=20"

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: 10 września 2026, opis narzędzi MCP i końcówek /api/llm; 5 września 2026, klucze API, limity dobowe i nagłówki X-RateLimit-*.