Pricing

Rating

Developer

Actor stats

Categories

Share

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

Optional Parameters

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

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 =newApifyApi({
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.