Billing rules

MCP billing rules

Review Credit billing rules and usage examples for ASINSIGHT MCP tools.

Billing time

Credits are charged about 5–15 minutes after a call. Usage data may be briefly delayed; the final billing record is authoritative.

MCP tool billing

Usage is rounded up according to the amount of data queried or returned.

ASIN data

Tool	Data provided	Billing rule	Example
`get_asin_traffic` 7-day ASIN traffic score	Organic, sponsored, and total traffic scores, keyword count, traffic share, and period changes.	1 Credit per ASIN queried	3 ASINs cost 3 Credits
`get_asin_info` ASIN product information	Title, image, price, currency, rating, review count, and product URL.	1 Credit per ASIN queried	3 ASINs cost 3 Credits
`get_asin_keywords` 7-day ASIN keywords	Keywords, rankings, organic and sponsored traffic, traffic share, capture rate, and growth.	1 Credit per 20 keywords returned, rounded up	45 keywords cost 3 Credits
`get_asin_info_trends` Daily product information trends	Daily ratings, reviews, list price, sale price, Prime price, and promotion details.	1 Credit per 10 queried days, rounded up	21 days cost 3 Credits
`get_asin_info_change_trends` Product information change trends	Daily before-and-after records for title, main image, and other listing changes.	1 Credit per 10 queried days, rounded up	21 days cost 3 Credits
`get_asin_traffic_trends` Daily ASIN traffic trends	Daily organic and sponsored traffic scores and position-level traffic changes.	1 Credit per 10 queried days, rounded up	21 days cost 3 Credits
`get_asin_traffic_trends_weekly` Weekly ASIN traffic trends	Weekly organic, sponsored, and total traffic score changes.	1 Credit per 4 queried weeks, rounded up	18 weeks cost 5 Credits
`get_asin_traffic_trends_monthly` Monthly ASIN traffic trends	Monthly organic, sponsored, and total traffic score changes.	1 Credit per month queried	6 months cost 6 Credits
`get_asin_ad_change_trends` ASIN advertising change trends	Started and stopped campaigns, campaign IDs, names, and ad types.	1 Credit per 10 queried days, rounded up	21 days cost 3 Credits
`get_asin_bsr_trends` ASIN BSR trends	Category hierarchy, category names, and daily BSR rank changes.	1 Credit per 10 queried days, rounded up	21 days cost 3 Credits
`get_asin_orders` 30-day ASIN orders	Estimated orders for the latest 30 days.	1 Credit per 5 ASINs queried, rounded up	12 ASINs cost 3 Credits
`get_asin_order_trends` Monthly ASIN order trends	Monthly order estimates across the selected period.	1 Credit per 6 queried months, rounded up	7 months cost 2 Credits
`get_asin_variations` ASIN variation relationships	Parent ASIN, child ASINs, variation relationships, and update time.	Fixed 5 Credits per query	1 query costs 5 Credits
`get_asin_keywords_monthly` Monthly ASIN keywords	Monthly keywords, ranks, organic and sponsored traffic, traffic share, and capture rate.	1 Credit per 20 keywords returned, rounded up	45 keywords cost 3 Credits

Keyword data

Tool	Data provided	Billing rule	Example
`get_keyword_info` Keyword market metrics	Search volume, ABA rank, competition, click and conversion rates, bids, and top-ASIN shares.	1 Credit per 10 keywords queried, rounded up	12 keywords cost 2 Credits
`get_keyword_asin_analysis` 7-day keyword ASIN analysis	Competing ASINs, ranks, organic and sponsored traffic, shares, and product details.	1 Credit per 20 ASINs returned, rounded up	45 ASINs cost 3 Credits
`get_keyword_analysis_monthly` Monthly keyword competition	Monthly competing ASIN ranks, traffic, shares, and product details.	1 Credit per 20 ASINs returned, rounded up	45 ASINs cost 3 Credits
`get_keyword_aba_trends` Weekly keyword ABA trends	Report week, search-frequency rank, weekly search volume, and top-ASIN click and conversion shares.	1 Credit per 20 keyword-week data points, rounded up	5 keywords × 12 weeks cost 3 Credits

ASIN and keyword trends

Tool	Data provided	Billing rule	Example
`get_asin_keyword_traffic_trends` Daily ASIN-keyword traffic trends	Daily total, organic, and sponsored traffic for an ASIN-keyword pair.	1 Credit per 5 queried days, rounded up	12 days cost 3 Credits
`get_asin_keyword_rank_trends` Daily ASIN-keyword rank trends	Daily organic, sponsored, or recommended ranks for an ASIN-keyword pair.	1 Credit per 5 queried days, rounded up	12 days cost 3 Credits
`get_asin_keyword_rank_hourly` Hourly ASIN-keyword rank	Hourly placement, page, in-page rank, and total rank for a selected date.	Fixed 3 Credits per queried day	1 day (24 hours) costs 3 Credits

