Look up an eBay seller's feedback score, positive-feedback rates, rating breakdown and top-rated or business status by username.
View all eBay Product Listings & Seller Data endpoints →Returns the public reputation of one eBay seller as structured JSON. seller is the only required input: the eBay seller username, which is the handle in /usr/{seller} or the 'Sold by' link on a listing. domain optionally selects the eBay site (13 verified sites; other eBay country sites such as com.sg or com.hk are also accepted according to the operation notes). No eBay account or seller authorization is needed on your side; the data comes from publicly visible seller information. The response is an ok/meta/data envelope and data.seller_profile is documented to hold store_name, feedback_score, feedback_positive_pct, positive_pct_12mo, items_sold_display, followers_display, member_since, location, business_seller, top_rated and feedback_ratings, an object with positive, neutral and negative entries that each carry m1, m6 and m12 counts. Observed in a live probe (seller musicmagpie, domain co.uk): HTTP 200, ok true, meta present and data.seller_profile an object containing seller, feedback_score, positive_pct_12mo, feedback_ratings and detailed_seller_ratings among other fields. The stored source example is not probe-verified and its meta reports domain com; it shows feedback_score as a large integer, feedback_positive_pct and positive_pct_12mo as percentages such as 99.1, items_sold_display and followers_display as abbreviated display strings such as "51.1M" and "487K" rather than numbers, member_since as a display date such as "Feb-02-11", location as a country name, business_seller and top_rated as booleans, and detailed_seller_ratings as scores on a five-point scale for Accurate description, Communication, Reasonable shipping cost and Shipping speed. The sample has a seller field and no store_name, so do not assume store_name is always present. The sample meta also carries record_count and a feedback_upstream_error flag (false in the sample), which is worth logging. Only one seller (musicmagpie) was probed; behavior for unknown seller names was not exercised.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/ebay/seller-profile API Response (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/seller-profile?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"seller":"<seller>"}' Query Result
Use Cases
- Vet a supplier or wholesale-lot seller before buying by comparing feedback_score and positive_pct_12mo with your own minimum thresholds
- Score competitor stores by joining seller-profile output with a seller-items catalog scan on the shared seller username
- Store dated snapshots of positive_pct_12mo and the feedback_ratings windows to catch a seller whose recent feedback is deteriorating
- Build a sourcing shortlist that highlights sellers flagged business_seller or top_rated
- Run a pre-purchase risk screen for resellers by comparing the negative counts in the m1, m6 and m12 windows against total feedback
- Show a seller reputation tooltip in a price-comparison tool using detailed_seller_ratings such as shipping speed and communication
Frequently asked questions
What does seller-profile return?
A data.seller_profile object for the seller username you send. The documented fields are store_name, feedback_score, feedback_positive_pct, positive_pct_12mo, items_sold_display, followers_display, member_since, location, business_seller, top_rated and feedback_ratings with positive, neutral and negative counts for m1, m6 and m12.
Which fields were confirmed by the live probe?
A call with seller musicmagpie and domain co.uk returned HTTP 200 with ok true and a data.seller_profile object containing seller, feedback_score, positive_pct_12mo, feedback_ratings and detailed_seller_ratings among other fields. The remaining fields, such as items_sold_display and member_since, come from the operation notes and the stored source example and were not individually confirmed by the probe summary.
What do m1, m6 and m12 mean?
They are the three windows of feedback_ratings. Given the matching positive_pct_12mo field they read as the last 1, 6 and 12 months, and in the stored source example the counts grow from m1 to m12 accordingly. The notes do not spell the windows out, so confirm against your own data before building thresholds on them.
Are items_sold_display and followers_display numbers?
No. In the stored source example they are abbreviated display strings such as "51.1M" and "487K", so parse the suffix yourself if you need a number. feedback_score is a plain integer and the percentage fields are numbers such as 99.1.
Do I need an eBay account or login to use it?
No. You send the seller username and optionally a domain. The data is publicly visible seller information, so no eBay credentials, OAuth tokens or seller authorization are involved on your side.
Does the domain parameter change the seller's reputation?
The notes only say domain selects the eBay site. The probe used co.uk and the stored source example reports domain com, and both returned a seller_profile for the same username; the source example shows a United Kingdom location. If you compare reputations across sites, run the call per domain and compare the results yourself.
What does top_rated mean and can I rely on it?
It is a boolean in seller_profile. The notes do not say whether it maps to eBay's Top Rated or Top Rated Plus badge, and the stored sample returned false for a very high-volume business seller. Treat it as a flag to validate against your own sample of sellers, and use feedback_score and positive_pct_12mo alongside it.
How do I get the seller's listings as well?
Call seller-items with the same username to list the seller's active storefront listings, then join the two results on the seller handle. seller-profile itself returns reputation data only.
What is feedback_upstream_error in meta?
The stored source example includes meta.feedback_upstream_error set to false along with record_count 1. The notes do not define it, but it is a sensible flag to log and to check before trusting feedback_ratings in an automated pipeline.