# Free Amazon Package Dimensions and Shipping Weight (`easyparser/amazon-package-dimensions`) Actor

Retrieve Amazon product package dimensions, shipping weight, FBA fee category, and product specs for any ASIN. Audit FBA fees and optimize logistics costs. Powered by Easyparser.

- **URL**: https://apify.com/easyparser/amazon-package-dimensions.md
- **Developed by:** [Easyparser](https://apify.com/easyparser) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 52 total users, 11 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $2.00 / 1,000 easyparser credit (built-in key)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Free Amazon Package Dimensions and Shipping Weight

Retrieve Amazon product package dimensions (shipping box), shipping weight, FBA fee category, and product dimensions for any ASIN. Powered by [Easyparser's](https://easyparser.com) real-time Package Dimension API.

> **No API key required to get started.** This actor includes a shared demo key so you can try it immediately. For higher limits and bulk processing, [sign up free at Easyparser](https://app.easyparser.com/signup).

***

### What This Actor Returns

Each run produces a single dataset item with two layers of dimension data:

**Package Dimensions (shipping box):**

- `package_height`, `package_length`, `package_width` - the boxed shipping dimensions Amazon uses for FBA calculations
- `package_dimension_unit` - unit of measurement (inches for US, cm for EU)
- `package_weight`, `package_weight_unit` - total weight of the packaged product

**Product Dimensions (item itself):**

- `product_height`, `product_length`, `product_width` - the physical size of the item unboxed
- `product_dimension_unit` - unit of measurement
- `product_weight`, `product_weight_unit` - net weight of the product

**Product Metadata:**

- `asin`, `title`, `brand` - product identity
- `link` - Amazon product page URL
- `fee_category` - Amazon FBA fee tier (e.g., BASE_PRODUCT)
- `gl` - Amazon product group code
- `image`, `thumbnail` - product image URLs
- `country_code` - marketplace country

#### Package vs Product Dimensions

| Field | Description |
|-------|-------------|
| `package_*` | The boxed shipping dimensions Amazon uses for FBA fee calculations and logistics |
| `product_*` | The physical size of the item itself, unboxed (assembled or in-use form) |

These two sets of dimensions can differ significantly (e.g., a desk with small packaging vs. a large assembled footprint).

***

### How to Use

#### Option A - Try It Now (No Sign-Up)

Fill in the `asin` and `domain` fields and run. A shared Easyparser key is built in.

#### Option B - Use Your Own API Key (Recommended for Scale)

1. Sign up free at [app.easyparser.com/signup](https://app.easyparser.com/signup) - **100 free credits/month**, no credit card required
2. Copy your API key from the [Plan Page](https://app.easyparser.com/account/plan)
3. Paste it into the `api_key` field

***

### Input Fields

| Field | Required | Description |
|-------|----------|-------------|
| `asin` | Yes\* | Amazon ASIN (e.g., `B0F9X3FDYY`) |
| `asins` | No | List of ASINs to process in one run (bulk). Combined with `asin`, duplicates removed |
| `domain` | Yes | Amazon marketplace (e.g., `.com`, `.co.uk`, `.de`) |
| `api_key` | No | Your personal Easyparser API key (shared demo key used if empty) |

**Note:** US marketplace (`.com`) returns inches and pounds. EU marketplaces return centimeters and kilograms.

***

### Example

**Input:**

```json
{
  "asin": "B0F9X3FDYY",
  "domain": ".com"
}
```

**Output:**

```json
{
  "asin": "B0F9X3FDYY",
  "title": "HUANUO 32\" Small Electric Standing Desk Adjustable Height...",
  "brand": "HUANUO",
  "link": "https://www.amazon.com/dp/B0F9X3FDYY",
  "fee_category": "BASE_PRODUCT",
  "gl": "kitchen_display_on_website",
  "country_code": "US",

  "package_height": 5.99,
  "package_length": 32.99,
  "package_width": 10.99,
  "package_dimension_unit": "inches",
  "package_weight": 29.2,
  "package_weight_unit": "pounds",

  "product_height": 28,
  "product_length": 19,
  "product_width": 32,
  "product_dimension_unit": "inches",
  "product_weight": 24.5,
  "product_weight_unit": "pounds",

  "image": "https://m.media-amazon.com/images/I/61U0DUlJOuL.jpg",
  "thumbnail": "https://m.media-amazon.com/images/I/41jtlxQd5eL._SL75_.jpg"
}
```

**Bulk input (many items in one run):**

```json
{
  "asins": [
    "B0F9X3FDYY",
    "B0CJB6V2L5",
    "B0FC5SJNQX"
  ],
  "domain": ".com"
}
```

\* Provide at least one value in the single field or the list field. Items are processed 5 at a time and each one is saved to the dataset as soon as it finishes. If an item fails, the run continues with the others and the failed items are listed in the `FAILED_ITEMS` record of the run's key-value store. When the run reaches your maximum cost per run, the remaining items are skipped.

***

### Use Cases

- **FBA Fee Auditing**: Validate whether Amazon's FBA fee tier matches the actual package dimensions. Dispute overcharges with evidence
- **Shipping Cost Optimization**: Compare volumetric vs actual weight to identify packaging improvements that reduce fulfillment costs
- **Logistics Planning**: Calculate container utilization, pallet layouts, and inbound FBA shipment efficiency
- **Competitor Packaging Benchmarking**: Compare competitor package sizes to identify efficiency advantages
- **New Product Viability**: Evaluate shipping dimensions before sourcing to avoid products with unprofitable logistics costs
- **Warehouse Slotting**: Plan shelf space using exact package dimensions before inventory arrives
- **Carrier Quoting**: Feed precise dimensions into third-party shipping APIs for accurate quotes
- **Listing Verification**: Cross-check listing specifications against real package data to reduce returns
- **Portfolio Margin Analysis**: Bulk-analyze multiple ASINs to identify size-tier misclassifications

***

### Need More?

For **better pricing**, **higher limits**, and **dedicated throughput**:

- 🚀 [Sign Up Free](https://app.easyparser.com/signup) - 100 credits/month, no credit card
- 💰 [View Pricing Plans](https://easyparser.com/pricing)
- 🎮 [Try the API Playground](https://app.easyparser.com/playground)
- 📄 [Full Documentation](https://docs.easyparser.com/real-time-integration/package-dimension)

***

### Related Actors

- [Free Amazon Product Detail Scraper](https://apify.com/easyparser/amazon-product-detail): Full product data including title, price, ratings, images, specifications, and variants
- [Free Amazon Product Offers Scraper](https://apify.com/easyparser/amazon-product-offers): All seller offers with pricing, Buy Box winner, and fulfillment details
- [Free Amazon Sales History & Analytics](https://apify.com/easyparser/amazon-sales-history): Weekly BSR, price, and traffic history up to 12 months
- [Free EAN/UPC to ASIN Converter](https://apify.com/easyparser/asin-to-ean-converter): Bidirectional barcode to ASIN lookup

***

### About Easyparser

[Easyparser](https://easyparser.com) is a real-time Amazon scraping API built for developers and data teams. No IP blocks, no CAPTCHAs, fast response times.

# Actor input Schema

## `asin` (type: `string`):

The Amazon Standard Identification Number of the product to look up. Example: B0F9X3FDYY

## `asins` (type: `array`):

Optional list of ASINs to process in one run, one per line. Can be combined with the single ASIN field. Duplicates are removed.

## `domain` (type: `string`):

The Amazon marketplace to query. US returns inches and pounds, EU returns centimeters and kilograms.

## `api_key` (type: `string`):

Your personal Easyparser API key for higher request limits. Leave empty to use the shared demo key. Get your own free key at https://app.easyparser.com/signup - 100 free credits/month, no credit card required.

## Actor input object example

```json
{
  "asin": "B0F9X3FDYY",
  "asins": [
    "B0F9X3FDYY",
    "B0CJB6V2L5"
  ],
  "domain": ".com"
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset containing package dimensions, shipping weight, product dimensions, product weight, FBA fee category, brand, title, and image URLs for each queried ASIN.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "asin": "B0FC5SJNQX",
    "domain": ".com"
};

// Run the Actor and wait for it to finish
const run = await client.actor("easyparser/amazon-package-dimensions").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "asin": "B0FC5SJNQX",
    "domain": ".com",
}

# Run the Actor and wait for it to finish
run = client.actor("easyparser/amazon-package-dimensions").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "asin": "B0FC5SJNQX",
  "domain": ".com"
}' |
apify call easyparser/amazon-package-dimensions --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,easyparser/amazon-package-dimensions"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HzLRDp2z1raQaZc1s/builds/b6Y0XT3w0XskSgmcr/openapi.json