Category
commerce.categoryUnifiedSoonA node in the Amazon, TikTok, Google or GS1 category tree.
key taxonomy + code2 planned calls6 Direct endpoints today
2 calls plannedSoon
Calls from commerce API design 0.1.0-draft, written as REST paths. Each call returns this entity in one shape on the platforms it lists, and none is deployed yet.
- GET
/Search or browse one platform's category treeTikTok Shop · AmazonDesignedv1/ e-commerce/ categories/ search - GET
/Sales and GMV of a category, whole and sample figures kept apartTikTok Shop · AmazonDesignedv1/ e-commerce/ categories/ {categoryId}/ statistics
66 fields in the field contractDesign 0.1.0-draft · listing-contract-v3.2
Field keys and how each value is written, as the design defines them. Only fields a source actually returned come back.
Identity6
AIsa's ID, the platform, the site and the platform's own IDentity.iduuidentity.kindstringentity.platformstringentity.scopestringentity.namespacestringcategory.native_idstring
Profile5
Details the platform publishes about itcategory.namestringcategory.earliest_product_listed_date_rawstringcategory.latest_product_listed_date_rawstringcategory.leading_seller_country_codestringcategory.leading_seller_country_labelstring
Metrics52
Sales, GMV and engagement, each over its source's periodmetrics.sales_countdecimalmetrics.gmvdecimalmetrics.sales_count_30ddecimalmetrics.gmv_30ddecimalmetrics.product_count_reporteddecimalmetrics.sample_product_countdecimalmetrics.seller_count_reporteddecimalmetrics.brand_count_reporteddecimalmetrics.sample_avg_seller_count_reporteddecimal
Show 43 more fieldsShow fewer
metrics.top_n_sample_product_countdecimalmetrics.sample_avg_sales_count_30ddecimalmetrics.sample_avg_sales_amount_30ddecimalmetrics.sample_avg_price_reporteddecimalmetrics.sample_avg_rating_score_reporteddecimalmetrics.sample_avg_rating_count_reporteddecimalmetrics.sample_avg_review_count_change_30ddecimalmetrics.sample_avg_bsr_reporteddecimalmetrics.sample_avg_profit_rate_reporteddecimalmetrics.sample_avg_weight_gdecimalmetrics.sample_avg_volume_cm3decimalmetrics.top_n_avg_sales_count_30ddecimalmetrics.top_n_avg_sales_amount_30ddecimalmetrics.top_n_avg_price_reporteddecimalmetrics.top_n_avg_rating_score_reporteddecimalmetrics.top_n_avg_rating_count_reporteddecimalmetrics.top_n_avg_review_count_change_30ddecimalmetrics.top_n_avg_bsr_reporteddecimalmetrics.new_product_count_reporteddecimalmetrics.new_product_share_reporteddecimalmetrics.new_product_avg_sales_count_30ddecimalmetrics.new_product_avg_sales_amount_30ddecimalmetrics.new_product_avg_price_reporteddecimalmetrics.new_product_avg_rating_score_reporteddecimalmetrics.new_product_avg_rating_count_reporteddecimalmetrics.new_product_min_rating_count_reporteddecimalmetrics.new_product_max_rating_count_reporteddecimalmetrics.fba_share_reporteddecimalmetrics.fbm_share_reporteddecimalmetrics.amazon_retail_share_reporteddecimalmetrics.a_plus_share_reporteddecimalmetrics.return_rate_reporteddecimalmetrics.category_avg_return_rate_reporteddecimalmetrics.search_to_purchase_ratio_reporteddecimalmetrics.leading_seller_country_share_reporteddecimalmetrics.sample_avg_sales_countdecimalmetrics.sample_avg_sales_amountdecimalmetrics.sample_avg_review_count_changedecimalmetrics.top_n_avg_sales_countdecimalmetrics.top_n_avg_sales_amountdecimalmetrics.top_n_avg_review_count_changedecimalmetrics.new_product_avg_sales_countdecimalmetrics.new_product_avg_sales_amountdecimal
Links2
AIsa IDs of the entities it points atrelated.parent_categoriesuuid[]related.listingsuuid[]
Context1
The currency every money field usescontext.currencystring
decimal and integer values arrive as strings to keep precision. A key ending in _reported is the source's own figure, method unconfirmed; _raw keeps the source's raw code. uuid fields point at other AIsa entities.
Fields AIsa adds on topDraft · not in the design
Estimates, checks and risk lists from other sources, planned to come back in the same response.
Estimated
One estimator by default, or two to three side by sidemapped_toCategory[]EstimatedNodes in other taxonomies, with a confidence score
Call it today through DirectLive
Vendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
6 endpoints from 2 APIs · from $0.001
| API | Method | Path | Endpoint | Price |
|---|---|---|---|---|
| TikHub | GET | tikhub/tiktok/shop/web/fetch_products_by_category_id | tiktok web/fetch_products_by_category_id | from $0.001 |
| DataForSEO | GET | dataforseo/dataforseo_labs/google/categories_for_domain/live | Categories For Domain | from $0.14 |
| TikHub | GET | tikhub/tiktok/shop/web/fetch_products_category_list | tiktok web/fetch_products_category_list | from $0.001 |
| DataForSEO | GET | dataforseo/keywords_data/google_trends/categories | List of Google Trends Categories | from $0.012 |
| DataForSEO | GET | dataforseo/dataforseo_labs/google/categories_for_keywords/live | Categories for Keywords | from $0.14 |
| DataForSEO | GET | dataforseo/dataforseo_labs/google/keywords_for_categories/live | Keywords For Categories | from $0.14 |
Next to Category
Each link is a field you can ask for in the same call.