Skip to main content

The Feedback API includes resources for retrieving items awaiting feedback, retrieving and submitting feedback entries, providing feedback rating summaries, and responding to feedback. These methods allow users to manage feedback across buying and selling activities.

For more information about using RESTful APIs, see Using eBay Restful APIs.

Technical overview

This API allows third-party developers to retrieve and respond as well as provide feedback for buyers and sellers. The API supports filtered and sorted retrieval of feedback, offering options to order results by relevance or date, and provides privacy masking for buyer or seller identities based on login status. Aggregated metrics are also available for detailed performance analysis.

Methods

The methods in the Feedback API, arranged by resources, are as follows:

awaiting_feedback

  • getItemsAwaitingFeedback: This method retrieves a filtered list of line items for which feedback is pending from the user based on their role.

feedback

  • getFeedback: This method retrieves a filtered list of line items for which feedback is available from the user based on their role.

  • leaveFeedback: This method submits feedback associated with a line item for an order partner, generating a unique ID for tracking and reference purposes

feedback_rating_summary

  • getFeedbackRatingSummary: This method returns a categorized summary of feedback metrics for an eBay seller, filtered by criteria.

respond_to_feedback

  • respondToFeedback: This method responds to feedback provided by the order partner on a specific line item in an order.

Primary fields

The following primary fields are used across multiple resources.

Primary fields in other resources are listed by resource below.

awaiting_feedback

  • filter: This query parameter limits the response based on the specified filter parameters such as by the specific listing ID, the user's name involved in the transaction, or the role of the user providing feedback and is used in the getItemsAwaitingFeedback method.

feedback

  • feedbackId: This parameter is returned by the leaveFeedback method, and is required for the respondToFeedback method.

  • listing_id: Used as a query parameter to narrow the results for the getFeedback method.

  • order_line_item_id: Use this field to retrieve specific feedback entries related to an order line item ID.

  • userId: This field indicates the unique identifier of the user who gave the feedback and is retrieved in the response of the getFeedback method.

  • user_id: Used as a query parameter to narrow the results for the getFeedback method.

  • transaction_id: This field is used as a query parameter to narrow results to those associated with the specified transaction ID for the getFeedback method.

feedback_rating_summary

  • feedbackMetrics: This array contains aggregated feedback in metricName and metricValue fields in the response of the getFeedbackRatingSummary method.

respond_to_feedback

Business use cases

Sellers and buyers can use the Feedback API to manage feedback across buying and selling activities. The following list outlines the high-level use cases addressed by the Feedback API. See Handling feedback for details.

  • Get items awaiting feedback

  • Retrieve feedback

  • Retrieve AI-filtered feedback

  • Leave feedback

  • Get feedback rating summary

  • Respond to feedback received

  • Using rating templates