# listings_searchListingsItems (https://sellersheetai.com/docs/mcp-api/tools/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 

Access: **READ** · toolset amazon_sp · family 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

MCP tool call:

```json
{
  "name": "listings_searchListingsItems",
  "arguments": {
    "store": "myStore-US"
  }
}
```

Tool API (early access — contact us):

```bash
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"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `store` | string | yes | 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. Allowed: summaries \| attributes \| issues \| offers \| fulfillmentAvailability \| procurement \| relationships \| productTypes. |
| `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. Allowed: ASIN \| EAN \| FNSKU \| GTIN \| ISBN \| JAN \| MINSAN \| SKU \| UPC. |
| `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. Allowed: WARNING \| ERROR. |
| `with_status` | string[] |  | keep listings in these statuses. BUYABLE is not valid for vendor listings (400 'Unsupported Status Requested') — use DISCOVERABLE or omit it. Allowed: BUYABLE \| DISCOVERABLE. |
| `without_status` | string[] |  | exclude listings in these statuses. Allowed: BUYABLE \| DISCOVERABLE. Allowed: BUYABLE \| DISCOVERABLE. |
| `sort_by` | string |  | the field the page is ordered by. Default: lastUpdatedDate. Allowed: sku \| createdDate \| lastUpdatedDate. Allowed: sku \| createdDate \| lastUpdatedDate. |
| `sort_order` | string |  | ASC or DESC. Default: DESC. Allowed: ASC \| DESC. |
| `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

- `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.