# Ebay Product Shipping Rates (`pintostudio/ebay-product-shipping-rates`) Actor

The eBay Product Shipping Rates Actor is a web scraping tool deployed on the Apify platform that extracts shipping information, payment methods, return policies, and product details from eBay product listings.

- **URL**: https://apify.com/pintostudio/ebay-product-shipping-rates.md
- **Developed by:** [Pinto Studio](https://apify.com/pintostudio) (community)
- **Categories:** E-commerce, Jobs, Automation
- **Features:** Limited permissions
- **Stats:** 8 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 1,000 results

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

## eBay Product Shipping Rates Actor

### Overview

The eBay Product Shipping Rates Actor is a web scraping tool deployed on the Apify platform that extracts shipping information, payment methods, return policies, and product details from eBay product listings. This actor helps users gather comprehensive shipping data for eBay products across different countries and regions.

### Features

- **Shipping Rate Extraction**: Retrieves detailed shipping costs and delivery timeframes
- **Multi-Country Support**: Works with 40+ eBay regional sites worldwide
- **Payment Methods**: Extracts available payment options for the product
- **Return Policy Information**: Gathers return and refund policy details
- **Product Information**: Retrieves basic product details including title and pricing
- **Location-Based Shipping**: Calculates shipping costs to specific ZIP codes

### Input Parameters

#### Required Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `productUrl` | String | The eBay product URL (e.g., 'https://www.ebay.com/itm/326453180272') |

#### Optional Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `countryIso` | String | "us" | Two-letter ISO country code for eBay regional site |
| `shippingZipCode` | String | "20147" | ZIP/postal code for shipping cost calculation |

#### Supported Countries

The actor supports the following eBay regional sites:

**Primary Markets:**

- Australia (au), Austria (at), Belgium (be), Canada (ca), Switzerland (ch)
- Germany (de), Spain (es), France (fr), Hong Kong (hk), Ireland (ie)
- Italy (it), Malaysia (my), Netherlands (nl), New Zealand (nz), Philippines (ph)
- Poland (pl), Singapore (sg), United Kingdom (uk), United States (us)

**Additional Markets:**

- Argentina (ar), Brazil (br), China (cn), Colombia (co), Czech Republic (cz)
- Denmark (dk), Finland (fi), Greece (gr), Hungary (hu), Indonesia (id)
- Israel (il), India (in), Japan (jp), South Korea (kr), Mexico (mx)
- Norway (no), Sweden (se), Thailand (th), Taiwan (tw), Vietnam (vn)

### Input Schema Example

```json
{
  "productUrl": "https://www.ebay.com/itm/276996181961",
  "countryIso": "us",
  "shippingZipCode": "20147"
}
```

### Output Structure

The actor returns a comprehensive JSON object containing the following information:

#### Product Information

- `productTitle`: The title of the eBay listing
- `productPrice`: Object containing price information including:
  - `value`: Price in the target currency
  - `convertedFromValue`: Original price value
  - `convertedFromCurrency`: Original currency code
  - `currency`: Target currency code

#### Shipping Information

- `shipping`: Object containing detailed shipping data:
  - `handlingTime`: Processing time before shipment
  - `deliveryto`: Delivery options with costs and timeframes
  - `shipsto`: Array of countries that the seller ships to
  - `excludedCountries`: Array of countries excluded from shipping
  - `taxes`: Tax information and warnings
  - `itemLocation`: Seller's location

#### Additional Information

- `shopWithConfidenceText`: Localized trust/confidence message
- `paymentMethods`: Array of accepted payment methods
- `returnInfo`: Array containing return policy details
- `logisticsGroups`: Array of logistics group identifiers

### Output Example

```json
{
  "shopWithConfidenceText": "Shop with confidence",
  "shipping": {
    "handlingTime": "Usually ships within 1 business day after payment is processed.",
    "deliveryto": "Standard Int'l Postage Estimated delivery: Thu, Jun 5 - Mon, Jun 16 to 20147 Shipping: GBP 11.50 (approximately EUR 13.64) Each additional item: GBP 11.50 (approximately EUR 13.64)",
    "shipsto": [
      "Germany", "Australia", "Belgium", "United States", "France", "Italy", "Netherlands", "Spain", "United Kingdom"
    ],
    "excludedCountries": [
      "Afghanistan", "Angola", "Argentina", "Belarus", "Bolivia"
    ],
    "taxes": "Import charges may be due at checkout.",
    "itemLocation": "Paignton, United Kingdom"
  },
  "paymentMethods": [
    "PayPal", "Google Pay", "Visa", "MasterCard", "Diners Club"
  ],
  "returnInfo": [
    "Returns accepted within 30 days",
    "Buyer pays for return shipping",
    "See details in return policy"
  ],
  "productTitle": "Men's Babolat Jet Tere Cly Tennis Shoes",
  "productPrice": {
    "value": 34.87,
    "convertedFromValue": 29.4,
    "convertedFromCurrency": "GBP",
    "currency": "EUR"
  }
}
```

### Usage Instructions

#### Via Apify Console

1. Navigate to the eBay Product Shipping Rates Actor on Apify
2. Configure the input parameters:
   - Enter the eBay product URL
   - Select the appropriate country ISO code
   - Provide the shipping ZIP/postal code
3. Click "Start" to run the actor
4. Monitor the run progress in the console
5. Download results once completed

#### Via Apify API

```javascript
const { ApifyApi } = require('apify-client');

const client = new ApifyApi({
    token: 'YOUR_APIFY_TOKEN'
});

const input = {
    productUrl: 'https://www.ebay.com/itm/276996181961',
    countryIso: 'us',
    shippingZipCode: '20147'
};

const run = await client.actor('THE_ACTOR_ID').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Via SDK Integration

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "productUrl": "https://www.ebay.com/itm/276996181961",
    "countryIso": "us",
    "shippingZipCode": "20147"
}

run = client.actor("THE_ACTOR_ID").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

### Error Handling

The actor includes comprehensive error handling for common scenarios:

- **Invalid URLs**: The actor validates eBay product URLs and extracts product IDs
- **Network Issues**: Automatic retries for temporary connection problems
- **Regional Restrictions**: Graceful handling of geo-blocked content
- **Invalid Parameters**: Validation of country codes and input formats

Common error scenarios:

- Invalid or expired eBay product URLs
- Products not available in the specified country
- Network connectivity issues
- Invalid ZIP/postal codes

### Performance Considerations

- **Rate Limiting**: The actor respects eBay's rate limits to avoid blocking
- **Execution Time**: Typical run time is 10-30 seconds per product
- **Memory Usage**: Lightweight memory footprint, suitable for concurrent runs
- **Data Volume**: Outputs compact JSON structures for efficient storage

### Limitations

- **Single Product**: Processes one product URL per run
- **Public Listings**: Only works with publicly accessible eBay listings
- **Real-time Data**: Shipping costs and availability may change frequently
- **Regional Variations**: Some features may vary across different eBay sites

### Use Cases

1. **E-commerce Research**: Compare shipping costs across different regions
2. **Price Monitoring**: Track total product costs including shipping
3. **Market Analysis**: Analyze seller shipping policies and coverage
4. **Logistics Planning**: Calculate shipping costs for international purchases
5. **Competitive Intelligence**: Monitor competitor shipping strategies

### Support and Troubleshooting

#### Common Issues

1. **"Product not found" errors**: Ensure the URL is valid and the product is still active
2. **Empty shipping data**: The product may not ship to the specified location
3. **Currency conversion errors**: Some regional sites may have temporary conversion issues

***

### Support

If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels:

- **Telegram**: [@pintoflow](https://t.me/pintoflow)
- **Email**: <pintoflowpt@gmail.com>
- **Apify Platform**: You can also contact us directly through this platform.

***

# Actor input Schema

## `productUrl` (type: `string`):

The Product Url (e.g., 'https://www.ebay.com/itm/326453180272')

## `countryIso` (type: `string`):

Two-letter country ISO code for eBay regional site

## `shippingZipCode` (type: `string`):

Provide the shipping Zip Code (i.e: 20147)

## Actor input object example

```json
{
  "productUrl": "https://www.ebay.com/itm/174053762571",
  "countryIso": "us",
  "shippingZipCode": "20147"
}
```

# 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 = {
    "productUrl": "https://www.ebay.com/itm/174053762571"
};

// Run the Actor and wait for it to finish
const run = await client.actor("pintostudio/ebay-product-shipping-rates").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 = { "productUrl": "https://www.ebay.com/itm/174053762571" }

# Run the Actor and wait for it to finish
run = client.actor("pintostudio/ebay-product-shipping-rates").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 '{
  "productUrl": "https://www.ebay.com/itm/174053762571"
}' |
apify call pintostudio/ebay-product-shipping-rates --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pintostudio/ebay-product-shipping-rates"
        }
    }
}
```

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/xdmHxDQcDGQzelbhD/builds/sEDdlBtqhTdWhRQC3/openapi.json
