Cerca categorie per parola chiave o ASIN
Categorie, ID, gerarchia, percorsi e disponibilità corrispondenti per parola chiave o ASIN.
Strumenti
Analisi di categoria
Studia domanda, concentrazione delle parole chiave, distribuzione dei prodotti e movimenti competitivi.
Risorse Insight categoria
2 strumentiStrumentoNomeDati forniti
generate_category_insight_resource
Genera una risorsa Insight categoria
Descrizione dello strumento
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.
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. |
Risposta
A resource ID for subsequent category analysis; reuse it within the same task.
Regole di fatturazione
500 Credits per chiamata riuscita, incluse risorse esistenti
1 chiamate → 500 Credits
Genera una risorsa Insight categoria
Una risorsa Insight categoria e un ID risorsa generati in modo asincrono.
Classifica di categoria
3 strumentiStrumentoNomeDati forniti
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
Classifica vendite per categoria
Classifiche degli ASIN rappresentativi con vendite, ricavi, prezzi e valutazioni per periodo.
get_category_new_release_ranking
Classifica novità per categoria
Descrizione dello strumento
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.
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). 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. |
Risposta
Rankings filtered by listing age. An explicit age range is required to restrict results to new releases.
Regole di fatturazione
5 Credits × ⌈ASIN rappresentativi restituiti / 5⌉ (arrotondato per eccesso)
12 ASIN rappresentativi → 15 Credits
Classifica novità per categoria
Classifiche degli ASIN rappresentativi con vendite, ricavi, prezzi e valutazioni per periodo.
get_category_surging_ranking
Classifica crescita per categoria
Descrizione dello strumento
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.
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
Representative ASIN rankings using the current growth, filter and sorting rules.
Regole di fatturazione
5 Credits × ⌈ASIN rappresentativi restituiti / 5⌉ (arrotondato per eccesso)
12 ASIN rappresentativi → 15 Credits
Classifica crescita per categoria
Classifiche degli ASIN rappresentativi con vendite, ricavi, prezzi e valutazioni per periodo.
Analisi delle parole chiave di categoria
2 strumentiStrumentoNomeDati forniti
get_category_keyword_analysis
Analisi delle parole chiave di categoria
Descrizione dello strumento
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.
Parametri di ingresso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
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. |
Risposta
Summary, distribution and complete historical trends for the selected calendar month and relevance.
Regole di fatturazione
5 Credits per chiamata riuscita
1 parole chiave → 5 Credits
Analisi delle parole chiave di categoria
Riepilogo dell'analisi delle parole chiave per categoria, mese e livello di pertinenza.
get_category_keywords
Elenco parole chiave della categoria
Descrizione dello strumento
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.
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 | 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. |
Risposta
Keyword lists with relevance, brand, range and search filters. Complete historical trends are included by default and can be disabled.
Regole di fatturazione
1 Credits × ⌈parole chiave restituite / 20⌉ (arrotondato per eccesso)
45 parole chiave costano 3 Credits
Elenco parole chiave della categoria
Elenco mensile di parole chiave per categoria, pertinenza e metriche numeriche.
Tendenze del mercato della categoria
4 strumentiStrumentoNomeDati forniti
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
Tendenze delle dimensioni del mercato della categoria
Vendite mensili di unità di categoria e tendenze dei ricavi.
get_category_seasonality
Stagionalità della categoria
Descrizione dello strumento
Analyze category seasonality using peak/off-season sales comparisons and forecasts. Costs 5 Credits per successful call.
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
Category seasonality, peak/off-season sales comparisons and demand forecasts.
Regole di fatturazione
5 Credits per chiamata riuscita
1 chiamate → 5 Credits
Stagionalità della categoria
Definizioni di stagione, confronto delle vendite di punta/non di punta e previsione di tre mesi.
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
Tendenze dei prodotti nuovi rispetto a quelli esistenti
Vendite di prodotti nuovi rispetto a quelli esistenti e tendenze del numero di prodotti.
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
Tendenze del mercato del segmento di prezzo
Vendite di unità mensili e tendenze delle entrate per segmento di prezzo.
Categoria concorrenza
4 strumentiStrumentoNomeDati forniti
get_primary_asin_children
Varianti di un ASIN rappresentativo
Descrizione dello strumento
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.
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ì | 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. |
Risposta
Child ASIN lists and complete sales trends for one representative ASIN.
Regole di fatturazione
5 Credits × ⌈ASIN figli restituiti / 20⌉ (arrotondato per eccesso)
45 ASIN figli → 15 Credits
Varianti di un ASIN rappresentativo
ASIN figli e andamento completo delle vendite di un ASIN rappresentativo, per periodo, fascia di prezzo e pagina.
get_category_primary_asins
ASIN rappresentativi della categoria
Descrizione dello strumento
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.
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ì | 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. |
Risposta
Representative ASINs and complete trends for a category or price band. The last 12 months support all price bands only.
Regole di fatturazione
5 Credits × ⌈ASIN rappresentativi restituiti / 5⌉ (arrotondato per eccesso)
12 ASIN rappresentativi → 15 Credits
ASIN rappresentativi della categoria
ASIN rappresentativi e andamento completo delle vendite per categoria o fascia di prezzo.
get_category_brand_market_size
Dimensione del mercato del marchio
Descrizione dello strumento
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.
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ì | 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. |
Risposta
Monthly or last-30-day brand market-size lists and complete trends, with price-band, ranking, sorting and pagination controls.
Regole di fatturazione
5 Credits × ⌈marchi restituiti / 5⌉ (arrotondato per eccesso)
12 marchi costano 15 Credits
Dimensione del mercato del marchio
Vendite, ricavi, prezzo e valutazione di unità a livello di marca.
get_category_brand_sales_trends
Tendenze di vendita del marchio
Descrizione dello strumento
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.
Parametri di ingresso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
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. |
Risposta
Complete historical monthly sales trends and available last-30-day summaries for the requested brands. Start/end month filters are not accepted.
Regole di fatturazione
2 Credits × ⌈(mesi storici + 1) / 6⌉ × marchi restituiti
24 mesi × 2 marchi → 20 Credits
Tendenze di vendita del marchio
Vendite unitarie mensili e andamento dei ricavi per più marchi.
Analisi della valutazione della categoria
1 strumentiStrumentoNomeDati forniti
get_category_review_analysis
Analisi valutazioni e recensioni per categoria
Descrizione dello strumento
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.
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 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. |
Risposta
Combined monthly or last-30-day star-rating and review-count analysis, including distributions and both full trend series.
Regole di fatturazione
5 Credits per chiamata riuscita
1 chiamate → 5 Credits
Analisi valutazioni e recensioni per categoria
Distribuzioni delle valutazioni e del numero di recensioni con storico completo.