Edit Market Corpus
edit_market_corpusDestructive
Add terms to one storefront's corpus, or take terms out of it. Add for a term the corpus SHOULD hold and does not — a rival's brand, a phrase Apple has never measured the popularity of, the term a thin storefront is really about; a pinned term is kept through every rebuild and refreshed on the same 72-hour cadence as the rest. Remove for a term that does not belong: ANY term can go, and one the heuristic found is also kept out of future rebuilds rather than returning within 72 hours. This is NOT save_market: seeds are what the corpus is expanded FROM and changing one re-runs the whole heuristic over that storefront, where these two writes act on single terms in the result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| add | No | Terms to pin, as somebody would type them into the App Store. Send the batch in one call. Terms already in the corpus come back under `already_present` rather than as an error. | |
| remove | No | Keyword ids to take out of the corpus — the `keyword_id` on ANY get_market corpus row. A term the heuristic found is also recorded as excluded so rebuilds do not re-derive it; `add` on the same term later clears that again. | |
| country | Yes | Which storefront's corpus, ISO 3166-1 alpha-2 (e.g. US, DE). Required and not defaulted: a corpus belongs to one storefront, and there is no market-wide term list to add to. | |
| market_id | Yes | Apptail market id — from list_markets or save_market. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | Yes | The most terms this storefront may hold, from the account's plan. A market's storefronts each get their own — the cap is per storefront, not shared across the market. | |
| terms | Yes | How many terms this storefront's corpus holds now. | |
| pinned | Yes | Terms added to the corpus by this call, with `origin: "manual"`. A term Apptail has never seen is created and queued for crawling, so its ranks appear within minutes rather than immediately. | |
| caveats | Yes | What the caller needs to hear before reporting success — that ranks are not in yet, or that the cap cut the list. | |
| country | Yes | The storefront that was edited. A corpus belongs to one storefront and is never shared between them. | |
| refused | Yes | Terms not added because the storefront is at `cap`. Unpin something or drop a storefront; the account's plan sets the number. | |
| removed | Yes | Keyword ids taken out of the corpus by this call. | |
| excluded | Yes | The subset of `removed` that will ALSO be kept out of every future rebuild. A term the heuristic found is re-derived from the seeds every 72 hours, so removing it has to be recorded outside the corpus to last; a hand-pinned term needs no such record because nothing re-adds it. Pinning a term with `add` clears it from this list again. | |
| market_id | Yes | The market this corpus belongs to. | |
| console_url | No | This market's corpus in the console. | |
| not_removed | Yes | Ids that were sent to `remove` and are still in the corpus, each with the reason. | |
| already_present | Yes | Terms that were already in this corpus, and where they came from. Not an error — it is the state the caller asked for, and a `competitor` term is NOT re-recorded as `manual`, because the origin says who put the term here. |