find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/wisepim:wisepim-marketplace-fees-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: WISEPIM Open Data Marketplace fees API
  version: 1.0.0
  summary: Free GTIN/EAN validation, HS code lookup and European marketplace fee data.
  description: 'A free, keyless reference API for product data: validate GTIN, EAN, UPC and ISBN barcodes and find the GS1 prefix origin, browse the EU Combined Nomenclature and US HTS customs tariffs, and read a sourced dataset of European marketplace seller fees (Amazon, eBay, bol, OTTO, Kaufland, Allegro and more).


    **Terms:** free for commercial and non-commercial use. Show a visible link with the text "Data by WISEPIM" wherever the data appears; every response carries the exact link in `attribution`. Limit: 120 requests a minute per IP; responses may be cached for an hour. Full terms: https://wisepim.com/developers/open-data#terms'
  termsOfService: https://wisepim.com/developers/open-data#terms
  contact:
    name: WISEPIM
    url: https://wisepim.com/developers/open-data
    email: support@wisepim.com
  x-logo:
    url: https://wisepim.com/wisepim-logo.png
servers:
- url: https://wisepim.com/api/open/v1
tags:
- name: Marketplace fees
  description: Sourced seller fees of European marketplaces.
paths:
  /marketplace-fees:
    get:
      tags:
      - Marketplace fees
      operationId: listFeeMarketplaces
      summary: Marketplaces, fee types and dataset metadata
      responses:
        '200':
          description: The dataset index
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeIndex'
  /marketplace-fees/calculate:
    get:
      tags:
      - Marketplace fees
      operationId: calculateMarketplaceFees
      summary: Fees, payout and margin for one sale at any price
      description: Without `calculator`, lists the calculators with their parameters and categories. With it, runs the same cent-exact math as WISEPIM's eBay, Etsy, Amazon FBA and bol calculators. Other parameters depend on the calculator; see the listing.
      parameters:
      - name: calculator
        in: query
        schema:
          type: string
          enum:
          - ebay-us
          - ebay-de
          - ebay-fr
          - etsy
          - amazon-us
          - amazon-de
          - bol
      - name: price
        in: query
        description: Item price in the marketplace currency.
        schema:
          type: number
          minimum: 0
        example: 50
      - name: category
        in: query
        description: Category key from the listing.
        schema:
          type: string
      - name: shipping
        in: query
        schema:
          type: number
          minimum: 0
          default: 0
      - name: cost
        in: query
        description: Your product cost, for profit and margin.
        schema:
          type: number
          minimum: 0
          default: 0
      responses:
        '200':
          description: The fee breakdown, or the calculator listing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeCalculation'
        '400':
          description: Unknown calculator, category or a bad number
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /marketplace-fees/compare:
    get:
      tags:
      - Marketplace fees
      operationId: compareMarketplaceFees
      summary: Fee on a 50 EUR sale by category across marketplaces
      parameters:
      - name: category
        in: query
        required: false
        description: A category id, e.g. consumer_electronics.
        schema:
          type: string
      responses:
        '200':
          description: The comparison table
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeComparison'
        '400':
          description: Unknown category
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /marketplace-fees/{marketplace}:
    get:
      tags:
      - Marketplace fees
      operationId: getMarketplaceFees
      summary: Every sourced fee row of one marketplace
      parameters:
      - name: marketplace
        in: path
        required: true
        schema:
          type: string
        example: amazon
      - name: market
        in: query
        description: ISO 3166-1 alpha-2 country, e.g. DE.
        schema:
          type: string
          pattern: ^[A-Za-z]{2}$
      - name: feeType
        in: query
        schema:
          type: string
          enum:
          - advertising
          - commission
          - cross_border_fx
          - fixed_fee
          - logistics
          - payment
          - subscription
          - tax_or_regulatory
          - terms_and_context
          - vat
      - name: format
        in: query
        description: '`csv` returns the rows as CSV for spreadsheets (`=IMPORTDATA(url)`), with the attribution in the last column.'
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
      responses:
        '200':
          description: The matching rows
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeRows'
            text/csv:
              schema:
                type: string
        '400':
          description: Bad filter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Unknown marketplace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Attribution:
      type: object
      description: 'Credit to show wherever the data appears: a visible link with the text "Data by WISEPIM" to `url`.'
      required:
      - required
      - text
      - url
      - html
      - markdown
      - terms
      properties:
        required:
          type: boolean
          const: true
        text:
          type: string
          example: Data by WISEPIM
        url:
          type: string
          format: uri
          example: https://wisepim.com/hs-codes/8471
        html:
          type: string
          example: <a href="https://wisepim.com/hs-codes/8471">Data by WISEPIM</a>
        markdown:
          type: string
          example: '[Data by WISEPIM](https://wisepim.com/hs-codes/8471)'
        terms:
          type: string
          format: uri
    FeeComparison:
      type: object
      properties:
        verifiedOn:
          type: string
          format: date
        referencePriceEur:
          type: number
        description:
          type: string
        assumptions:
          type: array
          items:
            type: string
        columns:
          type: array
          items:
            type: object
        categories:
          type: array
          items:
            type: object
        attribution:
          $ref: '#/components/schemas/Attribution'
    FeeMarketplace:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        markets:
          type: array
          items:
            type: string
        feeCurrency:
          type: string
    FeeSource:
      type: object
      properties:
        url:
          type: string
          format: uri
        title:
          type: string
    FeeIndex:
      type: object
      properties:
        verifiedOn:
          type: string
          format: date
        refreshCadence:
          type: string
        rowCount:
          type: integer
        feeTypes:
          type: array
          items:
            type: string
        marketplaces:
          type: array
          items:
            $ref: '#/components/schemas/FeeMarketplace'
        attribution:
          $ref: '#/components/schemas/Attribution'
    FeeRow:
      type: object
      properties:
        id:
          type: string
        marketplace:
          type: string
        entity:
          type: string
        markets:
          type: array
          items:
            type: string
        feeType:
          type: string
        obligation:
          type: string
        field:
          type: string
        value:
          type: string
          description: The fee as published, e.g. "EUR 39 per month, excl. VAT".
        scope:
          type: string
        effectiveDate:
          type:
          - string
          - 'null'
          format: date
        notes:
          type:
          - string
          - 'null'
        confidence:
          type: string
        verification:
          type: string
        verifiedOn:
          type: string
          format: date
        source:
          $ref: '#/components/schemas/FeeSource'
    Error:
      type: object
      required:
      - error
      - docs
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - invalid_request
              - not_found
              - method_not_allowed
              - rate_limited
              - unavailable
            message:
              type: string
        docs:
          type: string
          format: uri
    FeeCalculation:
      type: object
      properties:
        calculator:
          type: string
        currency:
          type: string
        verifiedOn:
          type: string
          format: date
        fees:
          type: array
          items:
            type: object
            properties:
              key:
                type: string
              label:
                type: string
              amount:
                type: number
              pct:
                type: number
        totalFees:
          type: number
        vatOnFees:
          type: number
        payout:
          type: number
        netRevenue:
          type: number
        profit:
          type: number
        marginPct:
          type:
          - number
          - 'null'
        notes:
          type: array
          items:
            type: string
        sources:
          type: array
          items:
            $ref: '#/components/schemas/FeeSource'
        calculators:
          type: array
          items:
            type: object
          description: Only in the listing (no calculator).
        attribution:
          $ref: '#/components/schemas/Attribution'
    FeeRows:
      type: object
      properties:
        marketplace:
          $ref: '#/components/schemas/FeeMarketplace'
        count:
          type: integer
        rows:
          type: array
          items:
            $ref: '#/components/schemas/FeeRow'
        attribution:
          $ref: '#/components/schemas/Attribution'
externalDocs:
  description: Documentation and examples
  url: https://wisepim.com/developers/open-data