API Reference | Sellertics

🔐 Authentication

All API requests require an API key passed in the request header. Generate your key in Settings → API.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

GET

/v1/metrics

Retrieve profit and revenue metrics for a given date range and marketplace filter.

// Example Request
GET https://api.sellertics.com/v1/metrics?from=2026-01-01&to=2026-01-31&marketplace=amazon

// Response
{
  "revenue": 84320.00,
  "net_profit": 22180.00,
  "margin_pct": 26.3,
  "orders": 1847,
  "refund_rate": 2.1
}

Parameter	Type	Description
from	date	Start date (YYYY-MM-DD)
to	date	End date (YYYY-MM-DD)
marketplace	string	Filter: amazon, flipkart, ebay, walmart, all

GET

/v1/orders

List orders with full cost breakdown including fees, refunds, and net margin per order.

// Example Response (truncated)
{
  "orders": [
    {
      "order_id": "404-1234567-8901234",
      "marketplace": "amazon",
      "revenue": 45.99,
      "fees": 7.89,
      "cogs": 18.40,
      "net_profit": 19.70
    }
  ],
  "total": 1847,
  "page": 1
}

POST

/v1/costs

Bulk upload product costs (COGS, shipping, custom fees) via the API.

// Request Body
{
  "costs": [
    {
      "sku": "B08XK8QVZT",
      "cogs": 18.40,
      "shipping": 3.20,
      "currency": "USD"
    }
  ]
}