REST API, UCP, 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 settings → Integrations → 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 our 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 it automatically on a regular basis.
Upload Excel file. Required columns: EAN, Price, Qty. Integration with no coding required.
Save FTP credentials once. We pull your product file (JSON, XML or CSV) on demand.
JSON-RPC 2.0 standard for AI agents. Claude, ChatGPT and Gemini can invoke database tools 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 export needed.
sync_productsPush product array to marketplace. Returns updated, pending review, and 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
}Allows AI agents to 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 other agents 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 panel. We POST event notifications (e.g. order.placed) 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"
}Manage integration settings, synchronise products with EU GPSR compliance, and fetch TikTok Shop orders.
/api/seller/tiktok/configReturns connection status, shop name, region, and default GPSR and warehouse mappings.
/api/seller/tiktok/configSaves or updates TikTok Shop connection settings, shipping templates, and GPSR IDs.
{
"region": "PL",
"default_category_id": "602123",
"default_warehouse_id": "123456789",
"default_gpsr_manufacturer_id": "mfg_uuid",
"default_gpsr_responsible_person_id": "rp_uuid",
"auto_upload_products": true,
"sync_inventory_realtime": true
}/api/seller/tiktok/warehousesFetches the list of active warehouses from your TikTok Shop logistics profile, required for stock updates.
/api/seller/tiktok/syncTriggers immediate sync of offers to TikTok Shop. Checks EAN status, uploads images, sets up EU General Product Safety Regulation (GPSR) safety details, or updates prices/stock.
List of EANs to sync (optional, empty array syncs all products).
{
"eans": ["5901234123457", "5901234123464"]
}Response
{
"success": true,
"synced_count": 2,
"created": 1,
"updated": 1,
"message": "TikTok EU Sync: 1 created, 1 updated."
}/api/seller/tiktok/ordersRetrieves cached TikTok Shop orders. Use query param ?refresh=1 to bypass cache and pull live orders from TikTok API.
What authentication method does the Scopio API use?
Bearer API key. Generate sk_mkt_... key in Account → Marketplace → API Keys. Header: Authorization: Bearer sk_mkt_...
What product fields are required for sync?
Minimum: ean (string), price (number), qty (integer). Example: [{"ean":"5901234123457","price":29.99,"qty":10}]
Does Scopio support UCP (Universal Commerce Protocol)?
Yes. Scopio is the first platform in Europe to implement the UCP standard, enabling AI agents to dynamically fetch commercial data, verify availability, and execute transactions natively.
How does TikTok Shop integration work?
It is fully automated. You connect your TikTok Shop via OAuth, configure your defaults (shipping template, category, warehouse, and GPSR safety profiles), and use POST /api/seller/tiktok/sync to sync EANs. Scopio handles image uploads and compliance requirements automatically.
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 see which AI agents interact with my products?
GET /api/seller/analytics returns 30-day stats broken down by LLM agent (Claude, ChatGPT, Gemini, Perplexity, Copilot) plus 7-day sparkline and top EANs.
Ready to integrate?
Generate your API key, pick your integration method, send first product. Instant response.