Quickstart

Make your first product-cost request in five minutes.

1. Get an API key

Request a product-cost API key from your Mellow contact. The key only authorizes GET /external/v1/product-costs; it cannot access dashboard APIs.

2. Choose a date range

Both dates are required ISO dates and both boundaries are included. Use segment=normal unless you also need sample products.

3. Send the request

curl --get \
  'https://api.mellow-dev.billgateai.com/external/v1/product-costs' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'month_from=2026-07-01' \
  --data-urlencode 'month_to=2026-07-31' \
  --data-urlencode 'segment=normal'

A successful response is a JSON list:

[
  {
    "lingxing_product_id": 123,
    "lingxing_sku": "860014330490",
    "product_name": "Example",
    "purchase_cost_usd": 100.0,
    "inbound_freight_usd": 20.0,
    "shipping_to_customer_usd": null,
    "warehouse_fees_usd": 5.0
  }
]

4. Try it in the browser

Open the API Reference, expand Try it, enter your Bearer key and dates, then select Send. The key is kept in memory unless you explicitly choose Remember on this device.