eBay API — Parse an eBay URL
Documentation menu
FetchLayer FetchLayer API

Parse an eBay URL

Turn any eBay URL into the fields the other endpoints take, without contacting eBay. A listing URL gives its itemId, a search URL its query, categoryId and seller, a category URL its categoryId, a seller profile or feedback URL the username, a store URL the store name, and a catalogue product or reviews URL its productId. Hand it a link a colleague pasted and pass the result straight on. A URL that is not eBay, or an eBay URL of another kind, is a 400. Parsing a URL does not consume a credit.

POST /resolve-url Utility
https://api.fetchlayer.dev/ebay/resolve-url
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

url string required

Any eBay URL, to be parsed into structured input.

format string optional

json or markdown. Markdown returns the same result rendered for a model to read. (default: json)

timeoutMs number optional

Time limit for each eBay page read, in milliseconds (max 120000).

Response Fields

resolve-url

Parse an eBay URL

kind string

listing, search, category, seller, seller-feedback, store, product or product-reviews.

url string

The URL that was parsed.

itemId string

Present when kind is listing — pass it to listing-details or price-check.

query string

Present when kind is search, with categoryId, seller and page alongside it.

categoryId string

Present when kind is search or category; a category also carries its name.

username string

Present when kind is seller or seller-feedback — pass it to seller-feedback.

storeName string

Present when kind is store.

productId string

Present when kind is product or product-reviews — pass it to product-reviews.

Request

curl -X POST "https://api.fetchlayer.dev/ebay/resolve-url" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.ebay.com/sch/i.html?_nkw=anker+usb+c+charger&_sacat=123417"}'

Response

{
  "kind": "search",
  "query": "anker usb c charger",
  "categoryId": "123417",
  "seller": null,
  "page": 1,
  "url": "https://www.ebay.com/sch/i.html?_nkw=anker+usb+c+charger&_sacat=123417"
}