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

Lifetime score and 12-month positive rate feedback_score, feedback_positive_pct and positive_pct_12mo give both the all-time standing and the recent trend of a seller in one object.
Feedback counts by time window feedback_ratings splits positive, neutral and negative counts into m1, m6 and m12 windows, so a recent dip in feedback is visible next to the long-run totals.
Detailed seller ratings The probe returned a detailed_seller_ratings object; the stored sample shows five-point scores for Accurate description, Communication, Reasonable shipping cost and Shipping speed.
Top-rated and business-seller flags top_rated and business_seller are booleans that make it easy to filter sourcing shortlists without reading the seller's pages by hand.
Store scale and tenure at a glance items_sold_display, followers_display, member_since and location describe how big and how old a store is. The first two are abbreviated display strings, not numbers.
Reputation from a username alone Only seller is required and domain is optional. No eBay login, seller authorization or listing ID is needed to read a public seller's standing.
Same seller handle as storefront scans The username that seller-items scans can be sent here unchanged, so listings and reputation for one seller can be joined on that handle.

Live API Demo

POST /api/project/ebay/seller-profile

Request cost is temporarily unavailable. No price is assumed.

View pricing

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>"}'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →