scrollport
Back to eBay product research

Product Search

eBay

Search active public eBay US listings with price, condition, seller and auction metadata.

Capability
eBay product research
Current price
$0.0049/result
Availability
Ready to run
Last accepted verification

What this API does

Search one keyword on ebay.com and return at most 100 normalized active listings. Filters are limited to the supplier's reliable US condition, listing type, integer-dollar price and sort controls. This route does not retrieve individual product pages, sold or completed listings, bids, purchases, account data or other eBay marketplaces.

Agents select this operation with tool ID ebay.product-search, then inspect its current executable contract before a run.

Public input and output shape

Input

inputobject · required

Provider-specific public source, URL or search criteria.

maxItemsinteger · optional

Maximum number of records to return.

minimum: 1 · maximum: 100

Output

marketplacestring

Returned marketplace value.

product_countnumber

Returned product count value.

productsarray

Returned products value.

retrieved_atstring

Returned retrieved at value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "ebay.product-search",
  "input": {
    "input": {
      "query": "wireless headphones",
      "condition": [
        "new"
      ],
      "listingType": "buy_it_now",
      "marketplace": "EBAY_US"
    },
    "maxItems": 1
  }
}

Output

{
  "products": [
    {
      "url": "https://www.ebay.com/itm/286393092388",
      "price": {
        "amount": "49.99",
        "currency": "USD"
      },
      "title": "Wireless headphones",
      "images": [],
      "seller": {
        "name": "example-seller",
        "feedback_count": "1.2K",
        "feedback_percent": "99.8%"
      },
      "source": "ebay",
      "status": "active",
      "item_id": "286393092388",
      "condition": "New",
      "marketplace": "EBAY_US",
      "listing_type": "Buy It Now",
      "retrieved_at": "2026-08-21T00:00:00.000Z"
    }
  ],
  "marketplace": "EBAY_US",
  "retrieved_at": "2026-08-21T00:00:00.000Z",
  "product_count": 1
}
Teaching errors and limitations
  • invalid_input: eBay search accepts one query and only the bounded US marketplace filters shown in the schema.example: {"input":{"query":"wireless headphones","marketplace":"EBAY_US","condition":["new"],"listingType":"buy_it_now"},"maxItems":10}
  • upstream_error: eBay or the search supplier did not return usable active listing rows.Retry with a narrower query or fewer filters. No eBay login or seller action is supported.
Updated
21 August 2026

Use Product Search with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.