カテゴリー分析
需要、キーワード集中度、商品分布、競争環境の変化を把握します。
get_category_sales_ranking
カテゴリー販売ランキング
ツールの説明
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.
入力パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
reportPeriod | string | はい | 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 | はい | Category ID confirmed by the user. |
country | string | はい | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
filters | object | いいえ | Brand or relevance filters. |
filters.brands | string[] | いいえ | List of brands to query. |
orders | object[] | いいえ | Sort fields and directions. |
orders[].direction | "asc" | "desc" | はい | Ascending or descending order. |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | はい | Sort field. |
page | integer | いいえ | Page number; default: 1. |
pageSize | integer | いいえ | Page size; default: 20. |
query | string | いいえ | Search term for the list; omitted means no text filter. |
rangeFilters | object | いいえ | 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[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.height[].max | integer | いいえ | Upper bound. |
rangeFilters.height[].min | integer | いいえ | Lower bound. |
rangeFilters.length | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.length[].max | integer | いいえ | Upper bound. |
rangeFilters.length[].min | integer | いいえ | Lower bound. |
rangeFilters.organicTrafficScoreRatio | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.organicTrafficScoreRatio[].max | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.organicTrafficScoreRatio[].min | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.price[].max | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.price[].min | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.ratings | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.ratings[].max | integer | いいえ | Upper bound. |
rangeFilters.ratings[].min | integer | いいえ | Lower bound. |
rangeFilters.revenue | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.revenue[].max | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.revenue[].min | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.sales | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.sales[].max | integer | いいえ | Upper bound. |
rangeFilters.sales[].min | integer | いいえ | Lower bound. |
rangeFilters.salesMom | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesMom[].max | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesMom[].min | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.salesYoy[].max | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.salesYoy[].min | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.stars[].max | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.stars[].min | string | いいえ | Finite decimal number string, such as 12.50; min or max may be supplied alone. |
rangeFilters.streetDays | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.streetDays[].max | integer | いいえ | Upper bound. |
rangeFilters.streetDays[].min | integer | いいえ | Lower bound. |
rangeFilters.trafficScore | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.trafficScore[].max | integer | いいえ | Upper bound. |
rangeFilters.trafficScore[].min | integer | いいえ | Lower bound. |
rangeFilters.weight | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.weight[].max | integer | いいえ | Upper bound. |
rangeFilters.weight[].min | integer | いいえ | Lower bound. |
rangeFilters.width | object[] | いいえ | Half-open range [min,max): includes min, excludes max. |
rangeFilters.width[].max | integer | いいえ | Upper bound. |
rangeFilters.width[].min | integer | いいえ | Lower bound. |
resourceId | string | はい | Available resource ID returned by the generation tool; reuse within the same task. |
返却内容
Sales rankings aggregated by representative ASIN, with brand, range, sorting, search and pagination controls.
課金ルール
5 Credits × ⌈返却代表 ASIN 数 / 5⌉ (切り上げ)
12 代表 ASIN → 15 Credits
get_category_market_size_trends
カテゴリの市場規模の傾向
ツールの説明
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.
入力パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
categoryId | string | はい | Category ID confirmed by the user. |
country | string | はい | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
resourceId | string | はい | Available resource ID returned by the generation tool; reuse within the same task. |
返却内容
Complete historical monthly sales trends across all price bands and the available last-30-day summary. Start/end month filters are not accepted.
課金ルール
5 Credits × ⌈履歴月数 / 6⌉ (切り上げ)
24 か月 → 20 Credits
get_category_new_release_opportunity_trends
新製品と既存の製品の傾向
ツールの説明
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.
入力パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
categoryId | string | はい | Category ID confirmed by the user. |
country | string | はい | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | はい | 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" | いいえ | Aggregation cycle. |
cycleFilter.endDate | string | いいえ | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | いいえ | Rolling period. |
cycleFilter.startDate | string | いいえ | Start date, YYYY-MM-DD. |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | いいえ | All, low, mid or high price bands; default: allPrice. |
resourceId | string | はい | Available resource ID returned by the generation tool; reuse within the same task. |
返却内容
New-release opportunity summary, list, complete trends and periods.
課金ルール
5 Credits × ⌈履歴月数 / 6⌉ (切り上げ)
24 か月 → 20 Credits
get_category_price_segment_trends
価格帯の市場動向
ツールの説明
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.
入力パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
categoryId | string | はい | Category ID confirmed by the user. |
country | string | はい | Amazon marketplace explicitly selected by the user, such as US, UK or DE. Do not assume a marketplace. |
cycleFilter | object | はい | One calendar month with cycle=monthly and both startDate/endDate, or period=last30days without dates. |
cycleFilter.cycle | "monthly" | "daily" | いいえ | Aggregation cycle. |
cycleFilter.endDate | string | いいえ | End date, YYYY-MM-DD. |
cycleFilter.period | "last30days" | いいえ | Rolling period. |
cycleFilter.startDate | string | いいえ | Start date, YYYY-MM-DD. |
resourceId | string | はい | Available resource ID returned by the generation tool; reuse within the same task. |
返却内容
Complete analysis and trends for low, mid and high price bands, including selected-period boundaries, brands, representative ASINs, ratings and finer price ranges.
課金ルール
5 Credits × ⌈履歴月数 / 6⌉ (切り上げ)
24 か月 → 20 Credits