Amazon Package Dimensions API

Retrieve Amazon package dimensions, product size, and weight by ASIN to support shipping planning and FBA fee estimates.

Easyparser Free Plan Shape
Free Plan

• Monthly 100 free credit!

100 free credits No credit card

amazon.com/dp/B0F9X3FDYY
Package Dimensions

Package and Product Measurements from Amazon

The PACKAGE_DIMENSION operation retrieves structured size and weight fields for an ASIN in the selected Amazon marketplace.

package.dimensions describes the packaged item, while product.dimensions describes the product itself when available. These are Amazon-source values, not independently verified measurements. Use them as planning inputs and confirm your inventory before calculating charges.

  • Separate package and product length, width, height, and weight fields.
  • Returned units for each measurement object, rather than an assumed regional unit.
  • ASIN, brand, title, listing URL, and image metadata when available.
  • fee_category and gl labels for catalog grouping; no calculated fee amount in the shown response.

No credit card Stars 100 credit free Stars Real-time or Bulk

Next Step

Amazon Dimension API How-to

How to Get Started with the Amazon Dimension API

  1. 1
    Create Your Account

    Sign up to receive 100 free monthly credits and test the dimension endpoint.

  2. 2
    Retrieve Your API Token

    Get your secure, auto-generated API token from your Plan page to authorize requests.

  3. 3
    Query the Endpoint

    Send operation=PACKAGE_DIMENSION, an ASIN, and a marketplace domain to retrieve the available size and weight fields. Test the endpoint in the playground.

Check returned units and missing values before using measurements in a shipping or fee calculator.

The request uses one ASIN. The response is a dated data example, not a promise of measurement completeness for other listings.

Real-time integration returns a synchronous response; bulk integration creates an asynchronous job. Availability and request limits depend on the operation and plan.

⚡ No IP blocks, no CAPTCHAs to manage: fast, reliable Amazon logistics data responses.

INPUT
# Request parameters: replace placeholders before running
# api_key: Your API key; keep it private
# domain: Marketplace suffix (.com/.co.uk)
# Send an HTTP GET request; URL-encode each parameter
curl --get 'https://realtime.easyparser.com/v1/request' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'platform=AMZ' \
  --data-urlencode 'operation=PACKAGE_DIMENSION' \
  --data-urlencode 'domain=.com' \
  --data-urlencode 'asin=B0F9X3FDYY'
import json
import requests

# Set up the request parameters
params = {
    "api_key": "YOUR_API_KEY", # Your API key; keep it private
    "platform": "AMZ",
    "operation": "PACKAGE_DIMENSION",
    "domain": ".com", # Marketplace suffix (.com/.co.uk)
    "asin": "B0F9X3FDYY"
}

# Send an HTTP GET request to the Easyparser API
response = requests.get("https://realtime.easyparser.com/v1/request", params=params)
response.raise_for_status()
# Print the formatted JSON response
print(json.dumps(response.json(), indent=2))
const axios = require("axios");

// Set up the request parameters
const params = {
  api_key: "YOUR_API_KEY", // Your API key; keep it private
  platform: "AMZ",
  operation: "PACKAGE_DIMENSION",
  domain: ".com", // Marketplace suffix (.com/.co.uk)
  asin: "B0F9X3FDYY"
};

// Send an HTTP GET request to the Easyparser API
axios.get("https://realtime.easyparser.com/v1/request", { params })
  .then(response => {
    // Print the formatted JSON response
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch(error => {
    // Report request errors
    console.error(error.message);
  });
<?php
// Set up the request parameters
$params = [
    'api_key' => 'YOUR_API_KEY', // Your API key; keep it private
    'platform' => 'AMZ',
    'operation' => 'PACKAGE_DIMENSION',
    'domain' => '.com', // Marketplace suffix (.com/.co.uk)
    'asin' => 'B0F9X3FDYY'
];

// URL-encode the query parameters
$url = 'https://realtime.easyparser.com/v1/request?' . http_build_query($params);
// Send an HTTP GET request to the Easyparser API
$response = file_get_contents($url);
// Print the response body
echo $response;
package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    // Set up the request parameters
    params := url.Values{}
    params.Add("api_key", "YOUR_API_KEY") // Your API key; keep it private
    params.Add("platform", "AMZ")
    params.Add("operation", "PACKAGE_DIMENSION")
    params.Add("domain", ".com") // Marketplace suffix (.com/.co.uk)
    params.Add("asin", "B0F9X3FDYY")

    // Send an HTTP GET request with URL-encoded query parameters
    response, err := http.Get("https://realtime.easyparser.com/v1/request?" + params.Encode())
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(response.Body)
    if err != nil { panic(err) }
    // Print the response body
    fmt.Println(string(body))
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Collections.Generic;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        // Set up the request parameters
        var query = new Dictionary<string, string> {
            { "api_key", "YOUR_API_KEY" }, // Your API key; keep it private
            { "platform", "AMZ" },
            { "operation", "PACKAGE_DIMENSION" },
            { "domain", ".com" }, // Marketplace suffix (.com/.co.uk)
            { "asin", "B0F9X3FDYY" }
        };
        // URL-encode the query parameters
        using var content = new FormUrlEncodedContent(query);
        var queryString = await content.ReadAsStringAsync();
        // Send an HTTP GET request to the Easyparser API
        var response = await client.GetStringAsync("https://realtime.easyparser.com/v1/request?" + queryString);
        // Print the response body
        Console.WriteLine(response);
    }
}
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.Map;

