---
title: "This week's listing suggestions for the app — the same list as the dashboard's \"This week\" card, best first"
method: GET
path: "/apps/{appId}/weekly-plan"
tags: ["Apps"]
---

# This week's listing suggestions for the app — the same list as the dashboard's "This week" card, best first

`GET /apps/{appId}/weekly-plan`

## Request

- Base URL: `https://storelift.net/v1`
- URL: `https://storelift.net/v1/apps/{appId}/weekly-plan`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

This week's listing suggestions for the app — the same list as the dashboard's "This week" card, best first. A suggestion only appears when it passes strict checks: a keyword goes into the title or subtitle only if it is a core, high-demand term of the app's niche, the app already ranks #4–15 for it, rival apps above carry it in their name and it fits without dropping the brand or anything that ranks; niche or long-tail keywords go to the keyword field at most, only when there is room; other categories, other languages and keywords the user turned down never appear; nothing is suggested while a recent listing change is still settling (settling says until when). Each task has the sentence, the current and proposed text, the words it adds and removes, the reasons (measured facts), the trade-off and a confidence. Without country, all storefronts are merged and the same change is one task with its countries. Often empty — that is on purpose.

## Path parameters

- `appId` string, required

## Query parameters

- `country` string
- `goal` 'downloads' | 'rank' | 'revenue'
- `platform` 'ios' | 'android'
- `limit` integer

## Response `200`

OK

- object
  - `app` unknown, required
  - `country` unknown, required
  - `platform` unknown, required
  - `goal` unknown, required
  - `measuredAt` unknown, required
  - `popularityWeek` unknown, required
  - `total` unknown, required
  - `settling` unknown, required
  - `tasks` unknown, required

## Other responses

- `400`: A parameter is missing or malformed.
- `401`: No key, or the key is not valid.
- `402`: This month's credits are used up.
- `403`: The key's plan or scopes do not cover this call.
- `404`: No such app, or Storelift has not measured it yet.
- `429`: Too many requests.

---

[API](https://skmtc.dev/storelift/apis/storelift-api.md) · [All operations](https://skmtc.dev/storelift/apis/storelift-api/llms.txt) · [OpenAPI document](https://skmtc.dev/storelift/apis/storelift-api/revisions/4489f2d077a4?raw)