eBay Similar Product Actor

Overview

The eBay Similar Product Actor is a web scraping tool deployed on the Apify platform that retrieves similar products from eBay based on a given product URL. This actor helps users discover alternative or related products by leveraging eBay's similar product recommendations.

Features

• Product Discovery: Find similar products to any eBay listing
• Multi-Country Support: Support for 30+ eBay regional sites worldwide
• Pagination: Navigate through multiple pages of similar products
• Structured Data: Returns clean, structured product information
• Real-time Scraping: Fetches live data from eBay

Input Parameters

Required Parameters

Parameter	Type	Description
productUrl	string	The eBay product URL to find similar items for

Optional Parameters

Parameter	Type	Default	Description
countryIso	string	"us"	Two-letter country ISO code for eBay regional site
page	integer	1	Page number for pagination (starting from 1)

Supported Countries

The actor supports the following eBay regional sites:

Primary Markets:

• us - United States
• uk - United Kingdom
• de - Germany
• fr - France
• it - Italy
• es - Spain
• ca - Canada
• au - Australia

Additional Markets:

• at - Austria
• be - Belgium
• ch - Switzerland
• hk - Hong Kong
• ie - Ireland
• my - Malaysia
• nl - Netherlands
• nz - New Zealand
• ph - Philippines
• pl - Poland
• sg - Singapore
• ar - Argentina
• br - Brazil
• cn - China
• co - Colombia
• cz - Czech Republic
• dk - Denmark
• fi - Finland
• gr - Greece
• hu - Hungary
• id - Indonesia
• il - Israel
• in - India
• jp - Japan
• kr - South Korea
• mx - Mexico
• no - Norway
• se - Sweden
• th - Thailand
• tw - Taiwan
• vn - Vietnam

Input Example

{
  "productUrl": "https://www.ebay.com/itm/326453180272",
  "countryIso": "us",
  "page": 1
}

Output Format

The actor returns an array of similar products with the following structure:

Output Fields

Field	Type	Description
id	string	eBay item ID
title	string	Product title
imageUrl	string	Product thumbnail image URL
price	number	Product price
currency	string	Price currency (e.g., "USD")
purchaseOption	string	Purchase type (e.g., "Buy It Now")
condition	string	Item condition (e.g., "New", "Pre-owned")
shipping	string	Shipping information
sellerIdVariant	string	Encrypted seller identifier
url	string	Direct link to the product page

Output Example

[
  {
    "id": "356903294036",
    "title": "Size 4 - Air Jordan 1 SE Mid Vivid Orange",
    "imageUrl": "https://i.ebayimg.com/thumbs/images/g/CvkAAeSwDnNoJlcR/s-l500.jpg",
    "price": 50,
    "currency": "USD",
    "purchaseOption": "Buy It Now",
    "condition": "New",
    "shipping": "+ shipping",
    "sellerIdVariant": "AQAKAAAAEArrPnZ42u4UpWhqwrqbVjI=",
    "url": "https://www.ebay.com/itm/356903294036?_trkparms=..."
  },
  {
    "id": "396645186040",
    "title": "Nike Air Jordan 1 Men's Retro High OG White Cement",
    "imageUrl": "https://i.ebayimg.com/thumbs/images/g/bb8AAeSwCVVoMH9O/s-l500.jpg",
    "price": 76.77,
    "currency": "USD",
    "purchaseOption": "Buy It Now",
    "condition": "Pre-owned",
    "shipping": "+ shipping",
    "sellerIdVariant": "AQAKAAAAEJntWH47bomOQtzB2RXGI/c=",
    "url": "https://www.ebay.com/itm/396645186040?_trkparms=..."
  }
]

Usage Instructions

Running the Actor

1. Access the Actor: Navigate to the eBay Similar Product Actor on Apify
2. Configure Input: Set your input parameters:
   • Enter the eBay product URL you want to find similar items for
   • Select the appropriate country ISO code
   • Specify the page number if needed
3. Run the Actor: Click "Start" to begin the scraping process
4. Download Results: Once complete, download the results in JSON, CSV, or other formats

API Usage

You can also run this actor via Apify's API:

curl -X POST https://api.apify.com/v2/acts/<the-actor-id>/runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "productUrl": "https://www.ebay.com/itm/326453180272",
    "countryIso": "us",
    "page": 1
  }'

Use Cases

E-commerce Intelligence

• Competitive Analysis: Monitor similar products and pricing
• Market Research: Discover product alternatives and market trends
• Price Comparison: Compare prices across similar listings

Business Applications

• Inventory Planning: Find alternative products to stock
• Product Sourcing: Discover new suppliers and product variations
• Market Expansion: Research products in different regional markets

Personal Use

• Shopping Assistance: Find cheaper or better alternatives
• Product Discovery: Explore similar items before making a purchase
• Price Monitoring: Track similar products for better deals

Best Practices

Input Optimization

• Valid URLs: Ensure the product URL is a valid eBay listing
• Active Listings: Use URLs from currently active listings for best results
• Correct Country: Match the country ISO with the product URL's regional site

Rate Limiting

• Respectful Usage: Avoid running multiple instances simultaneously
• Pagination: Use pagination instead of running separate actors for large datasets
• Monitoring: Monitor your Apify usage to stay within limits

Error Handling

• Invalid URLs: The actor will handle invalid URLs gracefully
• Network Issues: Temporary network issues are automatically retried
• Regional Restrictions: Some products may not be available in all regions

Troubleshooting

Common Issues

No Results Returned

• Verify the product URL is correct and active
• Check if the product has similar items available
• Try different country ISO codes

Slow Performance

• eBay's servers may be slow during peak hours
• Consider running during off-peak times
• Use pagination to process smaller batches

Regional Differences

• Product availability varies by country
• Prices and currencies will differ by region
• Some products may be region-restricted

---

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
• Email: pintoflowpt@gmail.com
• Apify Platform: You can also contact us directly through this platform.

---