public class EasyparserExample {
    public static void main(String[] args) throws Exception {
        // Set up the request parameters
        Map<String, String> params = new LinkedHashMap<>();
        params.put("api_key", "YOUR_API_KEY"); // Your API key; keep it private
        params.put("platform", "AMZ");
        params.put("operation", "PACKAGE_DIMENSION");
        params.put("domain", ".com"); // Marketplace suffix (.com/.co.uk)
        params.put("asin", "B0F9X3FDYY");

        // URL-encode the query parameters
        StringBuilder query = new StringBuilder();
        for (Map.Entry<String, String> entry : params.entrySet()) {
            if (query.length() > 0) query.append("&");
            query.append(URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8))
                 .append("=")
                 .append(URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8));
        }
        // Send an HTTP GET request to the Easyparser API
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://realtime.easyparser.com/v1/request?" + query)).GET().build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // Print the response body
        System.out.println(response.body());
    }
}
Next Step
Package Dimension Product Package Dimension Product Box
HUANUO 32x19 Inch Small Electric Standing Desk, Adjustable, Light Walnut
Brand: HUANUO
ASIN: B0F9X3FDYY
Package (L × W × H): 32.85 × 10.8 × 5.8 inches
Package weight: 29.2 pounds
Fee category: BASE_PRODUCT

Data example retrieved November 3, 2026 from Amazon.com. Displayed measurements are rounded; JSON retains the returned values. Images illustrate the same desk model.

Next Step

Example response. Values reflect this sample, not current product data.

{
  "request_parameters": {
    "asin": "B0F9X3FDYY",
    "type": "PACKAGE_DIMENSION"
  },
  "result": {
    "country_code": "US",
    "package": {
      "dimensions": {
        "height": 5.799999994084,
        "length": 32.849999966493,
        "unit": "inches",
        "width": 10.799999988984
      },
      "weight": {
        "unit": "pounds",
        "value": 29.2002266019
      }
    },
    "product": {
      "asin": "B0F9X3FDYY",
      "brand": "HUANUO",
      "dimensions": {
        "height": 28,
        "length": 19,
        "unit": "inches",
        "width": 32
      },
      "fee_category": "BASE_PRODUCT",
      "gl": "kitchen_display_on_website",
      "link": "https://www.amazon.com/dp/B0F9X3FDYY",
      "main_image": {
        "id": "613iUOw2LFL",
        "link": "https://m.media-amazon.com/images/I/613iUOw2LFL.jpg"
      },
      "media": {
        "image": "https://m.media-amazon.com/images/I/613iUOw2LFL.jpg",
        "thumbnail": "https://m.media-amazon.com/images/I/31Uyn3v4dhL._SL75_.jpg"
      },
      "thumb_image": {
        "id": "31Uyn3v4dhL",
        "link": "https://m.media-amazon.com/images/I/31Uyn3v4dhL.jpg"
      },
      "title": "HUANUO 32x19 Inch Small Electric Standing Desk, Adjustable, Light Walnut",
      "weight": {
        "unit": "pounds",
        "value": 24.5
      }
    }
  }
}

Endpoint reference

Package Dimension Endpoint Reference

Send a GET request to the real-time endpoint for one ASIN. The tables below describe the query arguments and the fields returned inside result.

Read endpoint documentation
Operation
PACKAGE_DIMENSION
Request cost
1 credit per standard request, as documented and observed in the November 3, 2026 example. Account rate limits depend on your plan.

Request parameters

Request parameters for PACKAGE_DIMENSION
ParameterTypeRequiredDescription
api_key string Yes Your Easyparser API key for authentication. Keep it private and redact it from query-string logs.
platform string Yes Use AMZ for Amazon.
operation string Yes Use PACKAGE_DIMENSION. The response echoes this as request_parameters.type; type is not the HTTP input name.
domain string Yes Select the Amazon marketplace suffix, such as .com, .co.uk, or .de. Include it explicitly in every request.
asin string Yes One 10-character Amazon product identifier. This page uses B0F9X3FDYY; URL, keyword, and seller ID are not documented identifier alternatives for this operation.
output string No Optional common HTTP parameter in the public OpenAPI contract. Supported value and default: json.

Response fields

