productTypeDefinitions_searchDefinitionsProductTypes
Search for Amazon product types that have definitions available.
readAmazon Seller (SP-API)sp.definitionsProductTypes_2020-09-01
Amazon SP-API · searchDefinitionsProductTypes · GET /definitions/2020-09-01/productTypes Use this to find the correct productType string before calling listings_putListingsItem. Cannot use both keywords and item_name in the same call.
Call it
In an AI client (MCP)
{
"name": "productTypeDefinitions_searchDefinitionsProductTypes",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/productTypeDefinitions_searchDefinitionsProductTypes \
-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
| 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. |
keywords | object[] | List of keywords to search, e.g. ['luggage', 'suitcase']. Cannot combine with item_name. |
item_name | string | Product title for recommendation. Cannot combine with keywords. |
locale | string | locale of the display names; defaults to the marketplace's primary locale. |
search_locale | string | language of keywords or item_name; defaults to the marketplace's primary locale. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.productTypes— list of product type objects, each with: - name: the productType string to use in listings_putListingsItem - displayName: human-readable name - marketplaceIds: supported marketplaces
Workflow
- 1. Search by keywords or by item_name (never both). 2. Pick the most specific data.productTypes[].name. 3. productTypeDefinitions_getDefinitionsProductType for its schema, or listings_prepare_publish_queue_template to build sheet columns.