---
title: "Recommended actions for one shop"
method: POST
path: "/weekly-report/recommendations"
tags: ["Weekly Report"]
---

# Recommended actions for one shop

`POST /weekly-report/recommendations`

The recommended-actions block of the weekly report on its own — cheaper than the full report when that is all you need.

Each action carries a ``type`` (e.g. reactivate_creators, amplify_videos, prioritize_products), a headline ``title``, a one-line ``description``, and the ``items`` it refers to (creator, video or product, each with a display label, image and a formatted metric). Generation is rule-based over the same top-N data the report uses.

Single-shop only — set ``x-shop-id`` to a specific shop ID. The window defaults to the last 7 settled days and is capped at 90 days. An empty ``actions`` list is a normal 200 for a shop with no qualifying activity.

## Request body

- WeeklyReportBody — Window for the single-shop report endpoints.
  - `start_date` string, date, nullable — First day of the window (inclusive). Defaults to 7 days before ``end_date``.
  - `end_date` string, date, nullable — Last day of the window (inclusive). Must be at least 1 day in the past — today is never fully settled. Defaults to yesterday.

## Response `200`

Successful Response

- RecommendedActionsResponse — Response model for /api/weekly-report/recommendations.
  - `shop_id` integer, required
  - `actions` RecommendedAction[]
    - `type` string, required
    - `title` string, required
    - `description` string, required
    - `items` RecommendedActionItem[]
      - `id` string, required
      - `label` string, required
      - `image_url` string, nullable
      - `metric_label` string, nullable
      - `deep_link` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/d4fe3e380424/schema)