My Account

New: Customer favorite filtering for unpublished items

Date: July 30, 2026

The isCustomerFavorite query parameter has been added to to the GET Unpublished Items API. You can now filter unpublished items by customer favorite status and identify high-demand items that may need attention.

What changed

  • Added the optional isCustomerFavorite query parameter.
  • Set isCustomerFavorite=true to return only customer favorite items.
  • Set isCustomerFavorite=false to return only items that are not customer favorites.
  • Omit the parameter to return all unpublished items.
  • Added isCustomerFavorite to each item in the response to indicate its customer favorite status.

Scope

This update applies to the GET Unpublished Items endpoint:

GET /v3/insights/items/unpublished/items

The isCustomerFavorite parameter is available for the US market only.

Why it matters

Filtering by customer favorite status helps you prioritize unpublished items with demonstrated customer demand. This can make it easier to identify important listings, resolve publication issues, and restore potentially valuable offers.

Next steps

  • Add the optional isCustomerFavorite query parameter when you need to filter unpublished items by customer favorite status.
  • Update response parsers to read the isCustomerFavorite Boolean field.
  • No action is required to continue receiving all unpublished items.
  • Learn more by reading the Insights API documentation.