Category Insight resources

Tool	Data provided	Billing rule	Example
`search_market_insight_categories` Search categories by keyword or ASIN	Matching categories, IDs, hierarchy, paths, and availability by keyword or ASIN.	Free	1 search costs 0 Credits
`generate_category_insight_resource` Generate a Category Insight resource	An asynchronously generated Category Insight resource and resource ID.	500 Credits per successfully generated resource	1 resource costs 500 Credits

Category rankings

Tool	Data provided	Billing rule	Example
`get_category_sales_ranking_monthly` Monthly category sales ranking	Monthly child- or parent-ASIN sales ranking for a category.	5 Credits per 20 child ASINs or 5 parent ASINs returned, rounded up	50 child ASINs or 12 parent ASINs cost 15 Credits
`get_category_sales_ranking_yearly` Yearly category sales ranking	Yearly child- or parent-ASIN sales ranking for a category.	5 Credits per 20 child ASINs or 5 parent ASINs returned, rounded up	50 child ASINs or 12 parent ASINs cost 15 Credits
`get_category_new_release_ranking_monthly` Monthly new-release ranking	Monthly new-release child- or parent-ASIN ranking.	5 Credits per 20 child ASINs or 5 parent ASINs returned, rounded up	50 child ASINs or 12 parent ASINs cost 15 Credits
`get_category_new_release_ranking_yearly` Yearly new-release ranking	Yearly new-release child- or parent-ASIN ranking.	5 Credits per 20 child ASINs or 5 parent ASINs returned, rounded up	50 child ASINs or 12 parent ASINs cost 15 Credits
`get_category_surging_ranking_monthly` Monthly surging ranking	Monthly surging child- or parent-ASIN ranking.	5 Credits per 20 child ASINs or 5 parent ASINs returned, rounded up	50 child ASINs or 12 parent ASINs cost 15 Credits
`get_category_surging_ranking_yearly` Yearly surging ranking	Yearly surging child- or parent-ASIN ranking.	5 Credits per 20 child ASINs or 5 parent ASINs returned, rounded up	50 child ASINs or 12 parent ASINs cost 15 Credits

Category keyword analysis

Tool	Data provided	Billing rule	Example
`get_category_keyword_analysis` Category keyword analysis	Keyword-analysis summary for a category, month, and relevance level.	5 Credits per category queried	1 category costs 5 Credits
`get_category_keyword_search_volume_trends` Category keyword search-volume trends	Monthly search volume, keyword count, and period-over-period changes by relevance.	5 Credits per 6 queried months, rounded up	24 months cost 20 Credits
`get_category_keywords` Category keyword list	Monthly category keyword list, relevance, and numeric metrics.	1 Credit per 20 keywords returned, rounded up	50 keywords cost 3 Credits

Category market trends

Tool	Data provided	Billing rule	Example
`get_category_market_size_trends` Category market-size trends	Monthly category unit sales and revenue trends.	5 Credits per 6 queried months, rounded up	24 months cost 20 Credits
`get_category_seasonality` Category seasonality	Season definitions, peak/off-peak sales comparison, and a three-month forecast.	5 Credits per category queried	1 category costs 5 Credits
`get_category_new_release_opportunity_trends` New versus existing product trends	New versus existing product sales and product-count trends.	5 Credits per 6 queried months, rounded up	24 months cost 20 Credits
`get_category_price_segment_trends` Price-segment market trends	Monthly unit sales and revenue trends by price segment.	5 Credits per 6 queried months, rounded up	24 months cost 20 Credits

Category competition

Tool	Data provided	Billing rule	Example
`get_category_price_segment_asins` Price-segment ASIN list	Child-ASIN sales, revenue, shares, and product details within a price segment.	5 Credits per 20 child ASINs returned, rounded up	50 child ASINs cost 15 Credits
`get_category_price_segment_parent_asins` Price-segment parent ASIN list	Parent-ASIN sales, revenue, brand mix, and child-ASIN details within a price segment.	5 Credits per 5 parent ASINs returned, rounded up	12 parent ASINs cost 15 Credits
`get_category_brand_market_size` Brand market size	Brand-level unit sales, revenue, price, and rating.	5 Credits per 5 brands returned, rounded up	12 brands cost 15 Credits
`get_category_brand_sales_trends` Brand sales trends	Monthly unit sales and revenue trends for multiple brands.	Brand count × 2 Credits per 6 billing months; the latest 30 days count as one extra billing month	5 brands over 12 months plus the latest 30 days cost 30 Credits

Category rating analysis

Tool	Data provided	Billing rule	Example
`get_category_star_rating_distribution` Category star-rating distribution	ASIN count, sales, and share across star-rating ranges.	5 Credits per category queried	1 category costs 5 Credits
`get_category_rating_count_distribution` Category rating-count distribution	Product distribution across rating-count ranges.	5 Credits per category queried	1 category costs 5 Credits