API Docs:
Unified
Agentic Logic.
Build with the Speed of Intelligence.
The Scopio API is the central nervous system for Agentic Commerce. It abstracts the complexity of connecting legacy databases to modern LLM interfaces via UCP and MCP protocols. One integration, unlimited AI reach.
ENDPOINT: https://api.scopio.pl/v1
AUTH: X-API-Key or Bearer JWT
RATE LIMIT: 5000 req/min (Enterprise)
FORMAT: JSON / Protobuf
Secure Authentication.
Scopio uses standard OAuth 2.1 for user-delegated access and encrypted API Keys for server-to-server interactions. All production traffic is forced through 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 }
});
Scouring Tools (B2B API).
The prospecting engine allows you to programmatically trigger deep-scrapes across Amazon, Google Maps, and Polish business registries (GUS/CEIDG).
POST /v1/prospector/search
"niche": "Manufacturing",
"region": "Masovian Voivodeship",
"enrich": true,
"callback_url": "https://your-crm.com/hook"
The API doesn't just return rows. It uses Gemini to verify physical existence and extract current decision-maker emails from the web.
Agentic Webhooks.
Subscribe to events that matter in the AI world. Get notified when an agent completes a purchase or when your "Trust Score" changes based on new registry data.
agent.transaction.complete
Fired when a GPT/Gemini agent finishes a zero-click order.
identity.trust.verified
Fired when CEIDG data syncs with your UCP manifest.
scraper.task.finished
Fired when a mass-export of B2B data is ready for CSV download.
Engineering FAQ.
Does Scopio support GraphQL instead of REST? +
Currently, we provide a high-performance JSON-RPC 2.0 and RESTful interface. A GraphQL endpoint is in our 2026 Q3 roadmap for enterprise clients to allow for more granular querying of the "Poland B2B Knowledge Graph."
How do I handle the latency of AI-enriched scraping? +
Because AI verification takes 5-15 seconds per record, we recommend an asynchronous pattern. Use the `callback_url` parameter in your request; the API will return a `202 Accepted` status immediately and POST the results to your endpoint when the AI extraction is complete.
What is the difference between Test and Live keys? +
Test keys (`scp_test_...`) simulate all tool outputs without consuming credits. They return "Sample AI Data" for development. Live keys (`scp_live_...`) perform real-world scrapes and cost credits per successful record extraction.
Can I integrate the API directly with OpenAI Actions? +
Yes! Our API is fully OpenAPI 3.1 compliant. You can import our `.well-known/openapi.json` directly into your Custom GPT or Claude Artifact to give them power over Scopio's tools.
Start Building.
Join 500+ developers building agent-first applications on top of Polish business data.