eBay Seller

Get an eBay seller's profile and listings.

GET/api/v1/ebay/seller

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Request

Parameter	Type	Description
`seller_id`required	string	Seller username for type=user, or the store URL slug for type=store.
`type`required	"user" \| "store"	Public seller profile type.

Marketplace

Parameter	Type	Description
`ebay_domain`	"ebay.com" \| "ebay.co.uk" \| "ebay.ca" \| "ebay.com.au" \| "ebay.de" \| "ebay.fr" \| "ebay.it" \| "ebay.es" \| "ebay.at" \| "ebay.be" \| "ebay.ch" \| "ebay.ie" \| "ebay.nl" \| "ebay.com.hk" \| "ebay.com.my" \| "ebay.pl" \| "ebay.com.sg"	eBay marketplace hostname.Default: ebay.com.

Listing filters

Parameter	Type	Description
`buying_format`	"0" \| "1" \| "2"	All listings (0), Buy It Now (1), or auctions (2).Default: 0.
`LH_ItemCondition`	string	Condition IDs joined with \|: 3 new, 4 used, 10 unspecified.Up to 20 characters.
`free_shipping`	boolean	Only products with free shipping.Default: false.

Pagination and sorting

Parameter	Type	Description
`_pgn`	integer	Result page, starting at 1.Default: 1.Range: 1 to 2147483647.
`_ipg`	"24" \| "48" \| "72"	Products per page.Default: 48.
`_sop`	"1" \| "7" \| "10" \| "12" \| "15" \| "16"	Sort: 12 best match, 1 ending soonest, 7 nearest, 10 newly listed, 15/16 total price ascending/descending.Default: 12.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: seller_results, product_results, featured_categories, about, feedback, pagination and serpfast_pagination. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/ebay/seller?seller_id=antonline&type=store&_ipg=24" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "seller_id": "antonline",
  "type": "store",
  "_ipg": 24
});
const res = await fetch(`https://serpfast.com/api/v1/ebay/seller?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "seller_id": "antonline",
  "type": "store",
  "_ipg": 24
}
res = requests.get(
    "https://serpfast.com/api/v1/ebay/seller",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())