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.
https://www.setherion.com/api/v1/projects/{id}/store/listingPlan: 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
chargedfield 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.
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
{
"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."
}
}| Field | Type | Meaning |
|---|---|---|
language | string | The language code the words are written in, read from the app's screens. |
charged | number | The credits taken. 0 when the credit ledger could not be reached and the call was let through. |
limits | object | The most characters each field may have. These are the stores' own. |
texts | object | The words. Every field is always present. |
The fields of texts
| Field | Where it goes | Limit |
|---|---|---|
name | The app's name in both stores | 30 characters |
googleShort | Google Play, short description | 80 characters |
description | The full description, the same for both stores | 4,000 characters |
appleSubtitle | App Store, subtitle | 30 characters |
appleKeywords | App Store, keywords, separated by commas with no spaces | 100 characters |
applePromo | App Store, promotional text | 170 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
| Status | When |
|---|---|
401 | The key is missing, wrong or revoked. |
402 | The account that pays for the app is on Free, or has no credits left, or a workspace limit on you has been reached. |
404 | There is no such app, or your key cannot edit it. |
409 | The app has no code yet. Build it in Setherion first. |
429 | More than 600 small AI actions in the last hour on this account. |
500 | The writer's answer could not be used. Nothing is charged: the credits are given back. Try again. |
503 | The limiter is briefly unavailable, so nothing was run. Try again in a minute. |
The exact sentences
| Status | error |
|---|---|
402 | Writing the store page is part of the Pro plan. |
402 | This costs 2 credits and you have 1. |
402 | This app's owner has no credits left this month. |
402 | You have used the credits this workspace allows you this month. Ask an admin to raise your limit. |
404 | No such app on this account. |
409 | This app has no code yet. Build it in Setherion first. |
429 | Too many AI actions in the last hour. Try again later. |
500 | The model did not answer with the store page. |
500 | The model's answer was cut off or not readable. |
500 | The model left out: appleKeywords. |
503 | Usage 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?
