Logo SearchApi

eBay Shipping Calculator API

GET   /api/v1/search?engine=ebay_shipping_calculator
OpenAPI Initiative Download OpenAPI Spec

The eBay Shipping Calculator API returns the shipping services eBay quotes a seller for a package, with eBay's price, the carrier's retail price, the estimated delivery window and the included coverage.

These are seller-side rates. For the shipping a buyer is charged on a specific listing, use the eBay Product API with its postal_code parameter instead.

API Parameters

Package

  • Name
    weight
    Required
    Required
    Description

    Package weight. Pounds when unit_system is imperial, kilograms when it is metric. With unit_system left out, pounds on ebay.com and kilograms on the other marketplaces. A partial ounce is priced as a whole one, so 2.01 is quoted as 2 lb 1 oz. At most 150 lb or 68.03 kg.

  • Name
    length
    Required
    Required
    Description

    Package length. Inches when unit_system is imperial, centimeters when it is metric. With unit_system left out, inches on ebay.com and centimeters on the other marketplaces. Under 130 in or 330 cm.

  • Name
    width
    Required
    Required
    Description

    Package width, in the same units as length and under the same limit.

  • Name
    height
    Required
    Required
    Description

    Package height, in the same units as length and under the same limit.

  • Name
    irregular_package
    Required
    Optional
    Description

    Set to true for packages carriers treat as irregular or oversized, which are surcharged.

Route

  • Name
    ship_from_zip
    Required
    Required
    Description

    Postal code the package ships from. The origin country is taken from ebay_domain, and the code must match that country's format: a 5-digit ZIP or ZIP+4 on ebay.com (10001), a postal code on ebay.ca (M5V 3L9), a postcode on ebay.co.uk (E1 6AN), 4 digits on ebay.com.au (2000), and 5 digits on ebay.de and ebay.fr (10115, 75001).

  • Name
    ship_to_country
    Required
    Optional
    Description

    Destination country as an ISO 3166-1 alpha-2 code. Defaults to the origin country, which quotes domestic services. Each marketplace ships to its own set of countries: ebay.de quotes mostly European destinations, and ebay.fr only Belgium, Germany, Spain, Luxembourg and Portugal. An unsupported destination returns an error listing the supported ones. On ebay.com, US territories such as Puerto Rico and Guam are quoted as domestic: leave ship_to_country unset and send the territory's ZIP in ship_to_zip.

  • Name
    ship_to_zip
    Required
    Optional
    Description

    Destination postal code. Omitting it on a domestic quote returns an estimate range instead of a single price for services whose price depends on the destination. International quotes return a single price either way. On ebay.co.uk, a quote without it is priced for mainland UK. When the destination is US, CA, GB, AU, DE or FR, the code must match that country's format, as for ship_from_zip.

Localization

  • Name
    ebay_domain
    Required
    Optional
    Description

    eBay marketplace to quote rates on. Supported values are ebay.com, ebay.ca, ebay.co.uk, ebay.com.au, ebay.de and ebay.fr. This also sets the origin country and the currency every rate is quoted in.

  • Name
    unit_system
    Required
    Optional
    Description

    Units for weight and dimensions. imperial uses pounds and inches, metric uses kilograms and centimeters. Defaults to imperial on ebay.com and metric on the other marketplaces.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to ebay_shipping_calculator.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Domestic Rates

Domestic Rates
GET
https://www.searchapi.io/api/v1/search?engine=ebay_shipping_calculator&height=4&length=12&ship_from_zip=10001&ship_to_zip=90210&weight=3.5&width=9
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_shipping_calculator",
  "weight": "3.5",
  "length": "12",
  "width": "9",
  "height": "4",
  "ship_from_zip": "10001",
  "ship_to_zip": "90210"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_sUm9jnCmky0DuPGZwWwF1a6F",
    "status": "Success",
    "created_at": "2026-09-17T12:00:00Z",
    "request_time_taken": 0.47,
    "parsing_time_taken": 0.01,
    "total_time_taken": 0.48,
    "request_url": "https://www.ebay.com/shp/calc/rates",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_sUm9jnCmky0DuPGZwWwF1a6F.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_sUm9jnCmky0DuPGZwWwF1a6F"
  },
  "search_parameters": {
    "engine": "ebay_shipping_calculator",
    "ebay_domain": "ebay.com",
    "weight": "3.5",
    "length": "12",
    "width": "9",
    "height": "4",
    "unit_system": "imperial",
    "ship_from_country": "US",
    "ship_from_zip": "10001",
    "ship_to_country": "US",
    "ship_to_zip": "90210"
  },
  "shipping_services": [
    {
      "position": 1,
      "carrier": "USPS",
      "service": "USPS Ground Advantage",
      "service_code": "USPSParcel",
      "price": "11.71",
      "extracted_price": 11.71,
      "retail_price": "24.25",
      "extracted_retail_price": 24.25,
      "currency": "USD",
      "has_tracking": true,
      "included_coverage": 100,
      "estimated_delivery_min_hours": 48,
      "estimated_delivery_max_hours": 120
    },
    "..."
  ]
}

Estimate Ranges Without a Destination

