Scopio
API Dokumentation

Bauen mit Scopio
API.

REST API, UCP, MCP-Server, XML/JSON-Feed, Kalender und Analysen — alles, was KI-Agenten und ERP-Systeme für die Integration mit dem Scopio European Marktplatz benötigen.

API-Schlüssel erhaltenEntwickler-Support
Authentifizierung

Bearer API-Schlüssel

Alle Endpunkte erfordern ein Bearer-Token. Generieren Sie Ihren Schlüssel in Kontoeinstellungen → Integrationen → API-Schlüssel. Format: sk_mkt_...

HeaderAuthorization: Bearer sk_mkt_YOUR_KEY
Content-Typeapplication/json
Basis-URLhttps://business.scopio.pl

Schnelltest — 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}]'

Antwort

{"updated":1,"pending_review":0,"errors":0}
Produktsynchronisierung

6 Integrationsmethoden

Alle Methoden akzeptieren EAN + Preis + Menge. Wählen Sie die Methode, die zu Ihrem Tech-Stack passt.

Native

REST API

Echtzeit-JSON-Sync. Array von Produkten, bis zu 10.000 pro Anfrage. EANs im Katalog gehen sofort live.

POST /api/seller/products
[{"ean":"8721199108286","price":29.99,"qty":10}]
Standard

XML Feed

XML-Katalog hochladen. Generisches Format und Google Shopping RSS werden unterstützt. Ideal für ERP-Systeme.

POST /api/seller/products/xml
{"url":"https://yourshop.pl/feed.xml"}
URL Sync

JSON Feed

Geben Sie uns Ihre JSON-Feed-URL an. Wir rufen sie automatisch in regelmäßigen Abständen ab.

POST /api/seller/products/json-feed
{"url":"https://yourshop.pl/products.json"}
Offline

Excel / XLSX

Excel-Datei hochladen. Erforderliche Spalten: EAN, Preis, Menge. Keine Programmierkenntnisse erforderlich.

POST /api/seller/products/xlsx
multipart/form-data: file=products.xlsx
FTP

FTP Transfer

FTP-Zugangsdaten einmalig speichern. Wir rufen Ihre Produktdatei (JSON, XML oder CSV) bei Bedarf ab.

POST /api/seller/products/ftp
{"host":"ftp.yourshop.pl","user":"u","pass":"p","path":"/products.json"}
AI Ready

MCP Server

JSON-RPC 2.0 Standard für KI-Agenten. Claude, ChatGPT und Gemini können Datenbank-Tools direkt aufrufen.

POST /api/seller/products/mcp
{"jsonrpc":"2.0","method":"sync_products","params":{...},"id":1}

Antwortformat

"updated": N

EANs abgeglichen → sofort live auf dem Marktplatz

"pending_review": N

Unbekannte EANs → zur Google Merchant-Verifizierung in die Warteschlange gestellt

"errors": N

Validierungsfehler mit Details pro Produkt

KI-Agenten

MCP-Server

JSON-RPC 2.0 Endpunkt. Claude, ChatGPT, Gemini und jeder benutzerdefinierte Agent rufen Scopio-Tools direkt auf — kein manueller Datenexport erforderlich.

sync_products

Übermittelt Produkt-Array an den Marktplatz. Gibt Anzahl aktualisierter, in Prüfung befindlicher und fehlerhafter Produkte zurück.

params: {"products": [{"ean": "string", "price": number, "qty": number}]}
check_ean

Prüft EAN im Scopio-Katalog. Gibt Status zurück: live | pending | unknown.

params: {"ean": "string"}
get_offers

Ruft die aktuell aktiven Marktplatz-Angebote des Händlers ab.

params: {}

Endpunkt

POST /api/seller/products/mcp

Beispielanfrage

{
  "jsonrpc": "2.0",
  "method": "sync_products",
  "params": {
    "products": [
      {"ean":"8721199108286","price":29.99,"qty":10}
    ]
  },
  "id": 1
}

Antwort

{
  "jsonrpc": "2.0",
  "result": {"updated":1,"pending_review":0,"errors":0},
  "id": 1
}
Kalender API

Buchung via KI-Agenten

Ermöglicht es KI-Agenten, freie Termine autonom im Namen der Kunden zu prüfen und zu buchen.

Freie Termine abrufen

GET /api/calendar/slots?date=2025-06-15&duration=30

Rückgabe: [{slot_id, start, end, available}]

Termin buchen

POST /api/calendar/book
{
  "slot_id": "...",
  "client_name": "Jan Kowalski",
  "client_email": "jan@firma.pl",
  "service_name": "Demo call",
  "duration": 30
}
KI-Analysen

KI-Traffic-Statistiken

