Read a seller's feedback
A member's feedback profile and the individual feedback behind it. The profile carries the feedback score, positive percentage over twelve months, member-since date, location and store URL, positive, neutral and negative counts for the last month, six months and twelve months, and detailed seller ratings for accurate description, shipping cost, shipping speed and communication. Each entry has its rating, the comment, the buyer (masked by eBay, for example "e***4") and their feedback score, when it was left, and the item title, id and price. eBay publishes feedback dates only as relative text such as "Past month", never an exact date. Filter by role and rating, and set includeAutomated to false to read only what buyers wrote rather than eBay's automatic on-time-delivery feedback. An unknown username is a 404.
/seller-feedback Reviews & feedback https://api.fetchlayer.dev/ebay/seller-feedback Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
seller string required eBay username (for example vipoutlet), or a seller profile or feedback URL. A store URL is refused: a store name is not necessarily its seller's username.
role string optional Feedback received as_seller, as_buyer, or all. (default: as_seller)
rating string optional all, positive, neutral or negative. (default: all)
includeAutomated boolean optional Include eBay's automatic feedback for orders delivered on time. Set false to read only buyer-written feedback. (default: true)
limit number optional Maximum feedback entries returned (max 500), or -1 for the maximum. (default: 25)
pages number optional Pages to collect in one request (max 50), or -1 for the maximum allowed. Defaults to as many as limit needs. Each page counts as one request.
cursor string optional Resume from a previous response's nextCursor. A cursor is bound to the request that produced it, so send the same filters with it — a cursor replayed against different filters is a 400.
delayMs number optional Milliseconds to wait between pages (max 30000).
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
seller-feedback
Read a seller's feedback
resultType string Which shape this response is: search-listings, listing-details, price-check, seller-feedback or product-reviews.
requestedUrl string The eBay page this result corresponds to.
scrapedAt string ISO 8601 timestamp of when the data was read.
transport string The upstream source. Always "ebay".
notes string[] Caveats about this particular result — converted prices, a walk that stopped early, a continuation that may repeat listings. Read it on every call: it is where an incomplete answer announces itself.
seller object The profile.
seller.feedbackScore number Feedback score, with username alongside it.
seller.positivePercent number Positive feedback percentage over the last 12 months.
seller.memberSince string As shown, for example "Mar-12-02".
seller.location string Member location, with storeUrl alongside it.
seller.ratingsLastMonth object { positive, neutral, negative } counts; ratingsLast6Months and ratingsLast12Months have the same shape.
seller.detailedRatings object[] { name, average, count } for accurate description, shipping cost, shipping speed and communication.
seller.totalFeedback number Total feedback received.
feedback object[] Individual feedback, newest first.
feedback[].feedbackId string Stable id for the entry.
feedback[].rating string positive, neutral or negative.
feedback[].comment string The comment.
feedback[].from string The member who left it, masked by eBay ("e***4"), or "eBay automated feedback"; fromFeedbackScore alongside it.
feedback[].when string Relative text as eBay publishes it, for example "Past month".
feedback[].itemTitle string The item the feedback was left on, with itemId and itemPrice alongside it.
feedback[].verifiedPurchase boolean Whether eBay marks it as a verified purchase.
feedback[].automated boolean True for eBay's automatic on-time-delivery feedback.
feedbackCount number Length of feedback.
pagesScraped number Pages actually collected. Each page counts as one request against your plan.
pagesRequested number Pages this request asked for.
nextCursor string Pass back as cursor to continue, or null when there is nothing further.
hasNextPage boolean Whether more results are available beyond this response.
Request
curl -X POST "https://api.fetchlayer.dev/ebay/seller-feedback" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"seller":"vipoutlet","includeAutomated":false,"limit":25}'Response
{
"resultType": "seller-feedback",
"transport": "ebay",
"notes": [],
"seller": {
"username": "vipoutlet",
"feedbackScore": 963024,
"positivePercent": 97.2,
"memberSince": "Mar-12-02",
"location": "United States",
"storeUrl": "https://stores.ebay.com/vipoutlet",
"ratingsLastMonth": {
"positive": 90637,
"neutral": 628,
"negative": 1245
},
"ratingsLast6Months": {
"positive": 377786,
"neutral": 3448,
"negative": 7045
},
"ratingsLast12Months": {
"positive": 590119,
"neutral": 5959,
"negative": 14236
},
"detailedRatings": [
{
"name": "Accurate description",
"average": 4.4,
"count": 72587
},
{
"name": "Shipping speed",
"average": 4.9,
"count": 106637
}
],
"totalFeedback": 1278373
},
"feedback": [
{
"feedbackId": "2732053565020",
"rating": "positive",
"comment": "Good quality OEM ink, $ & thank you.",
"from": "e***4",
"fromFeedbackScore": 2507,
"when": "Past month",
"itemTitle": "Epson T232 Combo High Yield Ink Cartridge - Black/Cyan/Magenta/Yellow",
"itemId": "134663833588",
"itemPrice": {
"amount": 32,
"currency": "USD"
},
"verifiedPurchase": true,
"automated": false
}
],
"feedbackCount": 25,
"pagesScraped": 1,
"pagesRequested": 1,
"nextCursor": "eyJ2IjoxLCJwIjoyLCJvIjowLCJzIjoyNSwiYiI6Ijk0MGU1OWEwZTBmNyJ9",
"hasNextPage": true
}