API Documentation

Getting Started

Base URL

https://api.sunfelt.shop/v1

Authentication

All API requests require a Bearer token. Generate an API key from your Dashboard → Settings → API Keys.

Authorization: Bearer sk_live_your_api_key

Rate Limits

Plan	Requests / Minute
Starter	100
Growth	500
Enterprise	Custom

Response Format

All responses are returned in JSON format with appropriate HTTP status codes.

Endpoints

GET /orders

List orders across all connected marketplaces.

GET /products

List products and inventory levels.

GET /analytics/revenue

Get revenue analytics with date range filtering.

GET /analytics/profit

Get profit breakdown by SKU, marketplace, or time period.

POST /alerts

Create a custom alert rule.

Example Request

curl -H "Authorization: Bearer sk_live_..." \
  "https://api.sunfelt.shop/v1/analytics/revenue?start=2026-01-01&end=2026-06-01&group_by=marketplace"

Example Response

{
  "status": "ok",
  "data": {
    "start": "2026-01-01",
    "end": "2026-06-01",
    "group_by": "marketplace",
    "currency": "USD",
    "results": [
      {
        "marketplace": "Amazon US",
        "revenue": 184520.30,
        "orders": 3847
      },
      {
        "marketplace": "Amazon UK",
        "revenue": 62310.75,
        "orders": 1293
      },
      {
        "marketplace": "Shopify",
        "revenue": 41085.00,
        "orders": 872
      }
    ],
    "total_revenue": 287916.05,
    "total_orders": 6012
  }
}

SDKs

Official SDKs coming soon. In the meantime, use our REST API directly.