Was können Sie mit der 3Dsellers API tun?

Was Sie benötigen

Ein Bearer-Token - erstellen Sie eines in Ihrem 3Dsellers-Konto unter Settings > Integrations. Wenn Sie das Token in der App erstellen, können Sie es direkt verwenden; der vollständige OAuth2-Ablauf ist nur nötig, wenn Sie eine App entwickeln, die andere Verkäufer autorisieren
Ihre Seller ID - über GET /v1/sellers oder Settings > Connected Accounts. Die meisten kontobezogenen Aufrufe benötigen sie
Basis-URL - https://api.3dsellers.com

Die vollständige interaktive Referenz finden Sie unter api.3dsellers.com/docs, wo Sie jeden Endpunkt direkt in Ihrem Browser ausprobieren können.

Ihren Produktkatalog verwalten

Verwenden Sie GET /v1/products, um Produkte nach SKU zu suchen, durch Ihren Katalog zu blättern oder Variantendaten abzurufen. Sie können außerdem Produkte erstellen, aktualisieren oder patchen, einschließlich Inventar, Preisen, Bildern, benutzerdefinierten Attributen und Abmessungen.

Nützlich für: die Synchronisierung eines externen Inventarsystems, das massenhafte Aktualisieren von Preisen aus einem Tabellenkalkulationstool oder das Prüfen, ob eine SKU bereits existiert, bevor Sie ein Produkt erstellen.

# Search for a product by SKUcurl -X GET "https://api.3dsellers.com/v1/products?sku=MY-SKU-123" \  -H "Authorization: Bearer YOUR_TOKEN"# Include variants in the responsecurl -X GET "https://api.3dsellers.com/v1/products?sku=MY-SKU-123&withVariants=true" \  -H "Authorization: Bearer YOUR_TOKEN"

Angebote nach Kanal oder Verkäuferkonto durchsuchen

Verwenden Sie GET /v1/products/listings, um Angebote nach SKU, Kanal, Verkäuferkonto und Status (Active, Library, Ended) zu filtern. POST /v1/products/listings/tags fügt Angebots-Tags massenhaft hinzu oder entfernt sie.

Nützlich für: die Prüfung, ob ein Produkt auf einem Marktplatz live ist, das Auditieren aktiver Angebote pro Konto oder den Aufbau eines Dashboards pro Kanal.

Produkte veröffentlichen und Kanalkategorien zuordnen

POST /v1/actions/products/publish überträgt Katalogprodukte auf einen Marktplatz. Davor entscheiden die Kategoriezuordnungs-Endpunkte, wo sie landen: GET /v1/products/category-mappings/unmapped listet Katalogkategorien ohne Kanalkategorie auf (diese werden ohne jegliche Kategorie veröffentlicht), und PUT /v1/products/category-mappings behebt das massenhaft. POST /v1/products/templates/mappings wendet Item Specifics über Ihre Mapping-Vorlagen hinweg an.

Nützlich für: das Onboarding eines neuen Katalogs oder das Beheben von Angeboten, die mit fehlenden Item Specifics veröffentlicht werden.

Bestellungen lesen und versenden

GET /v1/orders ruft Bestellungen für einen Verkäufer ab, gefiltert nach Status, Kanal, SKU oder externer Bestell-ID. POST /v1/orders/tracking sendet Versanddienstleister und Sendungsnummer zurück an den Marktplatz, und POST /v1/orders/tags versieht Bestellungen massenhaft mit Tags.

Nützlich für: das Einspeisen von Bestelldaten in ein externes Reporting oder das Versenden von Bestellungen aus Ihrem eigenen Lagersystem, ohne die App zu öffnen.

# Get orders for a sellercurl -X GET "https://api.3dsellers.com/v1/orders?sellerId=12345&status=paid" \  -H "Authorization: Bearer YOUR_TOKEN"# Push tracking back to the marketplacecurl -X POST "https://api.3dsellers.com/v1/orders/tracking" \  -H "Authorization: Bearer YOUR_TOKEN" \  -H "Content-Type: application/json" \  -d '{ "items": [{ "orderId": 987654, "carrier": "USPS", "trackingNumber": "9400111899560000000000" }] }'

Ihren Helpdesk spiegeln

Lesen Sie Tickets und ihre vollständigen Nachrichtenverläufe, einschließlich Foto-Anhängen von Käufern, antworten Sie Käufern und ändern Sie Ticketstatus. GET /v1/helpdesk/tickets, /counts, /{id}/messages, POST /{id}/replies und PATCH /{id}.

Nützlich für: den Support über Ihr eigenes Dashboard oder das Einspeisen von Käufernachrichten und Fotos in ein KI-Tool, das Antworten entwirft oder klassifiziert.

Daten exportieren und Reports planen

POST /v1/exports stellt jeden der in der App verfügbaren Exporte in die Warteschlange: Catalog, Inventory, Bundles, Listings, Orders, Cases, Images, SKU-Bestand, Codes für digitale Waren und eBay-Anzeigenreports. POST /v1/exports/schedules macht daraus einen wiederkehrenden Export, der eine feste URL erneut veröffentlicht, die eine Tabellenkalkulation lesen kann.

Nützlich für: einen täglichen Bestell-Feed in Google Sheets oder das Bereitstellen einer Bestandsdatei für einen Lieferanten, die sich selbst aktualisiert.

