REST API, MCP Server, XML/JSON Feed, Calendar and Analytics — everything AI agents and ERP systems need to connect to the Scopio European Marketplace.
All endpoints require a Bearer token. Generate your key in Account → Marketplace → API Keys. Format: sk_mkt_...
Authorization: Bearer sk_mkt_YOUR_KEYapplication/jsonhttps://business.scopio.plQuick test — curl
curl -X POST \
https://business.scopio.pl/api/seller/products \
-H "Authorization: Bearer sk_mkt_..." \
-H "Content-Type: application/json" \
-d '[{"ean":"8721199108286","price":29.99,"qty":10}]'Response
{"updated":1,"pending_review":0,"errors":0}All methods accept EAN + price + qty. Pick whichever fits your tech stack.
Real-time JSON sync. Array of products, up to 10,000 per request. EANs in catalog go live immediately.
Upload XML catalog. Generic format and Google Shopping RSS supported. Ideal for ERP systems.
Point us to your JSON feed URL. We fetch and parse automatically. Supports arrays and nested formats.
Upload Excel file. Columns: EAN, Price, Qty (or Polish: EAN, Cena, Ilość). No coding required.
Save FTP credentials once. We pull your product file on demand. Supports JSON, XML and CSV.
JSON-RPC 2.0 for AI agents. Claude, ChatGPT and Gemini call sync_products, check_ean, get_offers directly.
EANs matched → live in marketplace immediately
Unknown EANs → queued for Google Merchant verification
Validation errors with per-product details
JSON-RPC 2.0 endpoint. Claude, ChatGPT, Gemini and any custom agent call Scopio tools directly — no manual sync needed.
sync_productsPush product array to marketplace. Returns updated / pending_review / errors count.
params: {"products": [{"ean": "string", "price": number, "qty": number}]}check_eanCheck if EAN exists in the Scopio catalog. Returns status: live | pending | unknown.
params: {"ean": "string"}get_offersGet current active marketplace listings for the authenticated seller.
params: {}Endpoint
POST /api/seller/products/mcpExample request
{
"jsonrpc": "2.0",
"method": "sync_products",
"params": {
"products": [
{"ean":"8721199108286","price":29.99,"qty":10}
]
},
"id": 1
}Response
{
"jsonrpc": "2.0",
"result": {"updated":1,"pending_review":0,"errors":0},
"id": 1
}AI agents check availability and book meetings autonomously on behalf of clients.
Get available slots
GET /api/calendar/slots?date=2025-06-15&duration=30Returns: [{slot_id, start, end, available}]
Book a slot
POST /api/calendar/book{
"slot_id": "...",
"client_name": "Jan Kowalski",
"client_email": "jan@firma.pl",
"service_name": "Demo call",
"duration": 30
}See how many times Claude, ChatGPT, Gemini and others interacted with your products.
GET /api/seller/analytics{
"total_30d": 142,
"by_type": {
"mcp_query": 98,
"product_query": 31,
"calendar_booking": 13
},
"by_agent": {
"claude": 67,
"chatgpt": 44,
"gemini": 31
},
"trend_7d": [
{"date":"2026-05-20","count":12}, ...
],
"top_products": [
{"ean":"8721199108286","count":23}
]
}Configure a webhook URL in your account. We POST events to your endpoint in real time.
Register webhook
POST /api/seller/webhooks{
"url": "https://yourshop.pl/scopio-hook",
"events": ["order.placed","product.updated"]
}Payload — order.placed
{
"event": "order.placed",
"order_id": "ORD-2026-...",
"ean": "8721199108286",
"qty": 2,
"buyer_country": "DE",
"created_at": "2026-05-26T12:00:00Z"
}What authentication method does the Scopio API use?
Bearer API key. Generate sk_mkt_... in Account → Marketplace → API Keys. Header: Authorization: Bearer sk_mkt_...
What product fields are required?
Minimum: ean (string), price (number), qty (integer). Example: [{"ean":"5901234123457","price":29.99,"qty":10}]
How does EAN matching work?
EANs in our catalog go live immediately. Unknown EANs are queued for Google Merchant verification — photos, descriptions and translations for 27 EU countries added automatically.
Which AI agents can use the MCP Server?
Any JSON-RPC 2.0 agent: Claude (Anthropic), ChatGPT (OpenAI), Gemini (Google), Perplexity, GitHub Copilot, custom agents.
Can AI agents book meetings via the Calendar API?
Yes. GET /api/calendar/slots returns available slots. POST /api/calendar/book creates the booking. Both require Bearer API key.
How do I track which AI agents access my products?
GET /api/seller/analytics returns 30-day traffic by LLM agent (Claude, ChatGPT, Gemini, Perplexity, Copilot) + 7-day sparkline + top EANs. Visible on your dashboard.
Ready to integrate?
Generate your API key, pick your integration method, send first product. Instant response.