eBay Feedback API Users Guide
When eBay sellers provide service that consistently results in a high level of buyer satisfaction, everybody in the marketplace benefits. One of the ways eBay monitors and preserves buyer satisfaction is through detailed seller ratings (DSRs). In addition to leaving an overall Feedback rating (positive, neutral, or negative) for a seller, buyers can also leave detailed seller ratings. The eBay Feedback API provides developers a means to monitor account-level Feedback data, specifically DSRs, easily.
This Users Guide provides the following information to help you get started with the Feedback API:
The Feedback Service generates DSR summary reports for sellers based on a variety of criteria, such as time period, listing category, transaction information, or specific shipping details. DSR summary reports contain, for each DSR category, an average score, the quantity of ratings left for each rating value, and a total quantity of ratings left. This information can help sellers determine how specific business practices may be contributing to higher or lower DSR scores.
The Feedback Service uses an asynchronous programming model. There are "create" calls for specifying the criteria for generating the reports and a single "get" call, getDSRSummary, to retrieve the generated reports. The reports take too much time to generate to return them in the response of the create calls. The response for the create calls contains a job ID, which is used as input for the get call to check completion status and/or to retrieve the DSR summary report.
Refer to the eBay Feedback API API Reference for a list of API calls and the associated inputs and outputs for each.
|Note: Currently, this service offers APIs for managing DSR data only. For other Feedback related operations, such as leaving and retrieving Feedback, please refer to the GetFeedback and the LeaveFeedback calls in the Trading API.
Back to top
The eBay Feedback API can be used with other eBay APIs to improve selling applications. The information returned by the service can also help sellers monitor and improve their selling strategies.
See the following eBay Help pages for more information about DSRs and how they affect sellers:
Track DSR Trends
Developers are encouraged to provide tools that will let sellers monitor DSR trends over time:
Since the Feedback API will accept queries for DSR data up to 16 months ago, reports can be generated to compare year to year DSR scores for a given time period, such as a month or a quarter.
Optimize Your Selling Strategy
Developers are encouraged to provide tools that will enable sellers to select the filter criteria that are most important to them and that will help them figure out their DSR strengths and weaknesses.
Here are some examples of filter criteria that can be used with the Feedback API:
- Transaction period (createDSRSummaryByPeriod)—weekly, monthly, weekdays, weekends, etc.
- Categories (createDSRSummaryByCategory)—music, DVDs, collectibles, etc.
- Shipping details (createDSRSummaryByShippingDetails):
- Shipping destination—regional (by country), domestic, or international
- Shipping services—USPS, UPS, etc. (requires valid shipping service name)
- Shipping charges—free shipping, discounted shipping, etc.
- Other criteria that can be mapped to transactions (createDSRSummaryByTransaction):
- Customer support by employee, which could affect the Communication DSR
- View Item template used, which could affect the Item As Described DSR
- Item shipping/handling by employee, which could affect the Shipping Time DSR
- Item Condition—new, used, slightly used, etc., which could affect the Item As Described DSR
Because sellers can generate reports by specifying a list of transaction IDs and item IDs, there is no limit to the ways they can filter their DSR data.
|Note: If an item goes through a third-party checkout flow, eBay may not have accurate or complete information for some aspects of the sold item. For example, the shipping service selected, the shipping and handling charges associated with the transaction, or the destination to which the item was shipped may not be available. The queries or filters you use to create a DSR summary report must be based on data available to eBay.
Combining with Other eBay APIs
The Feedback API can be used in conjunction with any of the eBay APIs. We recommend you try using the Feedback API together with one or more of the following APIs.
eBay Trading API
eBay Trading API offer authenticated access to private eBay data to enable automation and innovation in the areas of listing items, retrieving seller sales status, managing post-transaction fulfillment, and accessing private user information such as My eBay and Feedback details.
Sellers can use GetSellerTransactions to retrieve the transaction information, such as transaction IDs and item IDs, needed as input for the calls to create DSR summary reports. As sellers adjust their selling practices, they may make changes to the way they list or communicate with buyers.
Research API for eBay (powered by DataUnison)
Although the research APIs are not directly related to managing seller feedback, they provide a variety of data sellers can use to analyze their selling practices and stay competitive. The Research API for eBay retrieves historical eBay data. Visit the DataUnison site for more information about their product offerings.
Additional eBay APIs
See the Products page to learn more about eBay APIs products and upcoming product releases and feature enhancements.
Back to top
Working with the Feedback API
The Feedback API is simple and easy to use. This section outlines the fundamentals of how to use the Feedback API.
See Making an API Call for information about how to construct and submit a Feedback API call. Refer to the API Reference for details about the API structure and logic.
The Feedback API requires a seller's user token to ensure DSR data is kept secure. The user token is passed in the
X-EBAY-SOA-SECURITY-TOKEN HTTP header.
API Call Limits
To manage capacity for the Feedback Service, a maximum of 10 DSR query requests (e.g., createDSRSummaryByCategory) are allowed per seller (based on user token) per calendar day. If an application meets this limit, subsequent request will fail.
DSRs are left anonymously by buyers. To preserve this anonymity, reports will be generated only if there are at least 10 DRSs available for the specified criteria (e.g., category ID, transaction key array, or date range).
Note the following details for retrieving summary reports:
- Generation time—reports typically take 1 hour or less to generate and will take no longer than a day to create.
- Retention—reports will be held up to 7 days after being generated. The report can be retrieved multiple times during that period. If you do not download a report within 7 days, you must regenerate the report.
The Feedback Service is not currently supported in the eBay Sandbox environment. However, for the Feedback API, the Production environment is preferred for testing, because the Production environment has pertinent data and the Feedback DSR calls do not alter item or user data.
The following abuses of the Feedback API constitute eBay policy violations:
- Bypassing DSR anonymity—submitting queries with the purpose of exposing individual DSR ratings left for a specific transaction is prohibited.
- Aggregating DSR scores across multiple sellers—accumulating DSR averages across multiple sellers for the purpose of comparison is prohibited. For example, producing a report that compares DSR averages for sellers who sell in the same category is not allowed.
For more information about eBay policies, refer to the following eBay documents:
Refer to the API Reference for a list of calls in the Feedback API. The API Reference includes the following information:
- Prototypes of the request and response structure for each call
- Comprehensive list of inputs and outputs supported by each call and descriptions of their meaning and behavior
- Call samples (request and response)
- Index of schema elements (types, fields, enumerations)
- Change history information for each call
Back to top
You can get more information about the eBay Feedback API at these locations:
Back to top
Copyright © 2008–2015 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.