Amazon Package Dimensions API
Retrieve Amazon package dimensions, product size, and weight by ASIN to support shipping planning and FBA fee estimates.
• Monthly 100 free credit!
100 free credits No credit card
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_categoryandgllabels for catalog grouping; no calculated fee amount in the shown response.
No credit card 100 credit free
Real-time or Bulk
Amazon Dimension API How-to
How to Get Started with the Amazon Dimension API
- 1 Create Your Account
Sign up to receive 100 free monthly credits and test the dimension endpoint.
- 2 Retrieve Your API Token
Get your secure, auto-generated API token from your Plan page to authorize requests.
- 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.
# 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());
}
}
HUANUO 32x19 Inch Small Electric Standing Desk, Adjustable, Light Walnut
BASE_PRODUCTData example retrieved November 3, 2026 from Amazon.com. Displayed measurements are rounded; JSON retains the returned values. Images illustrate the same desk model.
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
}
}
}
} 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.
- 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
| Parameter | Type | Required | Description |
|---|---|---|---|
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
| Field | Type | Description |
|---|---|---|
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
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
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
Use available package measurements for preliminary storage and shipment models, alongside handling clearances and your own carton data.
Competitor Packaging Benchmarking
Compare Amazon-source package sizes across ASINs after normalizing units and excluding incomplete records.
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
Flag products with larger package measurements for further storage and fulfillment cost analysis using current fee rules.
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
Prepare preliminary pallet layouts from package measurements. Product packaging is not necessarily the same as your inbound shipping carton.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Retrieve available size and weight fields to support your own shipping and fee estimates.