What can you do with the 3Dsellers API?
The 3Dsellers API (and MCP) lets you connect your own tools, scripts, or AI agents directly to your 3Dsellers account. Here are the main things you can do and why they are useful.
What you'll need
OAuth2 bearer token - generate one from your 3Dsellers account under Settings > API
Your seller ID - found in Settings > Connected Accounts (needed for orders and listings calls)
Base URL -
https://api.3dsellers.com
The full interactive reference is at api.3dsellers.com/docs - you can try every endpoint directly in your browser.
Search and manage your product catalog
Use GET /v1/products (MCP: get-products) to search products by SKU, paginate through your catalog, or pull in variant data. You can also create, update, or partially patch products - including inventory, pricing, images, custom attributes, and dimensions - without touching the UI.
Useful for: syncing an external inventory system, bulk-updating prices from a spreadsheet tool, or checking whether a SKU exists before creating a new product.
# Search for a product by SKU curl -X GET "https://api.3dsellers.com/v1/products?sku=MY-SKU-123" \ -H "Authorization: Bearer YOUR_TOKEN"# Include variants in the response curl -X GET "https://api.3dsellers.com/v1/products?sku=MY-SKU-123&withVariants=true" \ -H "Authorization: Bearer YOUR_TOKEN"
Search listings by channel or seller account
Use GET /v1/products/listings (MCP: get-product-listings) to filter listings by SKU, channel (eBay, Amazon, Etsy...), seller account, and status (Active, Library, Ended).
Useful for: checking if a product is live on a specific marketplace, auditing which listings are active per account, or building a custom dashboard per channel.
# Find all active eBay listings for a specific SKU curl -X GET "https://api.3dsellers.com/v1/products/listings?sku=MY-SKU-123&channel=ebay&status=Active" \ -H "Authorization: Bearer YOUR_TOKEN"
Read orders
Use GET /v1/orders (MCP: get-orders) to pull orders for a seller, filtered by status, channel, SKU, or external order ID.
Useful for: feeding order data into an external reporting tool, triggering fulfillment workflows, or monitoring specific order statuses in real time.
# Get orders for a seller (seller ID required) curl -X GET "https://api.3dsellers.com/v1/orders?sellerId=12345&status=paid" \ -H "Authorization: Bearer YOUR_TOKEN"
List your connected seller accounts
Use GET /v1/sellers (MCP: get-sellers) to see all marketplace accounts connected to your 3Dsellers company, optionally filtered by channel.
Useful for: knowing which seller IDs to use when filtering orders or listings, or verifying which accounts are active.
# List all connected seller accounts curl -X GET "https://api.3dsellers.com/v1/sellers" \ -H "Authorization: Bearer YOUR_TOKEN"
Monitor CSV imports
Use GET /v1/import-csv (MCP: get-import-csvs) to check the status of import jobs, and GET /v1/import-csv/:id/errors to see which rows failed and why.
Useful for: automating import pipelines and getting notified when an import finishes or fails, without logging into the app.
# Check status of all imports for a seller curl -X GET "https://api.3dsellers.com/v1/import-csv?sellerId=12345" \ -H "Authorization: Bearer YOUR_TOKEN"# Get per-row errors for a specific import curl -X GET "https://api.3dsellers.com/v1/import-csv/67890/errors" \ -H "Authorization: Bearer YOUR_TOKEN"
Get notified automatically with webhooks
Subscribe a URL to receive notifications when specific events happen in 3Dsellers:
order.created- fires when a new order comes inimport-csv.status-updated- fires when an import job changes status
Use POST /webhooks/subscribe to register your endpoint, and POST /webhooks/unsubscribe to stop receiving events.
Useful for: triggering external workflows (Zapier, n8n, custom scripts) the moment something happens, without polling the API.
# Subscribe to new order notifications
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"]
}'Use it with AI agents (MCP)
All of the above is also available via the Model Context Protocol (MCP) endpoint, which lets AI tools like Claude Code or Cursor call your 3Dsellers data directly as part of an automated workflow.
Useful for: building AI-powered automations - for example, an agent that checks inventory, finds listings below a threshold, and updates them automatically.
# MCP endpoint (streamable HTTP) https://api.3dsellers.com/mcp# MCP endpoint (SSE transport) https://api.3dsellers.com/sse
Getting started
All API calls require an OAuth2 bearer token. You can generate one from your 3Dsellers account under Integrations > API.
The full interactive API documentation - including all endpoints, parameters, and the ability to try calls directly in your browser - is available at api.3dsellers.com/docs.
