Developers

API Reference

Dwa publiczne endpointy JSON, których używa kreator: rankingi UserBenchmark i agregacja cen z Ceneo. Bez klucza API, bez rejestracji — z limitami fair use.

Changelog

Dostęp

Endpointy są publiczne — nie ma kluczy API ani nagłówków autoryzacji. Bazowy adres to https://pibuild.inpi.pl. Prosimy o rozsądne tempo zapytań: ceny z Ceneo są po stronie serwera dławione do ok. 1 zapytania na 1,2 s.

Cache i źródła danych

Odpowiedzi są cache'owane przez 24 h (błędy i puste wyniki nie są zapamiętywane). Dane pochodzą z zewnętrznych, publicznych źródeł — userbenchmark.com i ceneo.pl — i mają charakter informacyjny.

GET/api/userbenchmark/{type}

Rankingi wydajności komponentów z UserBenchmark, sparsowane do JSON. Gdy źródło nie odpowiada, endpoint zwraca lokalny snapshot z polem source: "local-fallback" (status 200).

typeSegment ścieżki, wymagany: cpu | gpu | ssd | hdd | ram | usb. Inna wartość → 400 z listą dozwolonych.

limitParametr zapytania, opcjonalny: liczba zwracanych wierszy (domyślnie 200, maksymalnie 500).

cURL

curl "https://pibuild.inpi.pl/api/userbenchmark/gpu?limit=5"

200 OK (fragment)

{
  "source": "userbenchmark.com",
  "family": "gpu",
  "count": 5,
  "rows": [
    {
      "type": "GPU",
      "partNumber": "RTX 5090",
      "brand": "Nvidia",
      "model": "RTX 5090",
      "rank": 1,
      "benchmark": 247.0,
      "samples": 41234,
      "url": "https://gpu.userbenchmark.com/..."
    }
  ]
}

GET/api/prices/ceneo

Najtańsze oferty z polskich sklepów zagregowane z Ceneo (do 5 ofert, posortowane rosnąco). Zapytania są throttlowane (~1,2 s) — udane wyniki trzymamy w cache przez 24 h, nieudane nie są cache'owane.

qParametr zapytania, wymagany: nazwa produktu (min. 3 znaki), np. „RTX 5070” albo „Ryzen 7 9800X3D”. Krótszy → 400.

cURL

curl "https://pibuild.inpi.pl/api/prices/ceneo?q=RTX%205070&category=gpu"

200 OK (fragment)

{
  "query": "RTX 5070",
  "source": "ceneo.pl",
  "productName": "MSI GeForce RTX 5070 VENTUS 2X OC 12GB",
  "productUrl": "https://www.ceneo.pl/...",
  "offerCount": 23,
  "priceLow": 2549,
  "priceHigh": 3199,
  "lowest": {
    "store": "x-kom.pl",
    "storeLabel": "x-kom",
    "price": 2549,
    "url": "https://www.ceneo.pl/Click/Offer/..."
  },
  "offers": [
    { "store": "x-kom.pl", "storeLabel": "x-kom", "price": 2549 },
    { "store": "mediaexpert.pl", "storeLabel": "Media Expert", "price": 2599 }
  ],
  "scrapedAt": "2026-06-10T09:30:00.000Z"
}

Pola priceLow/priceHigh, lowest i url ofert są opcjonalne — przy braku dopasowania dostaniesz pustą tablicę offers i pole note z wyjaśnieniem.