Suchkategorien nach Schlüsselwort oder ASIN
Übereinstimmende Kategorien, IDs, Hierarchie, Pfade und Verfügbarkeit nach Schlüsselwort oder ASIN.
Tools
Kategorie-Insights
Untersuche Kategorienachfrage, Keyword-Konzentration, Produktverteilung und Wettbewerbsbewegungen.
Category Insight-Ressourcen
2 ToolsToolNameBereitgestellte Daten
generate_category_insight_resource
Generieren Sie eine Kategorie-Insight-Ressource
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
Antwort
A resource ID for subsequent category analysis; reuse it within the same task.
Abrechnungsregeln
500 Credits je erfolgreichem Aufruf, auch für bestehende Ressourcen
1 Aufrufe → 500 Credits
Generieren Sie eine Kategorie-Insight-Ressource
Eine asynchron generierte Category Insight-Ressource und Ressourcen-ID.
Kategorie-Rangliste
3 ToolsToolNameBereitgestellte Daten
get_category_sales_ranking
Kategorie-Verkaufsrangliste
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
reportPeriod | string | Ja | 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 | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | Nein | Brand or relevance filters. |
filters.brands | string[] | Nein | List of brands to query. |
orders | object[] | Nein | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Ja | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Ja | Sort field. |
page | integer | Nein | Page number; default: 1. |
pageSize | integer | Nein | Page size; default: 20. |
query | string | Nein | Search term for the list; omitted means no text filter. |
rangeFilters | object | Nein | 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[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | Nein | Upper bound. |
rangeFilters.height[].min | integer | Nein | Lower bound. |
rangeFilters.length | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | Nein | Upper bound. |
rangeFilters.length[].min | integer | Nein | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | Nein | Upper bound. |
rangeFilters.ratings[].min | integer | Nein | Lower bound. |
rangeFilters.revenue | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | Nein | Upper bound. |
rangeFilters.sales[].min | integer | Nein | Lower bound. |
rangeFilters.salesMom | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.streetDays[].max | integer | Nein | Upper bound. |
rangeFilters.streetDays[].min | integer | Nein | Lower bound. |
rangeFilters.trafficScore | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | Nein | Upper bound. |
rangeFilters.trafficScore[].min | integer | Nein | Lower bound. |
rangeFilters.weight | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | Nein | Upper bound. |
rangeFilters.weight[].min | integer | Nein | Lower bound. |
rangeFilters.width | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | Nein | Upper bound. |
rangeFilters.width[].min | integer | Nein | Lower bound. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Sales rankings aggregated by representative ASIN, with brand, range, sorting, search and pagination controls.
Abrechnungsregeln
5 Credits × ⌈zurückgegebene repräsentative ASINs / 5⌉ (aufgerundet)
12 repräsentative ASINs → 15 Credits
Kategorie-Verkaufsrangliste
Ranglisten repräsentativer ASINs mit Absatz, Umsatz, Preis und Bewertungen nach Berichtszeitraum.
get_category_new_release_ranking
Kategorie-Neuerscheinungen
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
reportPeriod | string | Ja | 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 | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | Nein | Brand or relevance filters. |
filters.brands | string[] | Nein | List of brands to query. |
orders | object[] | Nein | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Ja | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Ja | Sort field. |
page | integer | Nein | Page number; default: 1. |
pageSize | integer | Nein | Page size; default: 20. |
query | string | Nein | Search term for the list; omitted means no text filter. |
rangeFilters | object | Nein | 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[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | Nein | Upper bound. |
rangeFilters.height[].min | integer | Nein | Lower bound. |
rangeFilters.length | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | Nein | Upper bound. |
rangeFilters.length[].min | integer | Nein | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | Nein | Upper bound. |
rangeFilters.ratings[].min | integer | Nein | Lower bound. |
rangeFilters.revenue | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | Nein | Upper bound. |
rangeFilters.sales[].min | integer | Nein | Lower bound. |
rangeFilters.salesMom | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | Nein | 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 | Nein | Upper bound. |
rangeFilters.streetDays[].min | integer | Nein | Lower bound. |
rangeFilters.trafficScore | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | Nein | Upper bound. |
rangeFilters.trafficScore[].min | integer | Nein | Lower bound. |
rangeFilters.weight | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | Nein | Upper bound. |
rangeFilters.weight[].min | integer | Nein | Lower bound. |
rangeFilters.width | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | Nein | Upper bound. |
rangeFilters.width[].min | integer | Nein | Lower bound. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Rankings filtered by listing age. An explicit age range is required to restrict results to new releases.
Abrechnungsregeln
5 Credits × ⌈zurückgegebene repräsentative ASINs / 5⌉ (aufgerundet)
12 repräsentative ASINs → 15 Credits
Kategorie-Neuerscheinungen
Ranglisten repräsentativer ASINs mit Absatz, Umsatz, Preis und Bewertungen nach Berichtszeitraum.
get_category_surging_ranking
Kategorie-Wachstumsrangliste
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
reportPeriod | string | Ja | 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 | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | Nein | Brand or relevance filters. |
filters.brands | string[] | Nein | List of brands to query. |
orders | object[] | Nein | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Ja | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | Ja | Sort field. |
page | integer | Nein | Page number; default: 1. |
pageSize | integer | Nein | Page size; default: 20. |
query | string | Nein | Search term for the list; omitted means no text filter. |
rangeFilters | object | Nein | 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[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | Nein | Upper bound. |
rangeFilters.height[].min | integer | Nein | Lower bound. |
rangeFilters.length | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | Nein | Upper bound. |
rangeFilters.length[].min | integer | Nein | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | Nein | Upper bound. |
rangeFilters.ratings[].min | integer | Nein | Lower bound. |
rangeFilters.revenue | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | Nein | Upper bound. |
rangeFilters.sales[].min | integer | Nein | Lower bound. |
rangeFilters.salesMom | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | Nein | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.streetDays[].max | integer | Nein | Upper bound. |
rangeFilters.streetDays[].min | integer | Nein | Lower bound. |
rangeFilters.trafficScore | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | Nein | Upper bound. |
rangeFilters.trafficScore[].min | integer | Nein | Lower bound. |
rangeFilters.weight | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | Nein | Upper bound. |
rangeFilters.weight[].min | integer | Nein | Lower bound. |
rangeFilters.width | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | Nein | Upper bound. |
rangeFilters.width[].min | integer | Nein | Lower bound. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Representative ASIN rankings using the current growth, filter and sorting rules.
Abrechnungsregeln
5 Credits × ⌈zurückgegebene repräsentative ASINs / 5⌉ (aufgerundet)
12 repräsentative ASINs → 15 Credits
Kategorie-Wachstumsrangliste
Ranglisten repräsentativer ASINs mit Absatz, Umsatz, Preis und Bewertungen nach Berichtszeitraum.
Kategorie-Keyword-Analyse
2 ToolsToolNameBereitgestellte Daten
get_category_keyword_analysis
Kategorie-Keyword-Analyse
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
correlationType | "high" | "medium" | "low" | Ja | Keyword relevance. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Nein | 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" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Summary, distribution and complete historical trends for the selected calendar month and relevance.
Abrechnungsregeln
5 Credits je erfolgreichem Aufruf
1 Keywords → 5 Credits
Kategorie-Keyword-Analyse
Zusammenfassung der Keyword-Analyse für eine Kategorie, einen Monat und eine Relevanzstufe.
get_category_keywords
Kategorie-Keyword-Liste
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Nein | 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" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
filters | object | Nein | Brand or relevance filters. |
filters.brands | string[] | Nein | List of brands to query. |
filters.correlationTypes | "high" | "medium" | "low"[] | Nein | Keyword relevance filter. |
includeTrend | boolean | Nein | Include complete historical trends; default: true. |
page | integer | Nein | Page number; default: 1. |
pageSize | integer | Nein | Page size; default: 20. |
query | string | Nein | Search term for the list; omitted means no text filter. |
rangeFilters | object | Nein | 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[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.adjustedClickConversionRate[].max | string | Nein | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.adjustedClickConversionRate[].min | string | Nein | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.cpc | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.cpc[].max | string | Nein | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.cpc[].min | string | Nein | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.organicRotationRate | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicRotationRate[].max | string | Nein | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.organicRotationRate[].min | string | Nein | Non-negative finite decimal number string (≥0), such as 0 or 12.50; min or max may be supplied alone. |
rangeFilters.searchFrequencyRank | object[] | Nein | Closed range [min,max]: includes both bounds. |
rangeFilters.searchFrequencyRank[].max | integer | Nein | Upper bound. |
rangeFilters.searchFrequencyRank[].min | integer | Nein | Lower bound. |
rangeFilters.searchTermCompetitiveDifficulty | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.searchTermCompetitiveDifficulty[].max | integer | Nein | Upper bound. |
rangeFilters.searchTermCompetitiveDifficulty[].min | integer | Nein | Lower bound. |
rangeFilters.searchVolume | object[] | Nein | Half-open range [min,max): includes min, excludes max. |
rangeFilters.searchVolume[].max | integer | Nein | Upper bound. |
rangeFilters.searchVolume[].min | integer | Nein | Lower bound. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Keyword lists with relevance, brand, range and search filters. Complete historical trends are included by default and can be disabled.
Abrechnungsregeln
1 Credits × ⌈zurückgegebene Keywords / 20⌉ (aufgerundet)
45 Keywords kosten 3 Credits
Kategorie-Keyword-Liste
Monatliche Kategorie-Keyword-Liste, Relevanz und Zahl Metriken.
Kategorie-Markttrends
4 ToolsToolNameBereitgestellte Daten
get_category_market_size_trends
Kategorie-Marktgrößentrends
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Complete historical monthly sales trends across all price bands and the available last-30-day summary. Start/end month filters are not accepted.
Abrechnungsregeln
5 Credits × ⌈historische Monate / 6⌉ (aufgerundet)
24 Monate → 20 Credits
Kategorie-Marktgrößentrends
Monatliche Kategorie-Absatz- und Umsatztrends.
get_category_seasonality
Kategorie-Saisonalität
Tool-Beschreibung
Analyze category seasonality using peak/off-season sales comparisons and forecasts. Costs 5 Credits per successful call.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Category seasonality, peak/off-season sales comparisons and demand forecasts.
Abrechnungsregeln
5 Credits je erfolgreichem Aufruf
1 Aufrufe → 5 Credits
Kategorie-Saisonalität
Saisondefinitionen, Spitzen-/Nebenumsatz-Vergleich und eine Dreimonatsprognose.
get_category_new_release_opportunity_trends
Neue versus bestehende Produkttrends
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Ja | 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" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Nein | Rolling period. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Nein | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
New-release opportunity summary, list, complete trends and periods.
Abrechnungsregeln
5 Credits × ⌈historische Monate / 6⌉ (aufgerundet)
24 Monate → 20 Credits
Neue versus bestehende Produkttrends
Neue im Vergleich zu vorhandenen Produktverkäufen und Produktanzahltrends.
get_category_price_segment_trends
Preissegment-Markttrends
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Ja | One calendar month with cycle=monthly and both startDate/endDate, or period=last30days without dates. |
cycleFilter.cycle | "monthly" | "daily" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Nein | Rolling period. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Complete analysis and trends for low, mid and high price bands, including selected-period boundaries, brands, representative ASINs, ratings and finer price ranges.
Abrechnungsregeln
5 Credits × ⌈historische Monate / 6⌉ (aufgerundet)
24 Monate → 20 Credits
Preissegment-Markttrends
Monatliche Stückabsatz- und Umsatztrends nach Preissegment.
Kategoriewettbewerb
4 ToolsToolNameBereitgestellte Daten
get_primary_asin_children
Varianten einer repräsentativen ASIN
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Ja | 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" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | "last12months" | Nein | Rolling period. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
page | integer | Nein | Page number; default: 1. |
pageSize | integer | Nein | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Nein | All, low, mid or high price bands; default: allPrice. |
primaryAsin | string | Ja | One representative ASIN; arrays and multiple entities are not supported. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Child ASIN lists and complete sales trends for one representative ASIN.
Abrechnungsregeln
5 Credits × ⌈zurückgegebene untergeordnete ASINs / 20⌉ (aufgerundet)
45 untergeordnete ASINs → 15 Credits
Varianten einer repräsentativen ASIN
Untergeordnete ASINs und vollständige Absatztrends einer repräsentativen ASIN, nach Zeitraum, Preisband und Seite.
get_category_primary_asins
Repräsentative ASINs der Kategorie
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Ja | 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" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | "last12months" | Nein | Rolling period. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
orders | object[] | Nein | Sort fields and directions. |
orders[].direction | "asc" | "desc" | Ja | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | "streetDate" | Ja | Sort field. |
page | integer | Nein | Page number; default: 1. |
pageSize | integer | Nein | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Nein | For last12months, omit priceType or use allPrice; lowPrice, midPrice and highPrice are unsupported. Default: allPrice. |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | Nein | Ranking type. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Representative ASINs and complete trends for a category or price band. The last 12 months support all price bands only.
Abrechnungsregeln
5 Credits × ⌈zurückgegebene repräsentative ASINs / 5⌉ (aufgerundet)
12 repräsentative ASINs → 15 Credits
Repräsentative ASINs der Kategorie
Repräsentative ASINs und vollständige Absatztrends einer Kategorie oder eines Preisbands.
get_category_brand_market_size
Markenmarktgröße
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Ja | 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" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Nein | Rolling period. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
orders | object[] | Nein | Without rankingType, supply at most one sort. With rankingType, orders is ignored. |
orders[].direction | "asc" | "desc" | Ja | Ascending or descending order. |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | Ja | Sort field. |
page | integer | Nein | Page number; default: 1. |
pageSize | integer | Nein | Page size; default: 20. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Nein | All, low, mid or high price bands; default: allPrice. |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | Nein | For this brand endpoint, newRelease means sales descending and does not filter for new brands. rankingType overrides orders. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Monthly or last-30-day brand market-size lists and complete trends, with price-band, ranking, sorting and pagination controls.
Abrechnungsregeln
5 Credits × ⌈zurückgegebene Marken / 5⌉ (aufgerundet)
12 Marken kosten 15 Credits
Markenmarktgröße
Stückzahlen, Umsatz, Preis und Bewertung auf Markenebene.
get_category_brand_sales_trends
Markenverkaufstrends
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
brands | string[] | Ja | List of brands to query. |
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Nein | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Complete historical monthly sales trends and available last-30-day summaries for the requested brands. Start/end month filters are not accepted.
Abrechnungsregeln
2 Credits × ⌈(historische Monate + 1) / 6⌉ × zurückgegebene Marken
24 Monate × 2 Marken → 20 Credits
Markenverkaufstrends
Monatliche Stückzahlen und Umsatztrends für mehrere Marken.
Kategorie-Bewertungsanalyse
1 ToolsToolNameBereitgestellte Daten
get_category_review_analysis
Kategorie-Bewertungen und Rezensionen
Tool-Beschreibung
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.
Eingabeparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
categoryId | string | Ja | Category ID confirmed by the user. |
country | string | Ja | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | Ja | 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" | Nein | Aggregation cycle. |
cycleFilter.endDate | string | Nein | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | Nein | Rolling period. |
cycleFilter.startDate | string | Nein | Start date, YYYY-MM-DD. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | Nein | All, low, mid or high price bands; default: allPrice. |
resourceId | string | Ja | Available resource ID returned by the generation tool; reuse within the same task. |
Antwort
Combined monthly or last-30-day star-rating and review-count analysis, including distributions and both full trend series.
Abrechnungsregeln
5 Credits je erfolgreichem Aufruf
1 Aufrufe → 5 Credits
Kategorie-Bewertungen und Rezensionen
Sterne- und Bewertungsanzahl-Verteilungen mit vollständigen historischen Trends.