eBay API endpoint

Get eBay seller shop listings

Returns normalized listings from the public eBay seller shop tab, with pagination backed by the store odtRefresh response.

GETapiKey3 credits/requestebay.sellerShopResponseDoc/ebay/seller/{seller}/shop

Parameters

Name	In	Type	Required	Description
seller	path	string	Yes	eBay seller username
page	query	integer	No	Shop page number
x-api-key	header	string	Yes	API key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 3 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Catalog quality warnings

missing example for required path param: seller

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
502	Bad Gateway	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "page": 1,
    "total": 120,
    "has_more": true,
    "result": [
      {
        "item_id": "196435705622",
        "title": "1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE",
        "link": "https://www.ebay.com/itm/196435705622",
        "price": 49.95,
        "seller": "poloblade",
        "logistic": "Free shipping"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/ebay.sellerShopResponseDoc

Field	Type	Required	Example	Description
code	integer	No		Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	ebay.SearchResp	No
data.has_more	boolean	No	true
data.page	integer	No	1
data.result	array	No
data.result[].bid_count	integer	No	9
data.result[].caption	string	No	caption
data.result[].image	string	No	https://i.ebayimg.com/images/g/b6wAAOSwLRdmZeHS/s-l500.jpg
data.result[].is_authenticity_guaranteed	boolean	No	false
data.result[].item_id	string	No	196435705622
data.result[].link	string	No	https://www.ebay.com/itm/196435705622
data.result[].location	string	No	Canada
data.result[].logistic	string	No	+$4.95 shipping
data.result[].offer_note	string	No	Buy It Now
data.result[].price	number	No	49.95
data.result[].price_from	number	No	10	$10 to $20
data.result[].price_to	number	No	20
data.result[].rating	number	No	5
data.result[].rating_num	integer	No	1
data.result[].seller	string	No	soonerfan1949 (998) 100%
data.result[].sold_count	integer	No	178
data.result[].sub_title	string	No	Pre-Owned
data.result[].title	string	No	1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE
data.result[].watcher_count	integer	No	26
data.total	integer	No	120
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Example request

curl -X GET "https://api.crawlora.net/api/v1/ebay/seller/%3Cseller%3E/shop" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/ebay/seller/%3Cseller%3E/shop");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group