Skip to content

Tools & Home Improvement category available in Feeds API is missing in SP-API Product Type definitions #5081

@coderpang

Description

@coderpang

Hi team,

We found an inconsistency between the legacy Feeds API and the SP-API product definition endpoints.

🧩 Background

In the legacy Feeds API, we could successfully use the category Tools & Home Improvement when submitting feeds (e.g., product uploads).

However, when using the SP-API Search / Product Type definition endpoints (such as /definitions/2020-09-01/productTypes or the newer searchDefinitionsProductTypes), there is no corresponding ProductType that matches the semantic meaning of Tools & Home Improvement.

❓ Issue

  • The category name Tools & Home Improvement appears in legacy API usage and in Amazon Seller Central UI.
  • But in the SP-API product type definitions, there is no top-level ProductType entry with that name or equivalent.
  • It makes it difficult to determine what ProductType developers should use when they want to list under Tools & Home Improvement—especially for items that clearly belong to that category.

🔍 Example

A developer might expect to find something like:

"TOOLS_AND_HOME_IMPROVEMENT"

or multiple ProductTypes clearly grouped under Tools & Home Improvement semantics.

But instead, the available ProductTypes from the SP-API definitions do not include this, and relevant tooling docs/examples don’t address this gap.

❗ Impact

  • API clients cannot reliably map listings that were previously categorized as Tools & Home Improvement via Feeds API to an SP-API ProductType.
  • It increases developer confusion and complicates integration workflows, especially for category-specific tooling or validation.

📌 Questions

  1. Is there a reason why Tools & Home Improvement is not present in the SP-API product types?
  2. Should developers instead map to multiple lower-level ProductTypes (e.g., tools, hardware, electrical, etc.)?
  3. If so, is there official guidance or a canonical mapping for Feeds categories → SP-API ProductTypes?

Thank you for your help!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions