Analisi di categoria
Comprendi domanda, concentrazione delle parole chiave, distribuzione dei prodotti e movimenti competitivi.
get_category_sales_ranking
Classifica vendite per categoria
Descrizione dello strumento
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.
Parametri di ingresso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
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. |
Risposta
Sales rankings aggregated by representative ASIN, with brand, range, sorting, search and pagination controls.
Regole di fatturazione
5 Credits × ⌈ASIN rappresentativi restituiti / 5⌉ (arrotondato per eccesso)
12 ASIN rappresentativi → 15 Credits
get_category_market_size_trends
Tendenze delle dimensioni del mercato della categoria
Descrizione dello strumento
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.
Parametri di ingresso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
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. |
Risposta
Complete historical monthly sales trends across all price bands and the available last-30-day summary. Start/end month filters are not accepted.
Regole di fatturazione
5 Credits × ⌈mesi storici / 6⌉ (arrotondato per eccesso)
24 mesi → 20 Credits
get_category_new_release_opportunity_trends
Tendenze dei prodotti nuovi rispetto a quelli esistenti
Descrizione dello strumento
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.
Parametri di ingresso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
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. |
Risposta
New-release opportunity summary, list, complete trends and periods.
Regole di fatturazione
5 Credits × ⌈mesi storici / 6⌉ (arrotondato per eccesso)
24 mesi → 20 Credits
get_category_price_segment_trends
Tendenze del mercato del segmento di prezzo
Descrizione dello strumento
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.
Parametri di ingresso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
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. |
Risposta
Complete analysis and trends for low, mid and high price bands, including selected-period boundaries, brands, representative ASINs, ratings and finer price ranges.
Regole di fatturazione
5 Credits × ⌈mesi storici / 6⌉ (arrotondato per eccesso)
24 mesi → 20 Credits