# 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
- **Stats:** 10 total users, 1 monthly users, 97.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# 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`) |
| `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"
}
```

***

### 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://easyparser.gitbook.io/easyparser-documentation/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

## `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",
  "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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=easyparser/amazon-package-dimensions",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Free Amazon Package Dimensions and Shipping Weight",
        "description": "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.",
        "version": "1.0",
        "x-build-id": "j0HjFGMPCzWpbVF6J"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/easyparser~amazon-package-dimensions/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-easyparser-amazon-package-dimensions",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/easyparser~amazon-package-dimensions/runs": {
            "post": {
                "operationId": "runs-sync-easyparser-amazon-package-dimensions",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/easyparser~amazon-package-dimensions/run-sync": {
            "post": {
                "operationId": "run-sync-easyparser-amazon-package-dimensions",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "asin",
                    "domain"
                ],
                "properties": {
                    "asin": {
                        "title": "ASIN",
                        "type": "string",
                        "description": "The Amazon Standard Identification Number of the product to look up. Example: B0F9X3FDYY"
                    },
                    "domain": {
                        "title": "Amazon Marketplace",
                        "enum": [
                            ".com",
                            ".co.uk",
                            ".de",
                            ".fr",
                            ".co.jp",
                            ".ca",
                            ".it",
                            ".es",
                            ".com.au",
                            ".com.br",
                            ".com.mx",
                            ".nl",
                            ".se",
                            ".pl",
                            ".sg",
                            ".com.tr",
                            ".ae",
                            ".sa",
                            ".in",
                            ".eg",
                            ".com.be"
                        ],
                        "type": "string",
                        "description": "The Amazon marketplace to query. US returns inches and pounds, EU returns centimeters and kilograms."
                    },
                    "api_key": {
                        "title": "Easyparser API Key (Optional)",
                        "type": "string",
                        "description": "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."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
