Size and monitor a category

curl "https://api.unif.dev/v1/categories?market=US&depth=2" \
  -H "Authorization: Bearer $UNIF_API_KEY"

{
  "id": "cat_beauty_personal_care",
  "name": "Beauty & Personal Care",
  "level": 1,
  "metrics": {
    "revenue": 412800000.0,
    "units_sold": 18420000,
    "avg_unit_price": 22.41,
    "revenue_growth_rate": 0.18,
    "shops_count": 24180,
    "products_count": 486200,
    "creators_count": 92400
  },
  "children": [
    { "id": "cat_beauty_skincare", "name": "Skincare", "metrics": { "revenue": 164700000.0 } }
  ]
}

for cat in categories:
    m = cat["metrics"]
    cat["revenue_per_shop"]    = m["revenue"] / max(m["shops_count"], 1)
    cat["revenue_per_product"] = m["revenue"] / max(m["products_count"], 1)

opportunities = [
    c for c in categories
    if c["metrics"]["revenue_growth_rate"] > 0.15
    and c["revenue_per_shop"] > median_revenue_per_shop
]

parent = get_category("cat_beauty_personal_care", market="US", period="last_90d")
parent_growth = parent["metrics"]["revenue_growth_rate"]

for child in parent["children"]:
    delta = child["metrics"]["revenue_growth_rate"] - parent_growth
    child["share_shift"] = delta        # negative: losing share despite growing

curl "https://api.unif.dev/v1/categories/cat_beauty_skincare/timeseries?market=US&metrics=revenue,avg_unit_price,shops_count&granularity=week&period=last_180d" \
  -H "Authorization: Bearer $UNIF_API_KEY"

{
  "name": "Category shifts — US beauty subcategories",
  "source": {
    "type": "search",
    "entity_type": "shop",
    "search": {
      "market": "US",
      "period": { "preset": "last_30d" },
      "filters": {
        "category_ids": ["cat_beauty_skincare"],
        "revenue": { "gte": 250000 }
      }
    }
  },
  "schedule": "weekly",
  "webhook_id": "whk_01k3…fa"
}