eBay Commerce & Promotions scraper API

Search eBay products and observe sponsored, banner, and merchandising placements.

Commerce & delivery 7 capabilities beta Degraded

What people use it for

Price and assortment monitoring
Sponsored-placement monitoring
Product research
Promotion inventory analysis

Capabilities

Every capability is one POST /execute call that returns structured JSON.

List categories


            ebay.categories.list

1 credit / request Endpoint docs Copy coding prompt

Return eBay's public category hierarchy.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{},"capability":"ebay.categories.list"}'

Deferred item promotions


            ebay.item.deferred_promotions

1 credit / request Endpoint docs Copy coding prompt

Discover and return deferred item-page promotion fragments from eBay's SSE surface.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"item_id":"283987164379"},"capability":"ebay.item.deferred_promotions"}'

Input

Field	Type	Required	Description
`item_id`	string	required
`placements`	array<string>	optional

Item promotions


            ebay.item.promotions

1 credit / request Endpoint docs Copy coding prompt

Return typed merchandising modules shown around an eBay item.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"item_id":"283987164379","source_module_id":"101506"},"capability":"ebay.item.promotions"}'

Input

Field	Type	Required	Description
`item_id`	string	required
`source_module_id`	string	optional

Get item


            ebay.product.detail.get

1 credit / request Endpoint docs Copy coding prompt

Return current eBay item detail from JSON-LD with page supplements.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"item_id":"283987164379"},"capability":"ebay.product.detail.get"}'

Input

Field	Type	Required	Description
`item_id`	string	required

Search listings


            ebay.products.search

1 credit / request Endpoint docs Copy coding prompt

Return filtered eBay listings with display fields and sponsored disclosure.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"condition":3000,"limit":60,"max_price":"500","min_price":"100","page":1,"query":"used laptop","sort":"lowest_price"},"capability":"ebay.products.search"}'

Input

Field	Type	Required
`category`	integer	optional
`condition`	integer	optional
`limit`	integer	optional
`listing_type`	string	optional
`max_price`	string	optional
`min_price`	string	optional
`page`	integer	optional
`query`	string	required
`seller`	string	optional
`sold`	boolean	optional
`sort`	string	optional

Search placements


            ebay.search.placements

1 credit / request Endpoint docs Copy coding prompt

Return eBay's ordered search feed with sponsored disclosure from embedded state.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":60,"page":1,"query":"used laptop"},"capability":"ebay.search.placements"}'

Input

Field	Type	Required
`limit`	integer	optional
`page`	integer	optional
`query`	string	required

Search promotions


            ebay.search.promotions

1 credit / request Endpoint docs Copy coding prompt

Return sponsored search placements and RTM banner inventory.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":60,"page":1,"query":"used laptop"},"capability":"ebay.search.promotions"}'

Input

Field	Type	Required
`limit`	integer	optional
`page`	integer	optional
`query`	string	required

Run eBay Commerce & Promotions in under a minute

Get an API key