Skip to main content

List Listings

GET 
/api/v2/listings

Returns a paginated list of channel listings (products listed on sales channels).

Required scope: products:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token.

Channel state. Every row carries remote_status (the reconciled channel-side state) plus its channel-agnostic reading: remote_status_label ("Live", "Publishing", "Ended on channel", "Unpublished on channel", "Rejected", "Removing", "Unknown"), remote_status_color, ended_on_channel (true when the channel no longer hosts the listing) and remote_status_reason (the channel's own explanation when it gave one, e.g. "This item is unpublished because the End Date has passed"). Filter with filter[remote_status]; missing finds every listing ended on its channel across all channels.

Amazon brand monitoring. Amazon listings of watched brand ASINs also carry the latest offer census: doc_amazon_offer_count (distinct sellers; null unless Competition monitoring is on for the brand), doc_amazon_offer_count_capped (Amazon returned its 20-offer maximum), doc_amazon_prime_offer_count, doc_amazon_fba_offer_count, doc_amazon_our_offer_present, doc_amazon_retail_present, doc_amazon_map_violation, doc_amazon_map_price, doc_amazon_lowest_price and doc_amazon_offer_observed_at. They are null for listings that are not watched. Filter with filter[doc_amazon_map_violation], filter[doc_amazon_retail_present], filter[doc_amazon_our_offer_present], or numerically on doc_amazon_offer_count, doc_amazon_prime_offer_count, doc_amazon_map_price and doc_amazon_lowest_price through filter_groups.

Request​

Responses​

OK