Sehen Sie, wie oft Claude, ChatGPT, Gemini und andere Agenten mit Ihren Produkten interagiert haben.

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}
  ]
}
Webhooks

Eingehende Webhooks

Konfigurieren Sie eine Webhook-URL in Ihrem Panel. Wir senden POST-Benachrichtigungen über Ereignisse (z. B. order.placed) in Echtzeit.

Webhook registrieren

POST /api/seller/webhooks
{
  "url": "https://yourshop.pl/scopio-hook",
  "events": ["order.placed","product.updated"]
}

Nutzdaten — order.placed

{
  "event": "order.placed",
  "order_id": "ORD-2026-...",
  "ean": "8721199108286",
  "qty": 2,
  "buyer_country": "DE",
  "created_at": "2026-05-26T12:00:00Z"
}
TikTok Shop Integration

TikTok Shop API

Verwalten Sie Integrationseinstellungen, synchronisieren Sie Produkte konform mit EU-GPSR und rufen Sie TikTok Shop-Bestellungen ab.

GET/api/seller/tiktok/config
Erfordert Header Authorization: Bearer sk_mkt_...

Gibt den Verbindungsstatus, den Shopnamen, die Region sowie die Standard-GPSR- und Lager-Mappings zurück.

POST/api/seller/tiktok/config
Erfordert Header Authorization: Bearer sk_mkt_...

Speichert oder aktualisiert die Verbindungseinstellungen für den TikTok Shop, Versandvorlagen und 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
}
GET/api/seller/tiktok/warehouses
Erfordert Header Authorization: Bearer sk_mkt_...

Ruft die Liste der aktiven Lagerhäuser aus Ihrem TikTok Shop-Logistikprofil ab, die für Bestandsupdates benötigt werden.

POST/api/seller/tiktok/sync
Erfordert Header Authorization: Bearer sk_mkt_...

Löst die sofortige Synchronisierung von Angeboten im TikTok Shop aus. Überprüft den EAN-Status, lädt Bilder hoch, richtet EU-GPSR-Sicherheitsdetails ein oder aktualisiert Preise/Bestände.

Liste der zu synchronisierenden EANs (optional, leeres Array synchronisiert alles).

{
  "eans": ["5901234123457", "5901234123464"]
}

Antwort

{
  "success": true,
  "synced_count": 2,
  "created": 1,
  "updated": 1,
  "message": "TikTok EU Sync: 1 created, 1 updated."
}
GET/api/seller/tiktok/orders
Erfordert Header Authorization: Bearer sk_mkt_...

Ruft im Cache gespeicherte TikTok Shop-Bestellungen ab. Verwenden Sie den Abfrageparameter ?refresh=1, um Live-Bestellungen direkt von der TikTok-API abzurufen.

Häufig gestellte Fragen (FAQ)

Welche Authentifizierungsmethode verwendet die Scopio-API?

Bearer API-Schlüssel. Generieren Sie den Schlüssel sk_mkt_... im B2B-Konto. Fügen Sie den Header hinzu: Authorization: Bearer sk_mkt_...

Welche Produktfelder sind für die Synchronisierung erforderlich?

Minimum: ean (String), price (Nummer), qty (Ganzzahl). Beispiel: [{"ean":"5901234123457","price":29.99,"qty":10}]

Unterstützt Scopio das UCP (Universal Commerce Protocol)?

Ja. Scopio ist die erste Plattform in Europa, die den UCP-Standard implementiert, sodass KI-Agenten Angebote dynamisch abrufen und Käufe abwickeln können.

Wie funktioniert die TikTok Shop-Integration?

Es ist vollautomatisch. Sie verbinden Ihren TikTok Shop per OAuth, legen Standardeinstellungen fest (Versand, Kategorie, Lager, GPSR-Profile) und rufen POST /api/seller/tiktok/sync mit EAN-Codes auf. Scopio erledigt den Rest.

Können KI-Agenten Termine im Kalender buchen?

Ja. Der Endpoint GET /api/calendar/slots gibt freie Termine zurück, und POST /api/calendar/book erstellt die Buchung.

Wie verfolge ich Interaktionen von KI-Modellen?

Die Abfrage GET /api/seller/analytics liefert 30-Tage-Statistiken aufgeteilt nach LLM-Modellen (Claude, ChatGPT, Gemini usw.), die auch in Ihrem Dashboard angezeigt werden.

Bereit zur Integration?

Vollständige API live.
Start in 5 Minuten

Generieren Sie Ihren API-Schlüssel, wählen Sie Ihre Methode und senden Sie das erste Produkt. Erhalten Sie eine sofortige Antwort.

API-Schlüssel erhaltenIntegrationshandbuch