Massenaktionen ausführen

POST /v1/actions stellt dieselben Batch-Vorgänge in die Warteschlange, die die App ausführt, wenn Sie Zeilen in einem Raster auswählen: Veröffentlichen, Preisänderungen, Policies, Tags, SKU-Generierung, Bestellungen als versendet markieren und rund hundert weitere. Sie laufen asynchron, sodass GET /v1/actions/{id} den Fortschritt meldet.

Nützlich für: alles, was einzeln zu lange dauern würde. Führen Sie bei einer filterbasierten Auswahl immer zuerst einen Testlauf durch.

Feste Regeln einrichten

Drei Arten von Regeln arbeiten weiter, nachdem Sie sie erstellt haben:

Automations (/v1/automations) - ein Trigger plus Aktionen, über Listings, Katalogprodukte, Orders und den Helpdesk hinweg. Geplante Preisstaffeln, Tag-Regeln, automatisches Relisten, Benachrichtigungen
Offer rules (/v1/offers/rules) - senden Sie eBay Best Offers an Beobachter oder reagieren Sie automatisch auf eingehende Angebote
Auto Messages (/v1/auto-messages/messages) - Nachrichten an Käufer nach dem Verkauf, ausgelöst durch Bestell- und Bewertungsereignisse, mit länderspezifischen Textkörpern

Listing Designer-Vorlagen und Store-Struktur verwalten

/v1/listing-designer/templates erstellt und bearbeitet die HTML-Designs, die um eBay-Angebotsbeschreibungen gelegt werden, und /v1/listing-designer/auto-apply steuert, welche Vorlage neue Angebote übernehmen. /v1/sellers/{sellerId}/store-categories verwaltet die Navigationsbereiche Ihres eBay Stores.

Verkäuferkonten und Integrationen verwalten

GET /v1/sellers listet verbundene Marktplatzkonten auf. GET /v1/sellers/integrations/status meldet, ob jedes davon verbunden ist und ob tatsächlich Daten fließen, und PUT /v1/sellers/integrations/inventory-sync schaltet die Katalog-Inventarsynchronisierung pro Konto ein oder aus. GET /v1/sellers/{sellerId}/policies gibt eBay Business Policies zurück, die beim Veröffentlichen verwendet werden.

Filter speichern und wiederverwenden

Segments sind gespeicherte Filtersätze, lesbar und schreibbar unter /v1/segments. Da Massenaktionen, Exports, Automations und Offer Rules alle dieselbe Filterstruktur verwenden, ist es am schnellsten, eine Ansicht in der App zu erstellen und das Segment zurückzulesen, um einen garantiert korrekten Filterbaum zu erhalten.

CSV-Importe überwachen

GET /v1/import-csv prüft den Status eines Importjobs, /{id}/errors zeigt, welche Zeilen fehlgeschlagen sind und warum, und /{id}/errors/download gibt alle abgelehnten Zeilen als CSV zurück.

Nützlich für: die Automatisierung von Import-Pipelines und die Benachrichtigung, wenn ein Import abgeschlossen ist oder fehlschlägt.

Automatisch per Webhook benachrichtigt werden

Abonnieren Sie eine URL, um Benachrichtigungen zu erhalten, wenn etwas passiert:

order.created - eine neue Bestellung geht ein
import-csv.status-updated - ein Importjob ändert seinen Status

Verwenden Sie POST /webhooks/subscribe, um Ihren Endpunkt zu registrieren, und POST /webhooks/unsubscribe, um dies zu beenden.

Nützlich für: das Auslösen externer Workflows (Zapier, n8n, eigene Skripte) in dem Moment, in dem etwas passiert, statt zu pollen.

curl -X POST "https://api.3dsellers.com/webhooks/subscribe" \  -H "Authorization: Bearer YOUR_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "webhook_url": "https://your-app.com/hooks/orders",    "events": ["order.created"]  }'

Mit KI-Agenten nutzen (MCP)

Das meiste davon ist auch über den Model Context Protocol-Endpunkt verfügbar, sodass KI-Tools Ihre 3Dsellers-Daten im Rahmen eines automatisierten Workflows abrufen können.

Ein Unterschied, den Sie kennen sollten: MCP-Tool-Ergebnisse sind nur Text. Wo ein Endpunkt Bild-URLs zurückgibt, etwa bei Foto-Anhängen von Käufern in einem Helpdesk-Ticket, erhält ein KI-Agent den Link, kann das Bild aber nicht sehen. Um Bilder an ein Modell zu übergeben, rufen Sie den REST-Endpunkt auf und laden Sie jede URL in Ihrem eigenen Code herunter.

# MCP endpoint (streamable HTTP)https://api.3dsellers.com/mcp# MCP endpoint (SSE transport)https://api.3dsellers.com/sse

Erste Schritte

Für alle API-Aufrufe ist ein OAuth2-Bearer-Token erforderlich. Sie können eines in Ihrem 3Dsellers-Konto unter Integrations > API erstellen.

Die vollständige interaktive API-Dokumentation - einschließlich aller Endpunkte, Parameter und der Möglichkeit, Aufrufe direkt in Ihrem Browser auszuprobieren - finden Sie unter api.3dsellers.com/docs.

Verwandte Artikel