listings_parse_asin_to_cells
Convenience: fetch an ASIN's catalog attributes from Amazon and return flat, operator-readable cell values.
readAmazon Seller (SP-API)sp.catalogItems_2022-04-01
Keys are Amazon's flat-file keys, as listings_prepare_publish_queue_template writes them. For several ASINs use listings_fetch_attributes_by_asins (one call); to edit a listing you own, fetch by SKU (listings_fetch_attributes_by_skus) — an ASIN returns Amazon's merged catalog values, not what you submitted. Amazon SP-API · getCatalogItem · GET /catalog/2022-04-01/items/{asin} Amazon SP-API · getDefinitionsProductType · GET /definitions/2020-09-01/productTypes/{productType} If productType is omitted, the catalog response's productTypes entry matching the store marketplace (else the first) is used as the inferred productType.
Call it
In an AI client (MCP)
{
"name": "listings_parse_asin_to_cells",
"arguments": {
"store": "myStore-US",
"asin": "<asin>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/listings_parse_asin_to_cells \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","asin":"<asin>"}'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. |
asinrequired | string | the ASIN (e.g. 'B0XXXXXXXX'). |
productType | string | Optional explicit Amazon productType. When omitted it is inferred from the catalog response's productTypes. |
locale | string | Schema/catalog locale passed to getCatalogItem + getDefinitionsProductType. Defaults to the marketplace's default locale. Allowed: DEFAULT | ar | ar_AE | de | de_DE | en | en_AE | en_AU | en_CA | en_GB | en_IN | en_SG | en_US | es | es_ES | es_MX | es_US | fr | fr_CA | fr_FR | it | it_IT | ja | ja_JP | nl | nl_NL | pl | pl_PL | pt | pt_BR | pt_PT | sv | sv_SE | tr | tr_TR | zh | zh_CN | zh_TW.DEFAULTarar_AEdede_DEenen_AEen_AUen_CAen_GBen_INen_SGen_USeses_ESes_MXes_USfrfr_CAfr_FRitit_ITjaja_JPnlnl_NLplpl_PLptpt_BRpt_PTsvsv_SEtrtr_TRzhzh_CNzh_TW |
language_tag | string | the one language kept; defaults to the marketplace's primary listing locale. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.attributes— {key: cell_string} — the flat-file key grammar.data.names— {key: display_name} — a NEW key's display name.data.dropped_entries— {attr: sentence} — entries skipped for a foreign marketplace/language, one plain-English sentence per attribute.data.productType— the productType used (provided or inferred)data.notes— [] normally; one sentence when the product-type schema could not be served and the cells were typed from the JSON alone.
Params (Amazon schema; getCatalogItem)
asin*: string
marketplaceIds*: [string]
includedData: attributes | classifications | dimensions | identifiers | images | productTypes | relationships | salesRanks | summaries | vendorDetails (list)
locale: stringParams (Amazon schema; getDefinitionsProductType)
productType*: string
sellerId: string
marketplaceIds*: [string]
productTypeVersion: string
requirements: LISTING | LISTING_PRODUCT_ONLY | LISTING_OFFER_ONLY
requirementsEnforced: ENFORCED | NOT_ENFORCED
locale: DEFAULT | ar | ar_AE | de | … | zh_TW (38 values)
parentageLevel: NONE | CHILD | PARENT