Etsy fee & net payout API

Compute Etsy fees — listing ($0.20) + transaction (6.5% of price+shipping) + payment processing (3% + $0.25) + optional offsite ads (15%) — and net payout; all rates overridable. Deterministic fee stacking. Answers 'what are my Etsy fees','Etsy net payout after fees','Etsy fees with offsite ads'.

Price$0.01per request

MethodPOST

Route/v1/calc/ecom-etsy-fee

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

ecometsyfeesmarketplaceprocessingoffsite-adssellercalc

API URLhttps://x402.hexl.dev/v1/calc/ecom-etsy-fee

Integration docs

Example request

{
  "itemPrice": 40,
  "shipping": 5,
  "offsiteAds": false,
  "unitCost": 15
}

Example response

{
  "formula": "fees = listing + (price+ship)×txnRate + ((price+ship)×procRate + procFlat) + offsiteAds; net = gross − fees",
  "itemPrice": 40,
  "shipping": 5,
  "gross": 45,
  "listingFee": 0.2,
  "transactionFee": 2.93,
  "processingFee": 1.6,
  "offsiteAdsFee": 0,
  "totalFees": 4.73,
  "feePercent": 10.5,
  "netPayout": 40.28,
  "unitCost": 15,
  "profitPerUnit": 25.28
}

Input schema

{
  "type": "object",
  "required": [
    "itemPrice"
  ],
  "properties": {
    "itemPrice": {
      "type": "number",
      "examples": [
        40
      ]
    },
    "shipping": {
      "type": "number",
      "examples": [
        5
      ]
    },
    "listingFee": {
      "type": "number",
      "description": "Default 0.20",
      "examples": [
        0.2
      ]
    },
    "transactionRate": {
      "type": "number",
      "description": "Default 0.065",
      "examples": [
        0.065
      ]
    },
    "processingRate": {
      "type": "number",
      "description": "Default 0.03",
      "examples": [
        0.03
      ]
    },
    "processingFlat": {
      "type": "number",
      "description": "Default 0.25",
      "examples": [
        0.25
      ]
    },
    "offsiteAds": {
      "type": "boolean",
      "examples": [
        false
      ]
    },
    "offsiteRate": {
      "type": "number",
      "description": "Default 0.15",
      "examples": [
        0.15
      ]
    },
    "unitCost": {
      "type": "number",
      "examples": [
        15
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}