API Docs:
Logika
Agentyczna.

Buduj z Szybkością Inteligencji Maszynowej.

API Scopio to układ nerwowy Handlu Agentycznego. Abstrakcyjnie upraszcza połączenie tradycyjnych baz danych z nowoczesnymi interfejsami LLM poprzez protokoły UCP i MCP. Jedna integracja, nieskończony zasięg w świecie AI.

ENDPOINT: https://api.scopio.pl/v1
AUTH: X-API-Key / Bearer JWT
LIMIT: 5000 req/min (Enterprise)
FORMAT: JSON / Protobuf

Bezpieczna Autentykacja.

Scopio wykorzystuje standard OAuth 2.1 dla dostępu delegowanego oraz szyfrowane klucze API dla komunikacji server-to-server. Cały ruch produkcyjny jest wymuszany przez TLS 1.3.

CURL
curl -X GET "https://api.scopio.pl/v1/me" \
  -H "Authorization: Bearer scp_live_..." \
  -H "X-Client-ID: agent_one"
NODE.JS
const res = await fetch('https://api.scopio.pl/v1/auth', {
  headers: { 'X-API-Key': process.env.SCOPIO_KEY }
});

Narzędzia Scouring (API B2B).

Silnik prospectingu pozwala na programowe wyzwalanie głębokiego scrapowania danych z Amazon, Google Maps oraz polskich rejestrów biznesowych (GUS/CEIDG/KRS).

POST /v1/prospector/search

"niche": "Produkcja",

"region": "Mazowieckie",

"enrich": true,

"callback_url": "https://twoje-crm.pl/hook"

Wynik AI-Enriched:

Nasze API nie zwraca tylko surowych rzędów. Używa Gemini do weryfikacji fizycznego istnienia firmy i ekstrakcji aktualnych maili decydentów.

Webhooki Agentyczne.

Subskrybuj zdarzenia, które mają znaczenie w świecie AI. Otrzymuj powiadomienia, gdy agent dokona zakupu lub gdy Twój "Trust Score" zmieni się na podstawie nowych danych z KRS.

agent.transaction.complete

Wywoływane, gdy agent GPT/Gemini sfinalizuje zamówienie zero-click.

identity.trust.verified

Wywoływane, gdy dane z CEIDG zsynchronizują się z manifestem UCP.

scraper.task.finished

Wywoływane, gdy masowy eksport danych B2B jest gotowy do pobrania jako CSV.

Engineering FAQ.

Czy Scopio wspiera GraphQL zamiast REST? +

Obecnie oferujemy wysokowydajny interfejs JSON-RPC 2.0 oraz RESTful. Endpoint GraphQL jest w planach na Q3 2026 dla klientów korporacyjnych, aby umożliwić bardziej ziarniste zapytania do "Grafu Wiedzy B2B Polska".

Jak radzić sobie z latencją AI scrapingu? +

Ponieważ weryfikacja AI trwa od 5 do 15 sekund na rekord, zalecamy wzorzec asynchroniczny. Użyj parametru `callback_url`; API natychmiast zwróci status `202 Accepted` i wyśle wyniki pod Twój adres, gdy ekstrakcja zostanie zakończona.

Jaka jest różnica między kluczami Test a Live? +

Klucze testowe (`scp_test_...`) symulują wyniki bez pobierania kredytów. Zwracają "Sample AI Data". Klucze produkcyjne (`scp_live_...`) wykonują rzeczywiste operacje i pobierają kredyty za każdy pomyślnie wyekstrahowany rekord.

Czy mogę zintegrować API bezpośrednio z OpenAI Actions? +

Tak! Nasze API jest w pełni zgodne z OpenAPI 3.1. Możesz zaimportować nasz plik `.well-known/openapi.json` bezpośrednio do Custom GPT lub Claude Artifact, dając im władzę nad narzędziami Scopio.

Zacznij Budować.

Dołącz do 500+ deweloperów budujących aplikacje agent-first w oparciu o polskie dane biznesowe.

Zobacz SDK na GitHub