products_get

Read one local SKU with every field, every listing it is linked to and every supplier product it is bought as.

readSellerSheet

The two quantities are different: units_per_listing is how many of this SKU one sale of a listing takes; units_per_sku is how many of the supplier's units make one of this SKU.

Call it

In an AI client (MCP)

tools/call
{
  "name": "products_get",
  "arguments": {
    "store": "myStore-US",
    "sku": "<sku>"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/products_get \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","sku":"<sku>"}'
Early access — the Tool API is open on request, contact us.

Arguments

NameTypeDescription
skurequiredstringThe SKU code, compared ignoring case.
storestringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. Optional: it only names the organization to work in when your key reaches more than one. Default: the key's own organization.

Result

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

  • data.sku — Every field of the SKU, with sku_id and pieces (how many pieces the SKU itself contains, when set).
  • data.purchase — The 1688 variants this SKU is paired with: item_id, supplier, subject, variant, unit, units_per_sku, is_default. Empty unless you are an owner or admin of an organization that uses 1688.
  • data.product — spu, name, kind, brand, category_path, status, tags.
  • data.links — link_id, channel, store, listing_sku, listing_id, units_per_listing, match, match_checked_on, in_latest_report, fnsku, fnsku_source, platform_holds_stock, status, linked_at.
  • data.suggestions — store, listing_sku, listing_id of listings whose SKU equals this code and that no SKU holds.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude