AgentLayer▸docs
Connect it

App Store

Any app's App Store reviews, newest first, from Apple's public feed. No key and read-only; the agent never replies to a review. In a helpdesk queue, the bugs they report become cards beside its tickets.

The App Store pack gives the agent one tool, appstore_reviews, that reads the reviews of any app on the App Store, yours or anyone else's. Ask in plain words: "show the latest App Store reviews for apps.apple.com/us/app/acme-notes/id1234567890", "what did the 1- and 2-star reviews say this month", "how is the new version being received".

It reads Apple's public review feed, and it never replies to a review.

What it gives you

Each reviewRating, title, text, the reviewer's nickname, the app version, the date and the storefront
RatingsHow many reviews got each star rating in the window
CoverageWhich storefronts had reviews, how many had none, and any that failed
throughThe moment of the read, so a later one can start exactly there

Pass a link (apps.apple.com/…/id1234567890) or the numeric id, and optionally a window (7d, 3m, any, or a date), star filters and a limit. A limit of 0 returns the ratings and coverage with no review text, which is how sync counts reviews without reading them.

What it needs

Nothing. There is no key and no Apple account involved, and it costs nothing.

Switch it on

Run configure-skills and pick App Store. It grants the one tool. Check it with "show the latest App Store reviews for" and an app's link. To read an app's reviews beside its support tickets, see In a helpdesk queue.

Storefronts

Reviews are kept per country, and there's no global feed, so a read is per storefront. You don't have to list countries:

  1. The first read of an app sweeps all 183 storefronts, US first. That takes about a minute and a half.
  2. After that the agent reads the storefronts that have produced reviews, plus 15 others in rotation, so a market that starts reviewing is found within a few reads.
  3. A full sweep runs again once a month.

What it learns lives in .state/appstore/<id>.json in your home. Name countries to narrow a read (storefronts: [us, gb]), or pass ['all'] for a full sweep.

When the feed comes back short

Apple's feed keeps roughly the 500 most recent reviews per storefront, and it answers many requests with an empty page: on some days most of them. Its cache then keeps that empty answer for minutes. The tool works around what it can and says what it couldn't.

It retries blank pages, never reports a count it didn't get, and names the storefronts that stayed blank so the next read starts from the last complete one.

In a helpdesk queue

Add the app to a queue profile and the helpdesk reads its reviews beside the tickets:

---
statuses: [Open, Awaiting agent reply]
appstore: 1234567890
---

helpdesk reviews acme reads the reviews since the last complete read and turns the bugs they report into cards:

  1. It reads every review for a bug, whatever its stars: people who love an app still leave five stars when something breaks.
  2. Reviews that describe the same break become one group.
  3. For each group it gathers what's already known: open and closed cards, tickets that mention it, older reviews of the same break, and planned tasks.
  4. It offers one card that carries them all, or a comment on the card already open for it. The profile's ## Raising rules still apply, such as which versions a card may come from.

A card quotes each review with its rating, version, country and date, never the reviewer's nickname, and lists its tickets as links. One with no ticket is titled (App Store reviews). The pulse sends its review groups through the same steps, and sync counts the day's reviews by star and offers helpdesk reviews acme when new ones arrived. Nothing replies to a review, from the helpdesk or anywhere else.

Where it's used

  • Helpdesk: the pulse and helpdesk reviews read an app's reviews when its queue profile names the app.
  • Sync: counts the day's reviews by star without reading them.

On this page