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 -X GET "https://api.scopio.pl/v1/me" \
-H "Authorization: Bearer scp_live_..." \
-H "X-Client-ID: agent_one"
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"
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.