Fee API for developers

Last updated August 2026

A free JSON API for what selling online actually costs: 31 marketplaces and payment processors, every rate verified monthly against the platform’s own fee page, plus a 20-country fee index. No key, no signup, CORS open.

We built this database for our own calculators and there is no reason to keep it locked up. If you are building a seller tool, a margin dashboard, an accounting integration, or a research project, this saves you the part nobody enjoys: reading twenty-eight pricing pages every month and noticing when one quietly changes.

Quick start

curl "https://www.profitvana.com/api/v1/calculate?platform=ebay-fee-calculator&salePrice=100&itemCost=40"

Every response uses the same envelope: { "ok": true, "data": ... } on success, and { "ok": false, "error": { "code", "message" } } on failure, with a matching HTTP status.

Endpoints

`GET /api/v1/platforms`

Every platform we track (31).

Summary objects for every marketplace and processor, including whether the rate has been verified and when the values last changed.

https://www.profitvana.com/api/v1/platforms

{
  "ok": true,
  "data": {
    "platforms": [
      {
        "slug": "ebay-fee-calculator",
        "platform": "eBay",
        "category": "Marketplaces",
        "verified": true,
        "region": "US",
        "updatedAt": "2026-05"
      }
    ]
  }
}

`GET /api/v1/platforms/{slug}`

Full fee structure for one platform.

The complete fee model — every percentage, fixed fee, tier and category rate — plus sourceUrl, updatedAt, and verifiedAt so you can cite the origin and show your users how fresh the number is.

https://www.profitvana.com/api/v1/platforms/etsy-fee-calculator

`GET or POST /api/v1/calculate`

Fees and net profit for one sale.

Parameters: platform (slug, required), salePrice (required), shippingCharged, itemCost, shippingCost. POST the same keys as JSON if you prefer.

The feeBreakdown includes the arithmetic behind each line, which is usually what you want to show a user rather than a single total.

https://www.profitvana.com/api/v1/calculate?platform=ebay-fee-calculator&salePrice=100&itemCost=40

{
  "ok": true,
  "data": {
    "result": {
      "grossRevenue": 100,
      "totalFees": 14.0,
      "netProfit": 46,
      "profitMargin": 46,
      "feeBreakdown": [
        { "label": "Final value fee (13.60%)", "amount": 13.6,
          "detail": "13.60% × $100.00" },
        { "label": "Per-order fee", "amount": 0.4 }
      ]
    }
  }
}

`GET /api/v1/compare`

The same sale priced across every platform.

Runs one sale through all verified platforms and returns them ranked, which is the endpoint most people actually want: not “what does eBay charge” but “where should this item be listed”.

https://www.profitvana.com/api/v1/compare?salePrice=100&itemCost=40

`GET /api/v1/fee-index`

The Global Fee Index: 20 countries, 4 providers.

The full cross-country dataset behind the Global Fee Index — what Stripe, PayPal, Shopify Payments, and Amazon charge in each market, each row carrying the official source URL it was read from and the date it was verified.

Free to use and quote with attribution. This is the endpoint to use for research or bulk analysis rather than looping the per-platform ones.

https://www.profitvana.com/api/v1/fee-index

`GET /api/v1/rates`

Live currency and metal reference rates.

The reference rates powering our currency and gold pages, refreshed automatically. Reference data, not dealer or bank pricing.

https://www.profitvana.com/api/v1/rates

Attribution

Use is free, commercially included. In return we ask for a visible credit with a link — anything along these lines is fine:

Fee data from <a href="https://www.profitvana.com">Profitvana</a>

If you would rather embed a working calculator than call the API, the embeddable widgets are a one-line iframe and stay current automatically.

Stability and support

Versioning: the path carries the version. Breaking changes go to /api/v2; /api/v1 keeps its shape.
Caching: responses are cached at the edge for a day and revalidated in the background. Cache on your side too.
Accuracy: if a rate looks wrong, tell us — see the editorial policy for how corrections are handled. We treat fee errors as urgent because people price real products against them.
Questions and bug reports: hello@profitvana.com.

Frequently asked questions

Is the fee API really free?

Yes. There is no key, no signup, no account, and no usage tier. It is the same fee database that powers our own calculators, exposed read-only over HTTPS with open CORS. We ask only for attribution and a link when you publish something built on it.

Do I need an API key or authentication?

No. Every endpoint is a plain unauthenticated GET. You can call them from a browser, a serverless function, a spreadsheet, or a notebook without registering anything.

Are there rate limits?

There is no published quota. Responses are cached hard at the edge, so normal use costs us nothing — please cache on your side too rather than calling per page view, and if you need bulk data use the fee index endpoint once instead of looping the per-platform ones.

How current is the fee data?

Every rate is re-verified monthly against the platform's own official fee page, and immediately when a platform announces a change. Each platform object carries its own updatedAt and verifiedAt fields plus the source URL, so you can show your users when the number was last checked.

Can I use it commercially?

Yes, including in a commercial product, with attribution and a link back. If you build something on it we would genuinely like to see it — email hello@profitvana.com.