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 automated 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
}A separate, broader endpoint for AI agents — commerce, real estate, travel, social media, and more, all in one connection.
Endpoint
POST https://api.scopio.pl/mcpSearch products, browse categories, build a cart, check out.
Search property listings by location, price, and amenities.
Find flights, price calendars, and hotels with booking links.
Check medicine availability and stock across locations.
Generate hashtags and captions, publish and schedule posts.
Generate product photos, videos, and virtual try-on.
Find and enrich business leads, queue them for outreach.
A brandable AI chat widget that adapts to any business.
Connect and sync an existing online store catalog.
Browse and subscribe to service tiers directly.
Unlike the product-sync endpoint above — built specifically for pushing your own catalog into Scopio — this general-purpose server gives any AI agent access across the whole platform: browsing catalogs, planning trips, checking pharmacy stock, running a full social media publishing pipeline, generating AI content, and more. A handful of tools are free and open with no authentication at all; the rest activate with a Scopio subscription, and the agent walks the user through picking a plan and getting a key without leaving the conversation.
Some tools are free and open to any agent — no account required. Deeper tools require an active subscription.
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.
What's the difference between the product-sync MCP and the general MCP server?
The product-sync endpoint (POST /api/seller/products/mcp) is narrowly built for pushing your own catalog into Scopio. The general MCP server (POST https://api.scopio.pl/mcp) is a much broader endpoint covering the whole platform — marketplace search, real estate, travel, pharmacy, social publishing, AI content generation, lead generation, and more — usable by any AI agent, not just sellers syncing inventory.
Do I need an API key to use the general MCP server?
Not for every tool. A subset of tools, like hashtag and caption generation, are free and open to any agent with no authentication. Deeper tools require an active Scopio subscription — call the catalog tool first to see available plans, then subscribe directly from the conversation.
Ready to integrate?
Generate your API key, pick your integration method, send first product. Instant response.