Estimate Ranges Without a Destination
GET
https://www.searchapi.io/api/v1/search?engine=ebay_shipping_calculator&height=4&length=12&ship_from_zip=10001&weight=3.5&width=9
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_shipping_calculator",
  "weight": "3.5",
  "length": "12",
  "width": "9",
  "height": "4",
  "ship_from_zip": "10001"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_WdjfSlqo9Tvu64V70uVds10Z",
    "status": "Success",
    "created_at": "2026-09-17T12:00:00Z",
    "request_time_taken": 0.47,
    "parsing_time_taken": 0.01,
    "total_time_taken": 0.48,
    "request_url": "https://www.ebay.com/shp/calc/rates",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_WdjfSlqo9Tvu64V70uVds10Z.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_WdjfSlqo9Tvu64V70uVds10Z"
  },
  "search_parameters": {
    "engine": "ebay_shipping_calculator",
    "ebay_domain": "ebay.com",
    "weight": "3.5",
    "length": "12",
    "width": "9",
    "height": "4",
    "unit_system": "imperial",
    "ship_from_country": "US",
    "ship_from_zip": "10001",
    "ship_to_country": "US"
  },
  "shipping_services": [
    {
      "position": 1,
      "carrier": "USPS",
      "service": "USPS Ground Advantage",
      "service_code": "USPSParcel",
      "price": "5.68 - 14.67",
      "extracted_price_range": {
        "from": 5.68,
        "to": 14.67
      },
      "is_price_range": true,
      "retail_price": "12.25 - 24.25",
      "extracted_retail_price_range": {
        "from": 12.25,
        "to": 24.25
      },
      "is_retail_price_range": true,
      "currency": "USD",
      "has_tracking": true,
      "included_coverage": 100,
      "estimated_delivery_min_hours": 48,
      "estimated_delivery_max_hours": 120
    },
    "..."
  ]
}

International Rates

International Rates
GET
https://www.searchapi.io/api/v1/search?engine=ebay_shipping_calculator&height=4&length=12&ship_from_zip=10001&ship_to_country=GB&ship_to_zip=E1+6AN&weight=3.5&width=9
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_shipping_calculator",
  "weight": "3.5",
  "length": "12",
  "width": "9",
  "height": "4",
  "ship_from_zip": "10001",
  "ship_to_country": "GB",
  "ship_to_zip": "E1 6AN"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_Uf9E7XdvU2YVS7Tik3KXM3rn",
    "status": "Success",
    "created_at": "2026-09-17T12:00:00Z",
    "request_time_taken": 0.47,
    "parsing_time_taken": 0.01,
    "total_time_taken": 0.48,
    "request_url": "https://www.ebay.com/shp/calc/rates",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_Uf9E7XdvU2YVS7Tik3KXM3rn.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_Uf9E7XdvU2YVS7Tik3KXM3rn"
  },
  "search_parameters": {
    "engine": "ebay_shipping_calculator",
    "ebay_domain": "ebay.com",
    "weight": "3.5",
    "length": "12",
    "width": "9",
    "height": "4",
    "unit_system": "imperial",
    "ship_from_country": "US",
    "ship_from_zip": "10001",
    "ship_to_country": "GB",
    "ship_to_zip": "E1 6AN"
  },
  "shipping_services": [
    {
      "position": 1,
      "carrier": "USPS",
      "service": "USPS First Class Package International",
      "service_code": "USPSFirstClassMailInternationalParcel",
      "price": "53.43",
      "extracted_price": 53.43,
      "retail_price": "64.25",
      "extracted_retail_price": 64.25,
      "currency": "USD",
      "has_tracking": true,
      "included_coverage": 100
    },
    "..."
  ]
}

Metric Units on eBay Germany

Metric Units on eBay Germany
GET
https://www.searchapi.io/api/v1/search?ebay_domain=ebay.de&engine=ebay_shipping_calculator&height=10&length=30&ship_from_zip=10115&ship_to_zip=80331&unit_system=metric&weight=2&width=20
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_shipping_calculator",
  "ebay_domain": "ebay.de",
  "unit_system": "metric",
  "weight": "2",
  "length": "30",
  "width": "20",
  "height": "10",
  "ship_from_zip": "10115",
  "ship_to_zip": "80331"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_rOp3sqEtguU48vSRL3z4bmsW",
    "status": "Success",
    "created_at": "2026-09-17T12:00:00Z",
    "request_time_taken": 0.47,
    "parsing_time_taken": 0.01,
    "total_time_taken": 0.48,
    "request_url": "https://www.ebay.de/shp/calc/rates",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_rOp3sqEtguU48vSRL3z4bmsW.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_rOp3sqEtguU48vSRL3z4bmsW"
  },
  "search_parameters": {
    "engine": "ebay_shipping_calculator",
    "ebay_domain": "ebay.de",
    "weight": "2",
    "length": "30",
    "width": "20",
    "height": "10",
    "unit_system": "metric",
    "ship_from_country": "DE",
    "ship_from_zip": "10115",
    "ship_to_country": "DE",
    "ship_to_zip": "80331"
  },
  "shipping_services": [
    {
      "position": 1,
      "carrier": "HERMES",
      "service": "Hermes S-Paket",
      "service_code": "DE_HERMES_PAKET_NAT_SMALL",
      "service_group": "HERMES_PAKET",
      "price": "5.79",
      "extracted_price": 5.79,
      "retail_price": "6.79",
      "extracted_retail_price": 6.79,
      "currency": "EUR",
      "has_tracking": true,
      "included_coverage": 500,
      "estimated_delivery_min_hours": 24,
      "estimated_delivery_max_hours": 48
    },
    "..."
  ]
}