# View & search listings (https://sellersheetai.com/docs/mcp-api/workflows/listings-view)

> Search your whole catalog, find suppressed or errored listings, and pull everything into a Google Sheet for review — or look up any ASIN on Amazon.



<Callout title="In short">
  Ask for the listings you care about — by keyword, ASIN, SKU, status or issue — and your agent searches your catalog, explains what is wrong, and can write the list to a sheet for you to work through.
</Callout>

## In your daily workflow [#in-your-daily-workflow]

<Steps>
  <Step>
    ### Find listings with issues [#find-listings-with-issues]

    "Show me every listing that is suppressed or has warnings." `listings_searchListingsItems` filters your catalog by status and issue severity (ERROR means suppressed) and returns the reasons Amazon gives.
  </Step>

  <Step>
    ### Look closer at one SKU [#look-closer-at-one-sku]

    `listings_getListingsItem` returns what Amazon has on file for one SKU right now: attributes, offers, status and issues.
  </Step>

  <Step>
    ### Audit in bulk [#audit-in-bulk]

    `listings_fetch_attributes_by_skus` (your SKUs) and `listings_fetch_attributes_by_asins` (any ASIN) pull full attribute sets for a batch at once — the starting point for a side-by-side review in your sheet. See [Attributes & Publish Queue](/docs/mcp-api/workflows/listings-attributes).
  </Step>

  <Step>
    ### Look up any product on Amazon [#look-up-any-product-on-amazon]

    `catalogItems_searchCatalogItems` searches the Amazon catalog by keyword or identifier (ASIN, UPC, EAN); `catalogItems_getCatalogItem` returns the detail of one ASIN — competitors' included. `listings_getListingsRestrictions` tells you whether you may sell an ASIN, and in which condition.
  </Step>
</Steps>

## Try asking [#try-asking]

> "Show me all my listings that have issues or are suppressed."

> "Write them to a sheet, and show me the suppressed ones first."

Your agent lists each problem with Amazon's reason — a missing main image, a restricted category waiting for approval, a missing description — and writes the rows to the sheet you name.

## The search, both ways [#the-search-both-ways]

The same tool and the same arguments — through your AI client, or from your own code.

**MCP** — you ask: "Which of my listings are suppressed?" Your agent calls `listings_searchListingsItems` with an issue filter, pages through the results, and explains each one.

<ToolCall tool="listings_searchListingsItems" args="{ with_issue_severity: [&#x22;ERROR&#x22;], included_data: [&#x22;summaries&#x22;, &#x22;issues&#x22;] }" />

## Tools on this page [#tools-on-this-page]

Pulled from the catalog at build time, each with its own access label.

<ToolList tools="[&#x22;listings_searchListingsItems&#x22;, &#x22;listings_getListingsItem&#x22;, &#x22;listings_fetch_attributes_by_skus&#x22;, &#x22;listings_fetch_attributes_by_asins&#x22;, &#x22;catalogItems_searchCatalogItems&#x22;, &#x22;catalogItems_getCatalogItem&#x22;, &#x22;listings_getListingsRestrictions&#x22;]" />

## FAQ [#faq]

### How does my agent get past the first page? [#how-does-my-agent-get-past-the-first-page]

It passes the page token from each result into the next call. See [Paging](/docs/mcp-api/paging).

### Found the problem — how do I fix it? [#found-the-problem--how-do-i-fix-it]

Edit the attributes in a Publish Queue sheet and submit them — see [Attributes & Publish Queue](/docs/mcp-api/workflows/listings-attributes) — or ask your agent to change one attribute with a patch ([Create listings](/docs/mcp-api/workflows/listings-create)).
