Endpoints

Write the store page

The words of the store page for Google Play and the App Store, written from what the app screens say.

POSThttps://www.setherion.com/api/v1/projects/{id}/store/listing

Plan: Pro and up

Writes the words of the app's store page in one go, for both stores: the name, Google Play's short and full descriptions, and the App Store's subtitle, keywords and promotional text. It is the same work as the Write it button in the "Publish to app stores" window, with the same plan rule, the same price and the same payer.

The words come from what the app's screens say, in the language of those screens. The writer is told never to invent a feature, a price, a rating or a number of users, and not to name the stores or the tool the app was made with.

You need to be able to edit the app, because this spends its credits. Nothing is saved: show the owner the words to copy into Play Console and App Store Connect.

Cost and plan

  • Credits. A few, charged before the work, to the account that pays for the app. The answer's charged field says how many were taken. If no usable page came out, they are given back.
  • Plan. Pro or Business, of the account that pays for the app. On Free the call answers 402.
  • Pace. The same hourly ceiling as the editor's other small AI actions, 600 an hour per account. A person never reaches it.

Request

No body is needed.

bash
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store/listing \
  -H "Authorization: Bearer $SETHERION_API_KEY"

It takes up to about two minutes. Set your client's timeout to at least 2 minutes.

Response

json
{
  "ok": true,
  "language": "en",
  "charged": 2,
  "limits": {
    "name": 30,
    "googleShort": 80,
    "description": 4000,
    "appleSubtitle": 30,
    "appleKeywords": 100,
    "applePromo": 170
  },
  "texts": {
    "name": "Coffee Shop",
    "googleShort": "Order your coffee and cake ahead and skip the queue.",
    "description": "Coffee Shop is for anyone in Leeds who wants a good coffee without waiting. Browse the menu, choose what you like and collect it when it is ready.\n\n• Browse the full menu with prices\n• Order ahead for collection\n• See the opening hours\n• Find the shop on the map\n\nPick your favourite and skip the queue.",
    "appleSubtitle": "Order ahead, skip the queue",
    "appleKeywords": "coffee,cafe,order ahead,takeaway,cake,Leeds",
    "applePromo": "Your morning coffee, ready when you arrive. Open the menu, order ahead and collect it without waiting."
  }
}
FieldTypeMeaning
languagestringThe language code the words are written in, read from the app's screens.
chargednumberThe credits taken. 0 when the credit ledger could not be reached and the call was let through.
limitsobjectThe most characters each field may have. These are the stores' own.
textsobjectThe words. Every field is always present.

The fields of texts

FieldWhere it goesLimit
nameThe app's name in both stores30 characters
googleShortGoogle Play, short description80 characters
descriptionThe full description, the same for both stores4,000 characters
appleSubtitleApp Store, subtitle30 characters
appleKeywordsApp Store, keywords, separated by commas with no spaces100 characters
applePromoApp Store, promotional text170 characters

Every field is cut to its limit at a whole word, because a store console refuses a field over its limit and a model counts characters badly. The keywords are cleaned too: each appears once, and none repeats a word of the name. The full description is plain text, with the main things people can do one per line, each starting with •.

Errors

StatusWhen
401The key is missing, wrong or revoked.
402The account that pays for the app is on Free, or has no credits left, or a workspace limit on you has been reached.
404There is no such app, or your key cannot edit it.
409The app has no code yet. Build it in Setherion first.
429More than 600 small AI actions in the last hour on this account.
500The writer's answer could not be used. Nothing is charged: the credits are given back. Try again.
503The limiter is briefly unavailable, so nothing was run. Try again in a minute.
The exact sentences
Statuserror
402Writing the store page is part of the Pro plan.
402This costs 2 credits and you have 1.
402This app's owner has no credits left this month.
402You have used the credits this workspace allows you this month. Ask an admin to raise your limit.
404No such app on this account.
409This app has no code yet. Build it in Setherion first.
429Too many AI actions in the last hour. Try again later.
500The model did not answer with the store page.
500The model's answer was cut off or not readable.
500The model left out: appleKeywords.
503Usage limits are briefly unavailable, so this was not run. Try again in a minute.

The first 402 is for Free. The number in the second is the price and your balance; on someone else's app you get the third sentence instead, which never names their balance. The 500 rows are examples: the sentence names what went wrong, and the credits are given back.

Was this page helpful?

Join the community

Questions, ideas and what others are building.