Category Lens

What it does

Re-runs the e-commerce audit engine on a single product category: generates fresh questions per lane (comparison, recommendation, feature, alternative), runs them against the LLMs and returns citations, share of voice and category-specific competitive gaps.

When to use it

• When a category is performing oddly and you want to know why.
• To analyse a new product line before investing in copy/ads.
• In an agency setting, when the client asks for a sub-category focus.

Required inputs

• store_id (required): the active e-commerce store.
• category (required inside params): name of the category/product_type.
• audit_id (optional): defaults to the latest completed audit.

Example output

{
  "slug": "category-deep-dive",
  "store_id": "store-1",
  "artifact_ids": ["art-cat-1"],
  "payload": {
    "category": "shoes",
    "products_count": 24,
    "questions_by_lane": {"comparison": ["best shoes under 100?"]},
    "lane_results": {"citations": [{"domain": "wired.com"}], "share_of_voice": {}},
    "language": "it"
  }
}