eBay Product Scraper — Discover by Keyword

Find eBay products by keyword and get full product detail for each result. Provide one or more keywords plus a cap on how many products to keep per keyword — the cap is enforced both server-side (so your bill stays bounded) and client-side (as a safety net).

What this Actor does

For each keyword you submit, the Actor asks the data provider to discover matching eBay products and return one record per result with ~58 fields (title, price, condition, brand, photos, seller info, reviews, breadcrumbs, item specifics, description HTML, related items, GTIN/MPN…).

Each row includes a discovery_input.keywords field so you can tell which keyword produced it — useful when running multiple keywords in one go.

Input

Field	Type	Required	Default	Description
keywords	array of strings	yes	—	One or more search keywords. Each is sent as its own search.
max_results_per_keyword	integer (1–1000)	no	10	Cap on how many products to return per keyword. Sent to the provider as limit_per_input to bound cost.

Example input:

{
    "keywords": ["baby toys", "shirts"],
    "max_results_per_keyword": 25
}

Output

Each item in the dataset has this shape (matches the upstream schema, 58 fields). Notable fields:

{
    "url": "https://www.ebay.com/itm/306841246248",
    "product_id": "306841246248",
    "item_id": "306841246248",
    "title": "Sheriff Labrador Dog Plush Toy Soft Doll Stuffed Animal Security Sergeant",
    "image_url": "https://i.ebayimg.com/images/g/...",
    "images": ["...", "..."],
    "price": "$10.90",
    "currency": "USD",
    "condition": "New",
    "brand": "Unbranded",
    "availability": "in_stock",
    "available_count": 5,
    "sold_count": "36",
    "seller_name": "datolive99",
    "seller_rating": "97.5% positive feedback",
    "seller_reviews": "373",
    "seller_url": "https://www.ebay.com/str/datolive99",
    "root_category": "Baby",
    "product_category": "Baby>Toys for Baby>Plush Baby Toys",
    "category_tree": [...],
    "breadcrumbs": [...],
    "product_specifications": [...],
    "description": "...",
    "description_from_the_seller_parsed": "<p>...</p>",
    "tags": ["..."],
    "you_may_also_like": [...],
    "gtin": "...",
    "mpn": "...",
    "discovery_input": { "keywords": "baby toys" },
    "timestamp": "2026-05-18T18:54:08.123Z",
    "input": { "url": "https://www.ebay.com/...", "discovery_input": { "keywords": "baby toys" } }
}

Field-type notes

Some fields come back as strings with units so they're preserved as strings:

• price, sale_price — "$10.90" (currency symbol + value)
• sold_count — "36" (sometimes "100+" or "More than 50")
• seller_rating — "97.5% positive feedback"
• seller_reviews, reviews_count — strings to keep "1,234" formatting intact

Numeric fields stay numeric: available_count, seller_total_reviews, item_reviews, product_ratings.

Limits & responsible use

• The Actor only returns information that is publicly visible on eBay search results / listing pages.
• Respect eBay's Terms of Service and applicable data-protection regulations.