eBay Products By Category Actor

Overview

The eBay Products By Category Actor is an Apify actor designed to scrape product listings from eBay category pages. This actor extracts detailed product information including titles, prices, images, conditions, shipping details, and more from any eBay category URL.

Features

• Category-based scraping: Extract all products from any eBay category page
• Multi-country support: Support for 30+ eBay regional sites
• Comprehensive data extraction: Captures product titles, prices, images, conditions, shipping info, and metadata
• JSON output: Returns structured data in JSON format
• Error handling: Robust error handling and logging

Input Parameters

Required Parameters

Parameter	Type	Description
categoryUrl	string	The eBay category URL to scrape products from

Optional Parameters

Parameter	Type	Default	Description
countryIso	string	"us"	Two-letter ISO country code for eBay regional site

Supported Country Codes

The actor supports the following eBay regional sites:

Primary Markets:

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

Additional Markets:

• 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 Schema Example

{
  "categoryUrl": "https://www.ebay.com/b/3D-Printers-Supplies/183062/bn_55163226?_pgn=1&_sop=15",
  "countryIso": "us"
}

Output Format

The actor returns an array of product objects with the following structure:

[
  {
    "title": "Product title",
    "price": 87,
    "currency": "USD",
    "url": "https://www.ebay.com/itm/...",
    "imageUrl": "https://i.ebayimg.com/thumbs/images/...",
    "condition": "Novo em folha",
    "shipping": "Frete grátis",
    "isAuction": false,
    "bids": null,
    "extraInfo": "Additional information like sold count"
  }
]

Output Fields Description

Field	Type	Description
title	string	Product title/name
price	number	Product price (numeric value)
currency	string	Currency code (e.g., "USD", "EUR")
url	string	Direct link to the product page
imageUrl	string	URL of the product's main image
condition	string	Product condition (New, Used, etc.)
shipping	string	Shipping information
isAuction	boolean	Whether the listing is an auction
bids	number/null	Number of bids (for auctions)
extraInfo	string	Additional information (sold count, etc.)

Usage Examples

Basic Usage

{
  "categoryUrl": "https://www.ebay.com/b/Cell-Phones-Smart-Watches/15032/bn_1865441"
}

With Country Specification

{
  "categoryUrl": "https://www.ebay.de/b/Smartphones/9355/bn_1865441",
  "countryIso": "de"
}

Advanced Category with Filters

{
  "categoryUrl": "https://www.ebay.com/b/3D-Printers-Supplies/183062/bn_55163226?_pgn=1&_sop=15&_udlo=10&_udhi=100",
  "countryIso": "us"
}

How to Use

1. Set up input: Configure the categoryUrl parameter with your target eBay category URL
2. Choose region: Select the appropriate countryIso code for your target market
3. Run the actor: Execute the actor through Apify Console, API, or SDK
4. Retrieve results: Access the scraped data from the actor's dataset

Using Apify SDK

import { ApifyApi } from 'apify-client';

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

const input = {
    categoryUrl: 'https://www.ebay.com/b/Electronics/293/bn_1865334',
    countryIso: 'us'
};

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

console.log(items);

Error Handling

The actor includes comprehensive error handling:

• Network errors: Automatic retries for failed requests
• Invalid URLs: Validation of category URLs
• Rate limiting: Built-in delays to respect eBay's rate limits
• Data parsing errors: Graceful handling of malformed data

Performance Notes

• The actor processes one category page per run
• Processing time varies based on the number of products in the category
• Memory usage scales with the number of products extracted
• Recommended for categories with up to 1000 products per run

Limitations

• Only scrapes the first page of category results (use pagination parameters in URL for additional pages)
• Requires valid eBay category URLs
• Some product details may vary based on eBay's regional differences

Best Practices

1. URL Format: Ensure category URLs are properly formatted and accessible
2. Rate Limiting: Allow sufficient time between runs to avoid being blocked
3. Country Selection: Choose the correct country ISO code for accurate regional data
4. Error Monitoring: Monitor actor runs for any errors or failures
5. Data Validation: Validate extracted data before using in production systems

---

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.

---