Buscar categorías por palabra clave o ASIN
Categorías coincidentes, ID, jerarquía, rutas y disponibilidad por palabra clave o ASIN.
Herramientas
Análisis de categoría
Estudia demanda, concentración de palabras clave, distribución de productos y movimientos competitivos.
Recursos de Category Insight
2 herramientasHerramientaNombreDatos proporcionados
generate_category_insight_resource
Generar un recurso de Category Insight
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
Respuesta
A resource ID for subsequent category analysis; reuse it within the same task.
Reglas de facturación
500 Credits por llamada exitosa, incluidos recursos existentes
1 llamadas → 500 Credits
Generar un recurso de Category Insight
Un recurso de Category Insight e ID de recurso generados de forma asincrónica.
Clasificación de categorías
3 herramientasHerramientaNombreDatos proporcionados
get_category_sales_ranking
Ranking de ventas por categoría
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
reportPeriod | string | Sí | 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 | Sí | Category ID confirmed by the user. |
country | string | Sí | 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" | Sí | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Sales rankings aggregated by representative ASIN, with brand, range, sorting, search and pagination controls.
Reglas de facturación
5 Credits × ⌈ASIN representativos devueltos / 5⌉ (redondeado hacia arriba)
12 ASIN representativos → 15 Credits
Ranking de ventas por categoría
Ranking de ASIN representativos con ventas, ingresos, precio y valoraciones por periodo.
get_category_new_release_ranking
Ranking de novedades por categoría
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
reportPeriod | string | Sí | 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 | Sí | Category ID confirmed by the user. |
country | string | Sí | 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" | Sí | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Rankings filtered by listing age. An explicit age range is required to restrict results to new releases.
Reglas de facturación
5 Credits × ⌈ASIN representativos devueltos / 5⌉ (redondeado hacia arriba)
12 ASIN representativos → 15 Credits
Ranking de novedades por categoría
Ranking de ASIN representativos con ventas, ingresos, precio y valoraciones por periodo.
get_category_surging_ranking
Ranking de crecimiento por categoría
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
reportPeriod | string | Sí | 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 | Sí | Category ID confirmed by the user. |
country | string | Sí | 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" | Sí | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Representative ASIN rankings using the current growth, filter and sorting rules.
Reglas de facturación
5 Credits × ⌈ASIN representativos devueltos / 5⌉ (redondeado hacia arriba)
12 ASIN representativos → 15 Credits
Ranking de crecimiento por categoría
Ranking de ASIN representativos con ventas, ingresos, precio y valoraciones por periodo.
Análisis de palabras clave de categoría
2 herramientasHerramientaNombreDatos proporcionados
get_category_keyword_analysis
Análisis de palabras clave de categoría
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
correlationType | "high" | "medium" | "low" | Sí | Keyword relevance. |
country | string | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Summary, distribution and complete historical trends for the selected calendar month and relevance.
Reglas de facturación
5 Credits por llamada exitosa
1 palabras clave → 5 Credits
Análisis de palabras clave de categoría
Resumen de análisis de palabras clave para una categoría, mes y nivel de relevancia.
get_category_keywords
Lista de palabras clave de categorías
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Keyword lists with relevance, brand, range and search filters. Complete historical trends are included by default and can be disabled.
Reglas de facturación
1 Credits × ⌈palabras clave devueltas / 20⌉ (redondeado hacia arriba)
45 palabras clave cuestan 3 Credits
Lista de palabras clave de categorías
Lista de palabras clave de categoría mensual, relevancia y métricas numéricas.
Tendencias de mercado de categorías
4 herramientasHerramientaNombreDatos proporcionados
get_category_market_size_trends
Tendencias de tamaño de mercado de categorías
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Complete historical monthly sales trends across all price bands and the available last-30-day summary. Start/end month filters are not accepted.
Reglas de facturación
5 Credits × ⌈meses históricos / 6⌉ (redondeado hacia arriba)
24 meses → 20 Credits
Tendencias de tamaño de mercado de categorías
Tendencias de ingresos y ventas de unidades de categorías mensuales.
get_category_seasonality
Estacionalidad de categorías
Descripción de la herramienta
Analyze category seasonality using peak/off-season sales comparisons and forecasts. Costs 5 Credits per successful call.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Category seasonality, peak/off-season sales comparisons and demand forecasts.
Reglas de facturación
5 Credits por llamada exitosa
1 llamadas → 5 Credits
Estacionalidad de categorías
Definiciones de temporada, comparación de ventas pico/bajo y pronóstico de tres meses.
get_category_new_release_opportunity_trends
Tendencias de productos nuevos versus existentes
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
New-release opportunity summary, list, complete trends and periods.
Reglas de facturación
5 Credits × ⌈meses históricos / 6⌉ (redondeado hacia arriba)
24 meses → 20 Credits
Tendencias de productos nuevos versus existentes
Ventas de productos nuevos versus tendencias de recuento de productos y ventas de productos existentes.
get_category_price_segment_trends
Mercado de segmentos de precios tendencias
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Complete analysis and trends for low, mid and high price bands, including selected-period boundaries, brands, representative ASINs, ratings and finer price ranges.
Reglas de facturación
5 Credits × ⌈meses históricos / 6⌉ (redondeado hacia arriba)
24 meses → 20 Credits
Mercado de segmentos de precios tendencias
Tendencias de ingresos y ventas de unidades mensuales por segmento de precios.
Competencia de categorías
4 herramientasHerramientaNombreDatos proporcionados
get_primary_asin_children
Variantes de un ASIN representativo
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Sí | 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 | Sí | One representative ASIN; arrays and multiple entities are not supported. |
resourceId | string | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Child ASIN lists and complete sales trends for one representative ASIN.
Reglas de facturación
5 Credits × ⌈ASIN hijos devueltos / 20⌉ (redondeado hacia arriba)
45 ASIN hijos → 15 Credits
Variantes de un ASIN representativo
ASIN hijos y tendencias completas de ventas de un ASIN representativo, por periodo, rango de precio y página.
get_category_primary_asins
ASIN representativos de la categoría
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Sí | 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" | Sí | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | "streetDate" | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Representative ASINs and complete trends for a category or price band. The last 12 months support all price bands only.
Reglas de facturación
5 Credits × ⌈ASIN representativos devueltos / 5⌉ (redondeado hacia arriba)
12 ASIN representativos → 15 Credits
ASIN representativos de la categoría
ASIN representativos y tendencias completas de ventas por categoría o rango de precio.
get_category_brand_market_size
Tamaño del mercado de la marca
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Sí | 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" | Sí | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Monthly or last-30-day brand market-size lists and complete trends, with price-band, ranking, sorting and pagination controls.
Reglas de facturación
5 Credits × ⌈marcas devueltas / 5⌉ (redondeado hacia arriba)
12 marcas cuestan 15 Credits
Tamaño del mercado de la marca
Ventas de unidades, ingresos, precio y calificación de unidades a nivel de marca.
get_category_brand_sales_trends
Tendencias de ventas de las marcas
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
brands | string[] | Sí | List of brands to query. |
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Complete historical monthly sales trends and available last-30-day summaries for the requested brands. Start/end month filters are not accepted.
Reglas de facturación
2 Credits × ⌈(meses históricos + 1) / 6⌉ × marcas devueltas
24 meses × 2 marcas → 20 Credits
Tendencias de ventas de las marcas
Ventas de unidades mensuales y tendencias de ingresos para múltiples marcas.
Análisis de calificación de categoría
1 herramientasHerramientaNombreDatos proporcionados
get_category_review_analysis
Análisis de valoraciones y reseñas por categoría
Descripción de la herramienta
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.
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | Sí | Category ID confirmed by the user. |
country | string | Sí | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Sí | 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 | Sí | Available resource ID returned by the generation tool; reuse within the same task. |
Respuesta
Combined monthly or last-30-day star-rating and review-count analysis, including distributions and both full trend series.
Reglas de facturación
5 Credits por llamada exitosa
1 llamadas → 5 Credits
Análisis de valoraciones y reseñas por categoría
Distribuciones de valoraciones y número de reseñas con tendencias históricas completas.