listings_searchListingsItems
Search and filter the seller's own listings catalog — the entry point for a suppressed-listing audit (with_issue_severity ['ERROR'] and included_data ['summaries', 'issues'], then
readAmazon Seller (SP-API)sp.listingsItems_2021-08-01
listings_patchListingsItem), an active-listing inventory (with_status ['BUYABLE']), an identifier lookup, a variation family (variation_parent_sku) or recent changes (last_updated_after with sort_by lastUpdatedDate). Paginated. Amazon SP-API · searchListingsItems · GET /listings/2021-08-01/items/{sellerId}
Call it
In an AI client (MCP)
{
"name": "listings_searchListingsItems",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/listings_searchListingsItems \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
included_data | string[] | datasets per item; default ['summaries']. issues carries the suppression reasons; procurement is vendor cost data. Allowed: summaries | attributes | issues | offers | fulfillmentAvailability | procurement | relationships | productTypes.summariesattributesissuesoffersfulfillmentAvailabilityprocurementrelationshipsproductTypes |
identifiers | object[] | up to 20 identifiers; requires identifiers_type. |
identifiers_type | string | the type of every value in identifiers; required with identifiers. Allowed: ASIN | EAN | FNSKU | GTIN | ISBN | JAN | MINSAN | SKU | UPC.ASINEANFNSKUGTINISBNJANMINSANSKUUPC |
variation_parent_sku | string | every variation child of this parent SKU. |
package_hierarchy_sku | string | listings that contain or are contained by this SKU. |
created_after | string · date-time | ISO 8601 datetimes, e.g. '2024-01-01T00:00:00Z'. |
created_before | string · date-time | ISO 8601 datetimes, e.g. '2024-01-01T00:00:00Z'. |
last_updated_after | string · date-time | ISO 8601 datetimes, e.g. '2024-01-01T00:00:00Z'. |
last_updated_before | string · date-time | ISO 8601 datetimes, e.g. '2024-01-01T00:00:00Z'. |
with_issue_severity | string[] | keep listings with issues of these severities (ERROR = suppressed); INFO is not a filter value. Allowed: WARNING | ERROR.WARNINGERROR |
with_status | string[] | keep listings in these statuses. BUYABLE is not valid for vendor listings (400 'Unsupported Status Requested') — use DISCOVERABLE or omit it.BUYABLEDISCOVERABLE |
without_status | string[] | exclude listings in these statuses. Allowed: BUYABLE | DISCOVERABLE.BUYABLEDISCOVERABLE |
sort_by | string | the field the page is ordered by. Default: lastUpdatedDate. Allowed: sku | createdDate | lastUpdatedDate.skucreatedDatelastUpdatedDate |
sort_order | string | ASC or DESC. Default: DESC.ASCDESC |
page_size | integer · –20 | results per page, 1–20 (default 10). |
page_token | string | data.pagination.nextToken from the previous page; omit for the first. |
issue_locale | string | locale of Amazon's issue messages (e.g. 'en_US'); defaults to the marketplace's primary language. |
seller_id | string | Vendor Central only — the vendor code (sellingParty.partyId from vendorOrders_getPurchaseOrders); omit on a seller account. A vendor account can hold several codes in one marketplace, each a separate catalog: group PO items by sellingParty.partyId and call once per group; a group that returns 0 items falls back to catalogItems_searchCatalogItems. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.items— [{sku, …the requested datasets}] — a vendor PO image is summaries[0].mainImage.link with included_data ['summaries', 'procurement'].data.numberOfResults— total matches across all pages; Amazon caps paging at 1,000 SKUs, so a larger count means the filter must be narrowed.data.pagination.nextToken— pass as page_token; absent on the last page.
Gotchas
- identifiers, variation_parent_sku and package_hierarchy_sku are mutually exclusive.