Amazon Category Name Search

1 credits/call
ae_amazon_category_name_search

Find Amazon sub-categories by name and retrieve the NodeID and Name of matching categories. Provide category_name; optionally set amz_site to a supported marketplace code. If omitted, amz_site defaults to "Unknow". Useful for identifying category nodes from a category name.

Productivity
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Provide a category name to find matching Amazon subcategories and their NodeID and Name. The marketplace is optional and defaults to "Unknow"; use a supported marketplace code when specifying one.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site. Unknow
category_namestringYesThe name of the category market to query.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amazon_category_name_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "amz_site": "US",
    "category_name": "cargo box"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "category_name": "Trunk Organizers",
      "node_id": "318295011"
    }
  ],
  "doc": {
    "category_name": "Sub-category name.",
    "node_id": "Sub-category NodeID, used as input for subsequent category-scoped queries."
  }
}

This example shows part of the response. Copied content is valid JSON.