eBay Product Search Actor

The eBay Product Search Actor is a powerful web scraping tool deployed on the Apify platform that enables you to search and extract product information from eBay across multiple regions and marketplaces.

Overview

This actor provides comprehensive search capabilities for eBay products with advanced filtering options including price ranges, conditions, locations, shipping preferences, and seller ratings. It's designed to help businesses, researchers, and developers gather market intelligence and product data efficiently.

Features

• Global Coverage: Search across 31+ eBay regional sites
• Advanced Filtering: Filter by condition, price range, location, shipping options, and seller ratings
• Flexible Sorting: Multiple sorting options including price, date, and relevance
• Pagination Support: Navigate through multiple pages of results
• Keyword Exclusion: Exclude unwanted terms from search results
• Structured Output: Returns clean, structured JSON data

Input Configuration

Required Parameters

Parameter	Type	Description
query	string	Search term for items (e.g., 'macbook pro', 'iphone 15')

Optional Parameters

Parameter	Type	Default	Description
countryIso	string	"us"	Two-letter country ISO code for eBay regional site
condition	string	"used"	Filter items by condition
minPrice	integer	0	Minimum price filter (in local currency)
maxPrice	integer	50000	Maximum price filter (in local currency)
location	string	"worldwide"	Geographic scope for search results
sort	string	"price_asc"	How to sort the search results
shipping	string	"free"	Filter by shipping preferences
seller	string	"top_rated"	Filter by seller rating/type
excludeKeywords	string	"broken damaged"	Keywords to exclude from search (space-separated)
page	integer	1	Page number for pagination (starting from 1)

Parameter Options

Country ISO Codes (countryIso)

Supported eBay regional sites:

• Americas: us, usa, ca, ar, br, co, mx
• Europe: uk, de, fr, it, es, nl, be, at, ch, ie, pl, cz, dk, fi, gr, hu, no, se
• Asia-Pacific: au, hk, my, nz, ph, sg, cn, in, id, il, jp, kr, th, tw, vn

Item Condition (condition)

• all - All Conditions
• new - New
• opened - Opened/Like New
• refurbished - Refurbished
• used - Used

Search Location (location)

• worldwide - Worldwide
• us_only - US Only
• north_america - North America
• europe - Europe
• asia - Asia

Sort Order (sort)

• best_match - Best Match
• price_asc - Price: Low to High
• price_desc - Price: High to Low
• ending_soonest - Ending Soonest
• newly_listed - Newly Listed
• nearest_first - Nearest First

Shipping Options (shipping)

• all - All Shipping
• free - Free Shipping
• local_pickup - Local Pickup
• ready_to_ship - Ready to Ship
• one_day_shipping - One Day Shipping

Seller Type (seller)

• all - All Sellers
• top_rated - Top Rated Sellers
• returns_accepted - Returns Accepted

Usage Examples

Basic Search

{
  "query": "macbook pro"
}

Advanced Search with Filters

{
  "query": "iphone 15",
  "countryIso": "uk",
  "condition": "new",
  "minPrice": 500,
  "maxPrice": 1200,
  "location": "europe",
  "sort": "price_asc",
  "shipping": "free",
  "seller": "top_rated",
  "excludeKeywords": "cracked broken",
  "page": 1
}

Price Range Search

{
  "query": "gaming laptop",
  "minPrice": 800,
  "maxPrice": 2000,
  "condition": "used",
  "sort": "price_asc"
}

Regional Search

{
  "query": "vintage watch",
  "countryIso": "de",
  "location": "europe",
  "seller": "returns_accepted"
}

Output Format

The actor returns structured JSON data containing:

{
  "results": {
    "items": [
      {
        "itemId": 365539079543,
        "title": "MacBook Pro 13 \" 2014 Core i5 (I5-4278U) 2.6GHz 8Go 128Go - Qwertz (De)",
        "price": 275.68,
        "currency": "USD",
        "shipping": 0,
        "total": 290.77,
        "discount": null,
        "soldQuantity": 0,
        "imageUrl": "https://i.ebayimg.com/images/g/Q3gAAeSwCVpn~pzr/s-l140.webp",
        "time-left": "",
        "time-end": "",
        "bid-count": null,
        "reviews-count": null,
        "condition": "Seminovo",
        "location": "de França",
        "delivery-date": "",
        "url": "https://www.ebay.com/itm/365539079543?..."
      }
    ],
    "count": 50
  },
  "completedAt": "2025-05-27T11:12:58.601Z"
}

Output Fields Description

Field	Type	Description
itemId	number	Unique eBay item identifier
title	string	Product title/name
price	number	Item price in specified currency
currency	string	Currency code (e.g., "USD", "EUR")
shipping	number	Shipping cost
total	number	Total cost (price + shipping)
discount	number/null	Discount amount if applicable
soldQuantity	number	Number of items sold
imageUrl	string	Product image URL
time-left	string	Time remaining for auction items
time-end	string	Auction end time
bid-count	number/null	Number of bids for auction items
reviews-count	number/null	Number of product reviews
condition	string	Item condition (e.g., "Seminovo", "New")
location	string	Seller location
delivery-date	string	Expected delivery date
url	string	Direct link to the eBay listing

Data Storage

The actor provides two types of data storage:

1. Dataset: Contains the complete search results with product details including itemId, pricing, shipping, condition, and location information
2. Key-Value Store: Stores search summary with metadata under the key SEARCH_SUMMARY

Error Handling

The actor includes comprehensive error handling:

• Validates required parameters
• Handles network timeouts and connection issues
• Provides descriptive error messages
• Gracefully handles empty search results

Performance Tips

1. Pagination: Use the page parameter to collect large datasets efficiently
2. Filtering: Apply filters to reduce response time and focus on relevant results
3. Regional Optimization: Use appropriate countryIso codes for better regional relevance
4. Keyword Exclusion: Use excludeKeywords to filter out irrelevant results

Rate Limits and Best Practices

• Implement delays between requests when scraping multiple pages
• Use specific search terms to get more relevant results
• Consider using price ranges to narrow down results
• Monitor actor usage to stay within platform limits

Integration Examples

JavaScript/Node.js

const { ApifyClient } = require('apify-client');

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

const input = {
    query: 'macbook pro',
    condition: 'used',
    maxPrice: 1500
};

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

// Access product data
items.forEach(item => {
    console.log(`Product: ${item.results.items[0].title}`);
    console.log(`Price: ${item.results.items[0].price} ${item.results.items[0].currency}`);
    console.log(`Total with shipping: ${item.results.items[0].total}`);
});

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "query": "macbook pro",
    "condition": "used",
    "maxPrice": 1500
}

run = client.actor("THE_ACTOR_ID").call(run_input=run_input)
items = client.dataset(run["defaultDatasetId"]).list_items().items

# Access product data
for item in items:
    for product in item['results']['items']:
        print(f"Product: {product['title']}")
        print(f"Price: {product['price']} {product['currency']}")
        print(f"Total with shipping: {product['total']}")

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.

---