eBay Store Products Actor

Overview

The eBay Store Products Actor is a web scraping tool deployed on the Apify platform that extracts product information from eBay store pages. This actor allows you to scrape product listings, including details like prices, titles, images, seller information, and store categories from any eBay store URL.

Features

• Multi-country Support: Works with eBay sites across 31+ countries
• Flexible Pagination: Control page number and items per page
• Advanced Filtering: Filter by listing type (All, Auction, Buy It Now)
• Multiple Sorting Options: Sort by best match, price, date, and more
• Comprehensive Data: Extracts detailed product information including prices, conditions, shipping details
• Store Categories: Retrieves available store categories with direct links

Input Parameters

Required Parameters

Parameter	Type	Description
storeUrl	String	The eBay store URL to scrape (e.g., 'https://www.ebay.com/str/lovellrugby?_trksid=p4429486.m3561.l161211')

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)
perPage	String	"24"	Number of items per page (24, 48, or 72)
type	String	"all"	Listing type filter (all, auction, bin)
sorting	String	"best_match"	Sort order for listings

Country ISO Codes

The actor supports the following countries:

Primary Markets:

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

Additional Markets:

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

Listing Types

Value	Description
all	All Listings
auction	Auction Only
bin	Buy It Now Only

Sorting Options

Value	Description
best_match	Best Match
ending_soonest	Ending Soonest
newly_listed	Newly Listed
lowest_price	Price: Lowest First
highest_price	Price: Highest First

Output Format

The actor returns a JSON object with the following structure:

Main Response Structure

{
  "products": [...],
  "totalAvailableProducts": 171,
  "categories": [...]
}

Product Object Structure

Each product in the products array contains:

Field	Type	Description
itemId	String	Unique eBay item identifier
title	String	Product title
imageUrl	String	Main product image URL
price	Object	Price information object
delivery	String	Shipping/delivery information
quantity	String	Available quantity
condition	String	Item condition
sellerInfo	String	Seller name and rating
productAttributes	Array	Product brand/attributes
freeReturns	String/null	Free returns policy
itemUrl	String	Direct link to the item

Price Object Structure

{
  "current": 121.62,
  "currency": "EUR",
  "previous": null,
  "discount": null,
  "discountPercentage": null
}

Category Object Structure

{
  "categoryId": "7708507013",
  "name": "Electrical & Test Equipment",
  "url": "https://www.ebay.com/str/ekmmetering/..."
}

Usage Examples

Basic Usage

{
  "storeUrl": "https://www.ebay.com/str/lovellrugby"
}

Advanced Usage with Filtering

{
  "storeUrl": "https://www.ebay.com/str/lovellrugby",
  "countryIso": "uk",
  "page": 2,
  "perPage": "48",
  "type": "bin",
  "sorting": "lowest_price"
}

Multi-page Scraping

{
  "storeUrl": "https://www.ebay.com/str/lovellrugby",
  "page": 1,
  "perPage": "72",
  "sorting": "newly_listed"
}

Error Handling

The actor includes comprehensive error handling:

• Invalid store URLs will throw an error with details
• Network issues are automatically retried
• Parsing errors are logged with context
• All errors are properly propagated to the Apify platform

Data Storage

The actor stores data in two ways:

1. Individual Records: Each product is pushed to the dataset individually using Actor.pushData()
2. Complete Output: The full result is stored as a named value using Actor.setValue('output', data)

Rate Limiting and Best Practices

• The actor respects eBay's robots.txt and rate limiting
• Use reasonable delays between requests for large-scale scraping
• Consider using different country sites to distribute load
• Monitor your usage to stay within Apify platform limits

Common Use Cases

1. Price Monitoring: Track product prices across different stores
2. Inventory Management: Monitor stock levels and availability
3. Market Research: Analyze product categories and pricing strategies
4. Competitive Analysis: Compare products across different sellers
5. Data Integration: Feed product data into e-commerce or analytics platforms

Technical Requirements

• Platform: Apify Cloud
• Runtime: Node.js
• Dependencies:
  • apify - Apify SDK
  • axios - HTTP client
  • Custom helpers.js module for store item processing

Support and Troubleshooting

Common Issues

1. Invalid Store URL: Ensure the URL is a valid eBay store URL
2. No Products Found: Check if the store has products and the URL is accessible
3. Country Mismatch: Verify the country ISO code matches the store's region
4. Rate Limiting: Reduce request frequency if encountering blocks

Debug Information

The actor logs the following information:

• Processing status for each store URL
• Successful completion messages
• Error details with full context

API Integration

Apify API Usage

// Run the actor via Apify API
const run = await apifyClient.actor('insert-the-actor-id').call({
  storeUrl: 'https://www.ebay.com/str/example-store',
  countryIso: 'us',
  page: 1,
  perPage: '24'
});

// Get results
const { items } = await apifyClient.dataset(run.defaultDatasetId).listItems();

Webhook Integration

Set up webhooks to automatically process new data:

{
  "eventType": "ACTOR.RUN.SUCCEEDED",
  "requestUrl": "https://the-webhook-endpoint.com/ebay-data"
}

---

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.

---