eBay Product Info Actor Documentation

Overview

The eBay Product Info Actor is a powerful web scraping tool deployed on the Apify platform that extracts comprehensive product information from eBay listings. This actor can process multiple eBay product URLs simultaneously and retrieve detailed information including pricing, availability, seller details, shipping options, and more.

Features

• Multi-URL Processing: Process multiple eBay product URLs in a single run
• International Support: Supports eBay sites from 30+ countries
• Comprehensive Data Extraction: Retrieves detailed product information including:
  • Product title, condition, and pricing
  • Image URLs and variants
  • Seller/store information
  • Shipping options
  • Item specifications
  • Availability and stock information
• Structured Output: Returns well-formatted JSON data for easy integration

Input Configuration

Required Parameters

productUrls (Array of Objects)

• Type: Array
• Required: Yes
• Description: List of eBay product URLs to scrape
• Format: Each URL should be provided as an object with a url property
• Example:

[
  { "url": "https://www.ebay.com/itm/326453180272" },
  { "url": "https://www.ebay.com/itm/356947020208" }
]

Optional Parameters

countryIso (String)

• Type: String
• Required: No
• Default: "us"
• Description: Two-letter ISO country code to specify which eBay regional site to use
• Supported Countries:
  • Primary Markets: US, UK, Germany, France, Italy, Spain, Canada, Australia
  • European Markets: Austria, Belgium, Switzerland, Netherlands, Ireland, Poland, Czech Republic, Denmark, Finland, Greece, Hungary, Norway, Sweden
  • Asia-Pacific: Japan, South Korea, China, Hong Kong, Singapore, Malaysia, Philippines, Thailand, Taiwan, Vietnam, Indonesia, India, Israel
  • Americas: Brazil, Argentina, Colombia, Mexico
  • Oceania: New Zealand

Output Data Structure

The actor returns an array of product objects, each containing the following fields:

Core Product Information

• itemId (Number): Unique eBay item identifier
• title (String): Product title as listed on eBay
• condition (String): Item condition (e.g., "New", "Used", "Refurbished")
• price (Number): Current price of the item
• currency (String): Currency code (e.g., "USD", "EUR")
• discount (Number|null): Discount amount if applicable
• soldQuantity (Number): Number of items sold
• url (String): Original eBay product URL

Images

• imageUrl (String): Primary product image URL
• imageUrls (Array): Array of all available product image URLs

Variants and Availability

• itemVariants (Array): Available product variants (sizes, colors, etc.)
  • value (String): Variant option (e.g., size "10.5")
  • isAvailable (Boolean): Whether this variant is in stock

Seller Information

• storeDetails (Object): Seller/store information
  • storeName (String): eBay store username
  • title (String): Display name of the store
  • url (String): Link to the seller's eBay store
  • feedback (String): Seller feedback rating
  • positivePercent (String): Positive feedback percentage

Shipping

• shippingOptions (Array): Available shipping methods
  • shippingCost.price (Number): Shipping cost
  • shippingCost.currency (String): Shipping cost currency
  • shippingMethod (String): Shipping service name
  • itemLocation (String): Item location information

Additional Details

• itemSpecifics (Object): Technical specifications and item details
• extraDetails (String): Additional information like watchers, interest level

Example Usage

Basic Configuration

{
  "productUrls": [
    { "url": "https://www.ebay.com/itm/326453180272" },
    { "url": "https://www.ebay.com/itm/356947020208" }
  ],
  "countryIso": "us"
}

Multi-Country Example

{
  "productUrls": [
    { "url": "https://www.ebay.de/itm/123456789" },
    { "url": "https://www.ebay.de/itm/987654321" }
  ],
  "countryIso": "de"
}

Sample Output

[
  {
    "itemId": 326453180272,
    "title": "Nike Air Zoom Maxfly Lemon Twist Sail Track Masculino Spikes Max Fly - NOVAS Chuteiras-",
    "condition": "Novo, sem caixa",
    "price": 99.97,
    "currency": "USD",
    "discount": null,
    "soldQuantity": 7,
    "imageUrl": "https://i.ebayimg.com/thumbs/images/g/60cAAOSwcnhnt0vW/s-l500.jpg",
    "imageUrls": [
      "https://i.ebayimg.com/thumbs/images/g/60cAAOSwcnhnt0vW/s-l500.jpg",
      "https://i.ebayimg.com/images/g/60cAAOSwcnhnt0vW/s-l1600.webp"
    ],
    "itemVariants": [
      {
        "value": "14",
        "isAvailable": true
      },
      {
        "value": "8.5",
        "isAvailable": false
      }
    ],
    "storeDetails": {
      "storeName": "dottsshoppe",
      "title": "Dotts Shoppe",
      "url": "https://www.ebay.com/str/dottsshoppe?_trksid=p4429486.m3561.l161211",
      "feedback": "99.5% de avaliações positivas",
      "positivePercent": ""
    },
    "itemSpecifics": {},
    "shippingOptions": [
      {
        "shippingCost": {
          "price": 37.13,
          "currency": "USD"
        },
        "shippingMethod": "eBay International Shipping",
        "itemLocation": "Aproximadamente"
      }
    ],
    "extraDetails": "Várias pessoas estão interessadas. 32 pessoas estão observando o item.",
    "url": "https://www.ebay.com/itm/326453180272"
  }
]

Use Cases

E-commerce & Price Monitoring

• Competitive Analysis: Monitor competitor pricing and product availability
• Price Tracking: Track price changes over time for specific products
• Market Research: Analyze product trends and pricing strategies

Business Intelligence

• Inventory Management: Check availability of products across different sellers
• Supplier Analysis: Evaluate seller ratings and shipping options
• Market Expansion: Research products in different geographic markets

Data Integration

• API Integration: Feed eBay data into existing business systems
• Database Population: Bulk import product data for catalogs
• Analytics Platforms: Export data for further analysis and reporting

Best Practices

Input Optimization

• Batch Processing: Process multiple URLs in a single run for efficiency
• URL Validation: Ensure URLs are valid eBay product links
• Country Matching: Use the appropriate country ISO code for the eBay domain

Rate Limiting & Performance

• Reasonable Batch Sizes: Avoid processing too many URLs simultaneously
• Monitor Usage: Keep track of Apify platform usage and costs
• Error Handling: The actor includes built-in error handling for robustness

Data Usage

• Regular Updates: Product information changes frequently on eBay
• Data Validation: Verify critical information before using in business decisions

Error Handling

The actor includes comprehensive error handling:

• Invalid URLs are logged and skipped
• Network errors are retried automatically
• Detailed error messages are provided in logs
• Partial failures don't stop the entire run

Technical Requirements

• Platform: Apify Cloud Platform
• Runtime: Node.js
• Dependencies: Custom helper functions for eBay data extraction
• Output Format: JSON
• Storage: Results are stored both individually and as a complete dataset

Support & Troubleshooting

Common Issues

• Invalid URLs: Ensure URLs are direct links to eBay product pages
• Country Mismatch: Verify the country ISO code matches the eBay domain
• Rate Limiting: If experiencing timeouts, reduce batch size or add delays

Getting Help

• Check the Apify platform logs for detailed error messages
• Verify input format matches the expected schema
• Ensure eBay URLs are accessible and not region-restricted

Pricing & Usage

This actor runs on the Apify platform with usage-based pricing. Costs depend on:

• Number of URLs processed
• Compute time required
• Data storage needs

Monitor your usage through the Apify console to optimize costs and performance.

---

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.

---