feeds_getFeeds

List/filter your recent feeds (getFeeds).

readAmazon Seller (SP-API)sp.feeds_2021-06-30

Read-only. Amazon SP-API · getFeeds · GET /feeds/2021-06-30/feeds Use this to find feedIds you didn't record, or to audit recent submissions and their statuses. Marketplace is derived server-side from the store — you do NOT pass a marketplace. Feeds are retained for 90 days.

Call it

In an AI client (MCP)

tools/call
{
  "name": "feeds_getFeeds",
  "arguments": {
    "store": "myStore-US"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/feeds_getFeeds \
  -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

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
feedTypesobject[]required unless paginating with nextToken — 1–10 Amazon feed-type strings, e.g. ['JSON_LISTINGS_FEED']. Amazon REJECTS a getFeeds call with neither feedTypes nor nextToken ("required parameters missing: feedTypes"). Full list: https://developer-docs.amazon.com/sp-api/docs/feed-type-values
processingStatusesstring[]optional list of statuses to filter by. Allowed: CANCELLED | DONE | FATAL | IN_PROGRESS | IN_QUEUE.CANCELLEDDONEFATALIN_PROGRESSIN_QUEUE
pageSizeinteger · 1–100max feeds to return, 1–100 (Amazon default 10).
createdSincestring · date-timeISO-8601 lower bound on feed creation. Default 90 days ago (feeds older than 90 days are purged).
createdUntilstring · date-timeISO-8601 upper bound. Default now.
nextTokenstringthe cursor from the previous call's data.nextToken; omit for the first page.

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.feeds — list of {feedId, feedType, marketplaceIds, createdTime, processingStatus, processingStartTime, processingEndTime, resultFeedDocumentId}.
  • data.count — number of feeds in this page.
  • data.nextToken — cursor — if present, call feeds_getFeeds again with ONLY this.

Workflow

  • 1. First call: pass your filters (feedTypes / processingStatuses / dates). 2. If data.nextToken is set, call again with ONLY nextToken and NOTHING else — Amazon REJECTS nextToken combined with any other filter. 3. Repeat until data.nextToken is null.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude