Catégories de recherche par mot-clé ou ASIN
Catégories, identifiants, hiérarchie, chemins et disponibilité correspondants par mot clé ou ASIN.
Outils
Analyse de catégorie
Étudiez demande, concentration des mots-clés, distribution des produits et évolution concurrentielle.
Ressources d’analyse de catégorie
2 outilsOutilNomDonnées fournies
generate_category_insight_resource
Générer une ressource Category Insight
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
Réponse
A resource ID for subsequent category analysis; reuse it within the same task.
Règles de facturation
500 Credits par appel réussi, y compris les ressources existantes
1 appels → 500 Credits
Générer une ressource Category Insight
Une ressource Category Insight et un ID de ressource générés de manière asynchrone.
Classement des catégories
3 outilsOutilNomDonnées fournies
get_category_sales_ranking
Classement des ventes par catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
reportPeriod | string | Oui | 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 | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | Non | Brand or relevance filters. |
filters.brands | string[] | Non | List of brands to query. |
orders | object[] | Non | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Oui | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Oui | Sort field. |
page | integer | Non | Page number; default: 1. |
pageSize | integer | Non | Page size; default: 20. |
query | string | Non | Search term for the list; omitted means no text filter. |
rangeFilters | object | Non | 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[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | Non | Upper bound. |
rangeFilters.height[].min | integer | Non | Lower bound. |
rangeFilters.length | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | Non | Upper bound. |
rangeFilters.length[].min | integer | Non | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | Non | Upper bound. |
rangeFilters.ratings[].min | integer | Non | Lower bound. |
rangeFilters.revenue | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | Non | Upper bound. |
rangeFilters.sales[].min | integer | Non | Lower bound. |
rangeFilters.salesMom | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.streetDays[].max | integer | Non | Upper bound. |
rangeFilters.streetDays[].min | integer | Non | Lower bound. |
rangeFilters.trafficScore | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | Non | Upper bound. |
rangeFilters.trafficScore[].min | integer | Non | Lower bound. |
rangeFilters.weight | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | Non | Upper bound. |
rangeFilters.weight[].min | integer | Non | Lower bound. |
rangeFilters.width | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | Non | Upper bound. |
rangeFilters.width[].min | integer | Non | Lower bound. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Sales rankings aggregated by representative ASIN, with brand, range, sorting, search and pagination controls.
Règles de facturation
5 Credits × ⌈ASIN représentatifs retournés / 5⌉ (arrondi au supérieur)
12 ASIN représentatifs → 15 Credits
Classement des ventes par catégorie
Classement des ASIN représentatifs : ventes, chiffre d’affaires, prix et notes par période.
get_category_new_release_ranking
Classement des nouveautés par catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
reportPeriod | string | Oui | 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 | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | Non | Brand or relevance filters. |
filters.brands | string[] | Non | List of brands to query. |
orders | object[] | Non | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Oui | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Oui | Sort field. |
page | integer | Non | Page number; default: 1. |
pageSize | integer | Non | Page size; default: 20. |
query | string | Non | Search term for the list; omitted means no text filter. |
rangeFilters | object | Non | 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[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | Non | Upper bound. |
rangeFilters.height[].min | integer | Non | Lower bound. |
rangeFilters.length | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | Non | Upper bound. |
rangeFilters.length[].min | integer | Non | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | Non | Upper bound. |
rangeFilters.ratings[].min | integer | Non | Lower bound. |
rangeFilters.revenue | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | Non | Upper bound. |
rangeFilters.sales[].min | integer | Non | Lower bound. |
rangeFilters.salesMom | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | Non | 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 | Non | Upper bound. |
rangeFilters.streetDays[].min | integer | Non | Lower bound. |
rangeFilters.trafficScore | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | Non | Upper bound. |
rangeFilters.trafficScore[].min | integer | Non | Lower bound. |
rangeFilters.weight | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | Non | Upper bound. |
rangeFilters.weight[].min | integer | Non | Lower bound. |
rangeFilters.width | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | Non | Upper bound. |
rangeFilters.width[].min | integer | Non | Lower bound. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Rankings filtered by listing age. An explicit age range is required to restrict results to new releases.
Règles de facturation
5 Credits × ⌈ASIN représentatifs retournés / 5⌉ (arrondi au supérieur)
12 ASIN représentatifs → 15 Credits
Classement des nouveautés par catégorie
Classement des ASIN représentatifs : ventes, chiffre d’affaires, prix et notes par période.
get_category_surging_ranking
Classement de croissance par catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
reportPeriod | string | Oui | 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 | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | Non | Brand or relevance filters. |
filters.brands | string[] | Non | List of brands to query. |
orders | object[] | Non | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Oui | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Oui | Sort field. |
page | integer | Non | Page number; default: 1. |
pageSize | integer | Non | Page size; default: 20. |
query | string | Non | Search term for the list; omitted means no text filter. |
rangeFilters | object | Non | 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[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | Non | Upper bound. |
rangeFilters.height[].min | integer | Non | Lower bound. |
rangeFilters.length | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | Non | Upper bound. |
rangeFilters.length[].min | integer | Non | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | Non | Upper bound. |
rangeFilters.ratings[].min | integer | Non | Lower bound. |
rangeFilters.revenue | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | Non | Upper bound. |
rangeFilters.sales[].min | integer | Non | Lower bound. |
rangeFilters.salesMom | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | Non | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.streetDays[].max | integer | Non | Upper bound. |
rangeFilters.streetDays[].min | integer | Non | Lower bound. |
rangeFilters.trafficScore | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | Non | Upper bound. |
rangeFilters.trafficScore[].min | integer | Non | Lower bound. |
rangeFilters.weight | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | Non | Upper bound. |
rangeFilters.weight[].min | integer | Non | Lower bound. |
rangeFilters.width | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | Non | Upper bound. |
rangeFilters.width[].min | integer | Non | Lower bound. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Representative ASIN rankings using the current growth, filter and sorting rules.
Règles de facturation
5 Credits × ⌈ASIN représentatifs retournés / 5⌉ (arrondi au supérieur)
12 ASIN représentatifs → 15 Credits
Classement de croissance par catégorie
Classement des ASIN représentatifs : ventes, chiffre d’affaires, prix et notes par période.
Analyse des mots clés de catégorie
2 outilsOutilNomDonnées fournies
get_category_keyword_analysis
Analyse des mots clés de catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
correlationType | "high" | "medium" | "low" | Oui | Keyword relevance. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Non | 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" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Summary, distribution and complete historical trends for the selected calendar month and relevance.
Règles de facturation
5 Credits par appel réussi
1 mots-clés → 5 Credits
Analyse des mots clés de catégorie
Résumé de l'analyse des mots clés pour une catégorie, un mois et un niveau de pertinence.
get_category_keywords
Liste de mots clés de catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Non | 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" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
filters | object | Non | Brand or relevance filters. |
filters.brands | string[] | Non | List of brands to query. |
filters.correlationTypes | "high" | "medium" | "low"[] | Non | Keyword relevance filter. |
includeTrend | boolean | Non | Include complete historical trends; default: true. |
page | integer | Non | Page number; default: 1. |
pageSize | integer | Non | Page size; default: 20. |
query | string | Non | Search term for the list; omitted means no text filter. |
rangeFilters | object | Non | 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[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.adjustedClickConversionRate[].max | string | Non | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.adjustedClickConversionRate[].min | string | Non | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.cpc | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.cpc[].max | string | Non | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.cpc[].min | string | Non | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.organicRotationRate | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicRotationRate[].max | string | Non | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.organicRotationRate[].min | string | Non | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.searchFrequencyRank | object[] | Non | Closed range [min,max]: includes both bounds. |
rangeFilters.searchFrequencyRank[].max | integer | Non | Upper bound. |
rangeFilters.searchFrequencyRank[].min | integer | Non | Lower bound. |
rangeFilters.searchTermCompetitiveDifficulty | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.searchTermCompetitiveDifficulty[].max | integer | Non | Upper bound. |
rangeFilters.searchTermCompetitiveDifficulty[].min | integer | Non | Lower bound. |
rangeFilters.searchVolume | object[] | Non | Half-open range [min,max): includes min, excludes max. |
rangeFilters.searchVolume[].max | integer | Non | Upper bound. |
rangeFilters.searchVolume[].min | integer | Non | Lower bound. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Keyword lists with relevance, brand, range and search filters. Complete historical trends are included by default and can be disabled.
Règles de facturation
1 Credits × ⌈mots-clés retournés / 20⌉ (arrondi au supérieur)
45 mots-clés coûtent 3 Credits
Liste de mots clés de catégorie
Liste mensuelle des mots clés de catégorie, pertinence et mesures numériques.
Tendances du marché par catégorie
4 outilsOutilNomDonnées fournies
get_category_market_size_trends
Tendances de la taille du marché par catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Complete historical monthly sales trends across all price bands and the available last-30-day summary. Start/end month filters are not accepted.
Règles de facturation
5 Credits × ⌈mois historiques / 6⌉ (arrondi au supérieur)
24 mois → 20 Credits
Tendances de la taille du marché par catégorie
Mensuel Tendances des ventes unitaires et des revenus de la catégorie.
get_category_seasonality
Saisonnalité de la catégorie
Description de l’outil
Analyze category seasonality using peak/off-season sales comparisons and forecasts. Costs 5 Credits per successful call.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Category seasonality, peak/off-season sales comparisons and demand forecasts.
Règles de facturation
5 Credits par appel réussi
1 appels → 5 Credits
Saisonnalité de la catégorie
Définitions des saisons, comparaison des ventes en période de pointe/hors pointe et prévisions sur trois mois.
get_category_new_release_opportunity_trends
Tendances des produits nouveaux par rapport aux produits existants
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Oui | 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" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Non | Rolling period. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Non | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
New-release opportunity summary, list, complete trends and periods.
Règles de facturation
5 Credits × ⌈mois historiques / 6⌉ (arrondi au supérieur)
24 mois → 20 Credits
Tendances des produits nouveaux par rapport aux produits existants
Tendances des ventes de produits nouveaux et existants et du nombre de produits.
get_category_price_segment_trends
Tendances du marché par segment de prix
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Oui | One calendar month with cycle=monthly and both startDate/endDate, or period=last30days without dates. |
cycleFilter.cycle | "monthly" | "daily" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Non | Rolling period. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Complete analysis and trends for low, mid and high price bands, including selected-period boundaries, brands, representative ASINs, ratings and finer price ranges.
Règles de facturation
5 Credits × ⌈mois historiques / 6⌉ (arrondi au supérieur)
24 mois → 20 Credits
Tendances du marché par segment de prix
Tendances mensuelles des ventes unitaires et des revenus par segment de prix.
Concurrence par catégorie
4 outilsOutilNomDonnées fournies
get_primary_asin_children
Variantes d’un ASIN représentatif
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Oui | 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" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | "last12months" | Non | Rolling period. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
page | integer | Non | Page number; default: 1. |
pageSize | integer | Non | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Non | All, low, mid or high price bands; default: allPrice. |
primaryAsin | string | Oui | One representative ASIN; arrays and multiple entities are not supported. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Child ASIN lists and complete sales trends for one representative ASIN.
Règles de facturation
5 Credits × ⌈ASIN enfants retournés / 20⌉ (arrondi au supérieur)
45 ASIN enfants → 15 Credits
Variantes d’un ASIN représentatif
ASIN enfants et tendances complètes des ventes d’un ASIN représentatif, par période, gamme de prix et page.
get_category_primary_asins
ASIN représentatifs de la catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Oui | 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" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | "last12months" | Non | Rolling period. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
orders | object[] | Non | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Oui | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | "streetDate" | Oui | Sort field. |
page | integer | Non | Page number; default: 1. |
pageSize | integer | Non | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Non | For last12months, omit priceType or use allPrice; lowPrice, midPrice and highPrice are unsupported. Default: allPrice. |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | Non | Ranking type. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Representative ASINs and complete trends for a category or price band. The last 12 months support all price bands only.
Règles de facturation
5 Credits × ⌈ASIN représentatifs retournés / 5⌉ (arrondi au supérieur)
12 ASIN représentatifs → 15 Credits
ASIN représentatifs de la catégorie
ASIN représentatifs et tendances complètes des ventes par catégorie ou gamme de prix.
get_category_brand_market_size
Taille du marché de la marque
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Oui | 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" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Non | Rolling period. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
orders | object[] | Non | Without rankingType, supply at most one sort. With rankingType, orders is ignored. |
orders[].direction | "asc" | "desc" | Oui | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | Oui | Sort field. |
page | integer | Non | Page number; default: 1. |
pageSize | integer | Non | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Non | All, low, mid or high price bands; default: allPrice. |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | Non | For this brand endpoint, newRelease means sales descending and does not filter for new brands. rankingType overrides orders. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Monthly or last-30-day brand market-size lists and complete trends, with price-band, ranking, sorting and pagination controls.
Règles de facturation
5 Credits × ⌈marques retournées / 5⌉ (arrondi au supérieur)
12 marques coûtent 15 Credits
Taille du marché de la marque
Ventes unitaires, revenus, prix et notes au niveau de la marque.
get_category_brand_sales_trends
Tendances des ventes de la marque
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
brands | string[] | Oui | List of brands to query. |
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Non | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Complete historical monthly sales trends and available last-30-day summaries for the requested brands. Start/end month filters are not accepted.
Règles de facturation
2 Credits × ⌈(mois historiques + 1) / 6⌉ × marques retournées
24 mois × 2 marques → 20 Credits
Tendances des ventes de la marque
Tendances mensuelles des ventes unitaires et des revenus pour plusieurs marques.
Analyse des notes de catégorie
1 outilsOutilNomDonnées fournies
get_category_review_analysis
Analyse des notes et avis par catégorie
Description de l’outil
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.
Paramètres d’entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
categoryId | string | Oui | Category ID confirmed by the user. |
country | string | Oui | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Oui | 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" | Non | Aggregation cycle. |
cycleFilter.endDate | string | Non | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Non | Rolling period. |
cycleFilter.startDate | string | Non | Start date, YYYY-MM-DD. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Non | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Oui | Available resource ID returned by the generation tool; reuse within the same task. |
Réponse
Combined monthly or last-30-day star-rating and review-count analysis, including distributions and both full trend series.
Règles de facturation
5 Credits par appel réussi
1 appels → 5 Credits
Analyse des notes et avis par catégorie
Distributions des notes et du nombre d’avis avec historique complet.