Example response fields for PACKAGE_DIMENSION
FieldTypeDescription
country_code string Marketplace country code; US in the displayed example.
package.dimensions object Packaged-item measurements: numeric height, length, and width with a string unit. Retain the returned precision in stored data.
package.weight object Packaged-item weight with numeric value and string unit. Do not substitute product weight if this object is unavailable.
product.dimensions object Item measurements separate from packaging: numeric height, length, and width with a string unit, when available.
product.weight object Item weight separate from packaging, with numeric value and string unit, when available.
product.asin, product.title, product.brand string fields Product identifier and catalog identity. Brand or title availability can vary by listing.
product.fee_category string Amazon fee-category label, such as BASE_PRODUCT. It is not a fee amount or a guaranteed fulfillment size tier.
product.gl string Amazon product-group label. Retain the native value rather than assuming it is a shopper-facing category name.
product.link string Amazon product listing URL for the returned ASIN.
product.main_image, product.thumb_image object fields Image objects with string id and link fields when available.
product.media object String image and thumbnail URLs. These identify listing assets, not independent measurement evidence.

Usage notes

  • The published response is a shortened sample. Transaction IDs, account credits and timing metadata are omitted.
  • Marketplace availability varies by operation and listing. The supported list includes .com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx, .com.br, .co.jp, .in, .com.au, .ae, .sa, .nl, .pl, .se, .com.be, .com.tr, .sg and .ie.
  • No operation-specific optional filters or pagination are documented for PACKAGE_DIMENSION. The request here does not test delivery-address or ZIP localization.
  • Bulk uses a separate asynchronous request with payload.asins as an array of strings, not the real-time asin query argument. Follow the Bulk Service Request documentation for callback handling, batch limits, and plan-dependent throughput.
Measurement Data Capabilities
  • Nested measurement objects keep the packaged item separate from the product.
  • Numeric values and unit fields support explicit unit conversion in your application.
  • Catalog identifiers and marketplace links connect measurements to the requested ASIN.

Strategic Use Cases for the Amazon Package Dimensions API

Use available Amazon-source measurements in logistics models, catalog comparisons, and fee-estimation workflows.

FBA Fee Estimate Review

FBA Fee Estimate Review

Compare size and weight inputs with your fee model and Amazon charges. Listing measurements alone do not establish a fee error or refund entitlement.

Shipping Cost Optimization

Shipping Cost Optimization

Estimate dimensional weight using the returned units and your carrier's divisor. Confirm parcel measurements and current rates before purchasing shipping.

Logistics & Supply Chain Planning

Logistics & Supply Chain Planning

Use available package measurements for preliminary storage and shipment models, alongside handling clearances and your own carton data.

Competitor Packaging Benchmarking

Competitor Packaging Benchmarking

Compare Amazon-source package sizes across ASINs after normalizing units and excluding incomplete records.

Listing Specification Review

Listing Specification Review

Compare product dimensions with your catalog specifications and flag differences for manual review rather than treating them as verified errors.

Inventory Cost Control

Inventory Cost Control

Flag products with larger package measurements for further storage and fulfillment cost analysis using current fee rules.

New Product Viability Assessment

New Product Viability Assessment

Include available size and weight data in sourcing estimates, then validate the supplier's packaging and your expected logistics costs.

Inbound Shipment Optimization

Inbound Shipment Optimization

Prepare preliminary pallet layouts from package measurements. Product packaging is not necessarily the same as your inbound shipping carton.

Portfolio-Level Margin Analysis

Portfolio-Level Margin Analysis

Combine dimension data with your own sales, shipping rates, and fee records for portfolio cost models. This response does not provide those financial inputs.

Start free trial. No credit card required.

Frequently Asked Questions about the Amazon Package Dimensions API

Answers about measurement units, missing fields, data source, and fee-estimation limits.

1. What is the difference between package dimensions and product dimensions?

package.dimensions describes the packaged item; product.dimensions describes the item itself when available. These Amazon-sourced values are not an independent physical measurement of your inventory.

2. Is the data retrieved in real time?

The real-time endpoint returns Amazon-source data for the requested ASIN and marketplace. It does not guarantee when Amazon last updated the underlying measurements. The example shown here was retrieved on November 3, 2026.

3. What units of measurement are used?

Read the unit field in each dimensions and weight object. The US example uses inches and pounds; do not assume the same units for every marketplace or convert values without checking the returned unit.

4. How can this be used for FBA fee calculations?

Use package dimensions and weight as inputs to your own fee estimates with current Amazon fee schedules. fee_category is a category label, not a calculated fee or guaranteed size tier. Confirm inventory measurements and Amazon charges before making decisions.

5. Does the response include product images and catalog metadata?

Available fields can include ASIN, title, brand, listing URL, fee_category, gl, main_image, media, and thumb_image. The displayed response does not contain price, rating, or review count.

6. Can competitor packaging sizes be compared?

Compare returned package measurements across ASINs after checking units, marketplace, and missing values. Listing data alone does not prove packaging efficiency or a physical measurement error.

7. Is this suitable for bulk ASIN analysis?

Bulk integration is a separate asynchronous workflow using payload.asins as an array of ASIN strings. Jobs are subject to documented batch and plan limits; the real-time example on this page requests one ASIN.

8. What if dimensions or weight are missing?

Treat omitted, null, or empty measurements and missing units as unavailable, not as zero. Keep package and product values separate and exclude incomplete records from fee calculations until checked.

Build Logistics Models with Package Dimension Data

Retrieve available size and weight fields to support your own shipping and fee estimates.