Search categories by keyword or ASIN
Matching categories, IDs, hierarchy, paths, and availability by keyword or ASIN.
Tools
Category insight
Study category demand, keyword concentration, product distribution, and competitive movement.
Category Insight resources
2 toolsToolNameData provided
generate_category_insight_resource
Generate a Category Insight resource
Tool description
Generate an insight resource for the confirmed marketplace and category. Waits internally for up to 5 minutes and automatically rebuilds failed resources. Every independently successful call costs 500 Credits, including an existing-resource hit. Reuse resourceId for subsequent queries in the same task.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
Response
A resource ID for subsequent category analysis; reuse it within the same task.
Billing rules
500 Credits per successful call, including existing resources
1 calls → 500 Credits
Generate a Category Insight resource
An asynchronously generated Category Insight resource and resource ID.
Category rankings
3 toolsToolNameData provided
get_category_sales_ranking
Category sales ranking
Tool description
Retrieve sales rankings aggregated by primaryAsin. reportPeriod is required: YYYY-MM for a full calendar month, YYYY for a full calendar year, or last30days / last12months. Supports brand, range, search, sorting and pagination filters. Costs 5 Credits per 5 representative ASINs returned, rounded up.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
reportPeriod | string | Yes | Required reporting period: YYYY-MM for a complete calendar month, YYYY for a complete calendar year, or last30days / last12months. Uses the marketplace time zone. Daily dates, date ranges and cycleFilter are not accepted. A calendar year always runs January 1 to December 31; the current year is not automatically truncated. |
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | No | Brand or relevance filters. |
filters.brands | string[] | No | List of brands to query. |
orders | object[] | No | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Yes | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Yes | Sort field. |
page | integer | No | Page number; default: 1. |
pageSize | integer | No | Page size; default: 20. |
query | string | No | Search term for the list; omitted means no text filter. |
rangeFilters | object | No | Ranges on the same field are combined with OR; different fields use AND. Each range requires at least one bound and min ≤ max. Omitted bounds are unlimited. Put both bounds of one range in the same item, for example [{"min":10,"max":20}]. Separate items form a union. See each field for boundary inclusion. Listing age uses streetDays; no legacy streetSince default filter applies. |
rangeFilters.height | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | No | Upper bound. |
rangeFilters.height[].min | integer | No | Lower bound. |
rangeFilters.length | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | No | Upper bound. |
rangeFilters.length[].min | integer | No | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | No | Upper bound. |
rangeFilters.ratings[].min | integer | No | Lower bound. |
rangeFilters.revenue | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | No | Upper bound. |
rangeFilters.sales[].min | integer | No | Lower bound. |
rangeFilters.salesMom | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.streetDays[].max | integer | No | Upper bound. |
rangeFilters.streetDays[].min | integer | No | Lower bound. |
rangeFilters.trafficScore | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | No | Upper bound. |
rangeFilters.trafficScore[].min | integer | No | Lower bound. |
rangeFilters.weight | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | No | Upper bound. |
rangeFilters.weight[].min | integer | No | Lower bound. |
rangeFilters.width | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | No | Upper bound. |
rangeFilters.width[].min | integer | No | Lower bound. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Sales rankings aggregated by representative ASIN, with brand, range, sorting, search and pagination controls.
Billing rules
5 Credits × ⌈representative ASINs returned / 5⌉ (rounded up)
12 representative ASINs → 15 Credits
Category sales ranking
Representative ASIN rankings with sales, revenue, price and ratings; filter by reporting period.
get_category_new_release_ranking
Category new-release ranking
Tool description
Retrieve new-release rankings. reportPeriod is required: YYYY-MM, YYYY, last30days or last12months. There is no default listing-age limit. Omitting rangeFilters.streetDays retains all active candidates, which are not necessarily new releases. Set the age range explicitly for the user's goal. Costs 5 Credits per 5 representative ASINs.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
reportPeriod | string | Yes | Required reporting period: YYYY-MM for a complete calendar month, YYYY for a complete calendar year, or last30days / last12months. Uses the marketplace time zone. Daily dates, date ranges and cycleFilter are not accepted. A calendar year always runs January 1 to December 31; the current year is not automatically truncated. |
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | No | Brand or relevance filters. |
filters.brands | string[] | No | List of brands to query. |
orders | object[] | No | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Yes | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Yes | Sort field. |
page | integer | No | Page number; default: 1. |
pageSize | integer | No | Page size; default: 20. |
query | string | No | Search term for the list; omitted means no text filter. |
rangeFilters | object | No | Ranges on the same field are combined with OR; different fields use AND. Each range requires at least one bound and min ≤ max. Omitted bounds are unlimited. Put both bounds of one range in the same item, for example [{"min":10,"max":20}]. Separate items form a union. See each field for boundary inclusion. Listing age uses streetDays; no legacy streetSince default filter applies. |
rangeFilters.height | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | No | Upper bound. |
rangeFilters.height[].min | integer | No | Lower bound. |
rangeFilters.length | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | No | Upper bound. |
rangeFilters.length[].min | integer | No | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | No | Upper bound. |
rangeFilters.ratings[].min | integer | No | Lower bound. |
rangeFilters.revenue | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | No | Upper bound. |
rangeFilters.sales[].min | integer | No | Lower bound. |
rangeFilters.salesMom | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | No | Half-open range [min,max). No default listing-age limit applies to new-release rankings. If omitted, all active candidates remain and are not necessarily new releases. Explicitly set the age range for the user's goal. |
rangeFilters.streetDays[].max | integer | No | Upper bound. |
rangeFilters.streetDays[].min | integer | No | Lower bound. |
rangeFilters.trafficScore | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | No | Upper bound. |
rangeFilters.trafficScore[].min | integer | No | Lower bound. |
rangeFilters.weight | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | No | Upper bound. |
rangeFilters.weight[].min | integer | No | Lower bound. |
rangeFilters.width | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | No | Upper bound. |
rangeFilters.width[].min | integer | No | Lower bound. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Rankings filtered by listing age. An explicit age range is required to restrict results to new releases.
Billing rules
5 Credits × ⌈representative ASINs returned / 5⌉ (rounded up)
12 representative ASINs → 15 Credits
Category new-release ranking
Representative ASIN rankings with sales, revenue, price and ratings; filter by reporting period.
get_category_surging_ranking
Category growth ranking
Tool description
Retrieve growth rankings using the current growth, filter and sorting rules. reportPeriod is required: YYYY-MM, YYYY, last30days or last12months. Costs 5 Credits per 5 representative ASINs.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
reportPeriod | string | Yes | Required reporting period: YYYY-MM for a complete calendar month, YYYY for a complete calendar year, or last30days / last12months. Uses the marketplace time zone. Daily dates, date ranges and cycleFilter are not accepted. A calendar year always runs January 1 to December 31; the current year is not automatically truncated. |
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | No | Brand or relevance filters. |
filters.brands | string[] | No | List of brands to query. |
orders | object[] | No | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Yes | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Yes | Sort field. |
page | integer | No | Page number; default: 1. |
pageSize | integer | No | Page size; default: 20. |
query | string | No | Search term for the list; omitted means no text filter. |
rangeFilters | object | No | Ranges on the same field are combined with OR; different fields use AND. Each range requires at least one bound and min ≤ max. Omitted bounds are unlimited. Put both bounds of one range in the same item, for example [{"min":10,"max":20}]. Separate items form a union. See each field for boundary inclusion. Listing age uses streetDays; no legacy streetSince default filter applies. |
rangeFilters.height | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | No | Upper bound. |
rangeFilters.height[].min | integer | No | Lower bound. |
rangeFilters.length | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | No | Upper bound. |
rangeFilters.length[].min | integer | No | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | No | Upper bound. |
rangeFilters.ratings[].min | integer | No | Lower bound. |
rangeFilters.revenue | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | No | Upper bound. |
rangeFilters.sales[].min | integer | No | Lower bound. |
rangeFilters.salesMom | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | No | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.streetDays[].max | integer | No | Upper bound. |
rangeFilters.streetDays[].min | integer | No | Lower bound. |
rangeFilters.trafficScore | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | No | Upper bound. |
rangeFilters.trafficScore[].min | integer | No | Lower bound. |
rangeFilters.weight | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | No | Upper bound. |
rangeFilters.weight[].min | integer | No | Lower bound. |
rangeFilters.width | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | No | Upper bound. |
rangeFilters.width[].min | integer | No | Lower bound. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Representative ASIN rankings using the current growth, filter and sorting rules.
Billing rules
5 Credits × ⌈representative ASINs returned / 5⌉ (rounded up)
12 representative ASINs → 15 Credits
Category growth ranking
Representative ASIN rankings with sales, revenue, price and ratings; filter by reporting period.
Category keyword analysis
2 toolsToolNameData provided
get_category_keyword_analysis
Category keyword analysis
Tool description
Retrieve keyword summary, distribution and full historical trends for the selected calendar month and relevance. If cycleFilter or startDate is omitted, uses the latest available keyword month for the marketplace; explicit months cannot be later. Only monthly is supported. correlationType is required. Costs 5 Credits per call; included trends incur no extra charge.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
correlationType | "high" | "medium" | "low" | Yes | Keyword relevance. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | No | One calendar month only. If cycleFilter or startDate is omitted, uses the latest available keyword month for the marketplace. An explicit month cannot be later. cycle defaults to monthly. endDate requires an explicit startDate in the same month; results are not sliced by day. period is unsupported. Included trends retain full history. Dates are marketplace-local YYYY-MM-DD. |
cycleFilter.cycle | "monthly" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Summary, distribution and complete historical trends for the selected calendar month and relevance.
Billing rules
5 Credits per successful call
1 keywords → 5 Credits
Category keyword analysis
Keyword-analysis summary for a category, month, and relevance level.
get_category_keywords
Category keyword list
Tool description
Retrieve category keywords for one calendar month. If cycleFilter or startDate is omitted, uses the marketplace's latest available keyword month; explicit months cannot be later. Only monthly is supported. Supports relevance, brand, range, search and pagination filters. Full historical trends are included by default; use includeTrend=false to omit them. Costs 1 Credit per 20 keywords returned.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | No | One calendar month only. If cycleFilter or startDate is omitted, uses the latest available keyword month for the marketplace. An explicit month cannot be later. cycle defaults to monthly. endDate requires an explicit startDate in the same month; results are not sliced by day. period is unsupported. Included trends retain full history. Dates are marketplace-local YYYY-MM-DD. |
cycleFilter.cycle | "monthly" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
filters | object | No | Brand or relevance filters. |
filters.brands | string[] | No | List of brands to query. |
filters.correlationTypes | "high" | "medium" | "low"[] | No | Keyword relevance filter. |
includeTrend | boolean | No | Include complete historical trends; default: true. |
page | integer | No | Page number; default: 1. |
pageSize | integer | No | Page size; default: 20. |
query | string | No | Search term for the list; omitted means no text filter. |
rangeFilters | object | No | Ranges on the same field use OR; different fields use AND. Each range needs at least one bound and min ≤ max. Omitted bounds are unlimited. Put both bounds in one item for a continuous range. Separate items form a union. See each field for boundary inclusion. All keyword range bounds must be non-negative (≥0). |
rangeFilters.adjustedClickConversionRate | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.adjustedClickConversionRate[].max | string | No | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.adjustedClickConversionRate[].min | string | No | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.cpc | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.cpc[].max | string | No | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.cpc[].min | string | No | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.organicRotationRate | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicRotationRate[].max | string | No | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.organicRotationRate[].min | string | No | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.searchFrequencyRank | object[] | No | Closed range [min,max]: includes both bounds. |
rangeFilters.searchFrequencyRank[].max | integer | No | Upper bound. |
rangeFilters.searchFrequencyRank[].min | integer | No | Lower bound. |
rangeFilters.searchTermCompetitiveDifficulty | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.searchTermCompetitiveDifficulty[].max | integer | No | Upper bound. |
rangeFilters.searchTermCompetitiveDifficulty[].min | integer | No | Lower bound. |
rangeFilters.searchVolume | object[] | No | Half-open range [min,max): includes min, excludes max. |
rangeFilters.searchVolume[].max | integer | No | Upper bound. |
rangeFilters.searchVolume[].min | integer | No | Lower bound. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Keyword lists with relevance, brand, range and search filters. Complete historical trends are included by default and can be disabled.
Billing rules
1 Credits × ⌈keywords returned / 20⌉ (rounded up)
45 keywords cost 3 Credits
Category keyword list
Monthly category keyword list, relevance, and numeric metrics.
Category market trends
4 toolsToolNameData provided
get_category_market_size_trends
Category market-size trends
Tool description
Retrieve complete historical monthly sales trends across all price bands and the available last-30-day summary. Start/end month filters are not accepted. Costs 5 Credits per 6 historical months; the last 30 days incur no additional charge.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Complete historical monthly sales trends across all price bands and the available last-30-day summary. Start/end month filters are not accepted.
Billing rules
5 Credits × ⌈historical months / 6⌉ (rounded up)
24 months → 20 Credits
Category market-size trends
Monthly category unit sales and revenue trends.
get_category_seasonality
Category seasonality
Tool description
Analyze category seasonality using peak/off-season sales comparisons and forecasts. Costs 5 Credits per successful call.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Category seasonality, peak/off-season sales comparisons and demand forecasts.
Billing rules
5 Credits per successful call
1 calls → 5 Credits
Category seasonality
Season definitions, peak/off-peak sales comparison, and a three-month forecast.
get_category_new_release_opportunity_trends
New versus existing product trends
Tool description
Retrieve complete new-release opportunity analysis, including summary, list, full trends and periods. Costs 5 Credits per 6 months of trends; included lists and periods incur no additional charge.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Yes | For monthly, startDate is required and optional endDate must be in the same month. Alternatively, use period=last30days with cycle omitted or daily, and no dates. |
cycleFilter.cycle | "monthly" | "daily" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | No | Rolling period. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | No | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
New-release opportunity summary, list, complete trends and periods.
Billing rules
5 Credits × ⌈historical months / 6⌉ (rounded up)
24 months → 20 Credits
New versus existing product trends
New versus existing product sales and product-count trends.
get_category_price_segment_trends
Price-segment market trends
Tool description
Retrieve complete analysis and trends for low, mid and high price bands together, including selected-period price boundaries, brands, representative ASINs, ratings and finer price ranges. Historical trends do not include month-by-month price boundaries. Costs 5 Credits per 6 distinct months across all three bands.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Yes | One calendar month with cycle=monthly and both startDate/endDate, or period=last30days without dates. |
cycleFilter.cycle | "monthly" | "daily" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | No | Rolling period. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Complete analysis and trends for low, mid and high price bands, including selected-period boundaries, brands, representative ASINs, ratings and finer price ranges.
Billing rules
5 Credits × ⌈historical months / 6⌉ (rounded up)
24 months → 20 Credits
Price-segment market trends
Monthly unit sales and revenue trends by price segment.
Category competition
4 toolsToolNameData provided
get_primary_asin_children
Representative ASIN children
Tool description
Retrieve child ASINs and complete sales trends for one representative ASIN, with period, price-band and pagination controls. Costs 5 Credits per 20 child ASINs returned.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Yes | Monthly/yearly rankings require cycle=monthly/yearly and startDate/endDate within the same calendar month/year. Alternatively, supply only period=last30days/last12months. Dates are marketplace-local YYYY-MM-DD. |
cycleFilter.cycle | "monthly" | "yearly" | "daily" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | "last12months" | No | Rolling period. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
page | integer | No | Page number; default: 1. |
pageSize | integer | No | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | No | All, low, mid or high price bands; default: allPrice. |
primaryAsin | string | Yes | One representative ASIN; arrays and multiple entities are not supported. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Child ASIN lists and complete sales trends for one representative ASIN.
Billing rules
5 Credits × ⌈child ASINs returned / 20⌉ (rounded up)
45 child ASINs → 15 Credits
Representative ASIN children
Child ASINs and complete sales trends for one representative ASIN, with period, price-band and pagination controls.
get_category_primary_asins
Category representative ASINs
Tool description
Retrieve representative ASINs and complete trends for a category or price band, with ranking type, sorting and pagination. last12months supports all price bands only: omit priceType or use allPrice. Costs 5 Credits per 5 representative ASINs. rankingType determines sorting when supplied.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Yes | Monthly/yearly rankings require cycle=monthly/yearly and dates within the same calendar month/year, or only period=last30days/last12months. Dates are marketplace-local YYYY-MM-DD. last12months supports all price bands only: omit priceType or use allPrice. For the last 30 days, use period=last30days alone; do not combine with cycle=yearly. |
cycleFilter.cycle | "monthly" | "yearly" | "daily" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | "last12months" | No | Rolling period. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
orders | object[] | No | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Yes | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | "streetDate" | Yes | Sort field. |
page | integer | No | Page number; default: 1. |
pageSize | integer | No | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | No | For last12months, omit priceType or use allPrice; lowPrice, midPrice and highPrice are unsupported. Default: allPrice. |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | No | Ranking type. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Representative ASINs and complete trends for a category or price band. The last 12 months support all price bands only.
Billing rules
5 Credits × ⌈representative ASINs returned / 5⌉ (rounded up)
12 representative ASINs → 15 Credits
Category representative ASINs
Representative ASINs and complete sales trends for a category or price band.
get_category_brand_market_size
Brand market size
Tool description
Retrieve brand market-size lists and complete trends for a month or the last 30 days, with price-band, ranking, sorting and pagination controls. startDate alone implies monthly. With period=last30days, omit cycle or use daily. Costs 5 Credits per 5 brands. newRelease means sales descending here; it does not filter new brands. rankingType overrides sorting.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Yes | Monthly or last 30 days only. Monthly requires startDate; cycle defaults to monthly and optional endDate must be in the same month. Alternatively use period=last30days without dates, with cycle omitted or daily, never monthly. Dates are marketplace-local YYYY-MM-DD. |
cycleFilter.cycle | "monthly" | "daily" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | No | Rolling period. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
orders | object[] | No | Without rankingType, supply at most one sort. With rankingType, orders is ignored. |
orders[].direction | "asc" | "desc" | Yes | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | Yes | Sort field. |
page | integer | No | Page number; default: 1. |
pageSize | integer | No | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | No | All, low, mid or high price bands; default: allPrice. |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | No | For this brand endpoint, newRelease means sales descending and does not filter for new brands. rankingType overrides orders. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Monthly or last-30-day brand market-size lists and complete trends, with price-band, ranking, sorting and pagination controls.
Billing rules
5 Credits × ⌈brands returned / 5⌉ (rounded up)
12 brands cost 15 Credits
Brand market size
Brand-level unit sales, revenue, price, and rating.
get_category_brand_sales_trends
Brand sales trends
Tool description
Retrieve complete historical monthly sales trends and available last-30-day summaries for the requested brands. Start/end month filters are not accepted. Cost: ceil((maximum historical months + 1) / 6) × requested brand count × 2 Credits. The last 30 days count as one month.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brands | string[] | Yes | List of brands to query. |
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | No | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Complete historical monthly sales trends and available last-30-day summaries for the requested brands. Start/end month filters are not accepted.
Billing rules
2 Credits × ⌈(historical months + 1) / 6⌉ × brands returned
24 months × 2 brands → 20 Credits
Brand sales trends
Monthly unit sales and revenue trends for multiple brands.
Category rating analysis
1 toolsToolNameData provided
get_category_review_analysis
Category rating and review analysis
Tool description
Retrieve combined star-rating and review-count analysis for a month or the last 30 days, including distribution, ratingsTrends and starsTrends in full. Costs 5 Credits per successful call.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
categoryId | string | Yes | Category ID confirmed by the user. |
country | string | Yes | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Yes | One calendar month with both startDate/endDate and cycle defaulting to monthly, or period=last30days without dates. daily is only valid for last30days. |
cycleFilter.cycle | "monthly" | "daily" | No | Aggregation cycle. |
cycleFilter.endDate | string | No | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | No | Rolling period. |
cycleFilter.startDate | string | No | Start date, YYYY-MM-DD. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | No | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Yes | Available resource ID returned by the generation tool; reuse within the same task. |
Response
Combined monthly or last-30-day star-rating and review-count analysis, including distributions and both full trend series.
Billing rules
5 Credits per successful call
1 calls → 5 Credits
Category rating and review analysis
Rating and review-count distributions with complete historical trends.