Overview
With an App Store or Google Play account connected, you choose which apps Spek works on and which markets it works in. Both are editable later, so neither decision is permanent.
A market is one storefront and one language, and it is the unit everything else in Spek is scoped to.
Pick an app
For App Store Connect, Spek reads the app catalog that credential can see and lists it. Each row shows the app's icon, its name and the store it came from, with a Connect button that turns into Connected once it is done. Connect all takes everything in the list.
You choose from the list rather than typing anything in, so there is no way to mistype an identifier or connect an app you do not have access to.
If the App Store app you expect is missing, the credential's role probably cannot see it. App Store account access is covered in connect App Store Connect.
Choose your markets
A market belongs to a store, country and language, such as the German App Store or Google Play listing in German. You choose which markets the agent works on when you set it up.
The agent can open new App Store localizations before drafting for them, so you are not limited to the languages your listing already has.
Start with two or three markets you actually care about. Each one is researched independently, so ten markets is ten times the research and ten times the review. You can add more later without redoing anything.
One market at a time
Search rankings are computed per storefront. A keyword that is easy in Turkey can be impossible in the United States, and the words people actually search differ even between two markets that share a language.
So Spek researches every market using only that market's own store, in its own language. US search volume is never used to justify a German keyword, and a translation is never treated as research.
- Each market gets its own keyword set, local evidence for your tracked competitors and its own rankings.
- There is no combined score across markets, because there is no such thing to measure.
- A change that helps one storefront can do nothing in another, and that is normal.
Adding more apps later
Add another app at any time from the app switcher in the sidebar. Each app carries its own agent configuration, its own markets and its own competitors, so setting up a second app does not disturb the first.
Common questions
My app is not in the list.
For App Store Connect, the key's role cannot see it, or it is not in the account the key belongs to. Check the role in App Store Connect, then reconnect.
Also confirm the selected workspace and connected developer account. Similar app names can appear in different accounts, so check the store identity instead of choosing a substitute. If the app is still missing, report which account and app you expected without sending the private key.
Can I connect more than one app?
Yes. Use Connect all to take everything in the list, or connect them one at a time and press Continue when you are done. Each app keeps its own agent configuration, markets and competitors.
How many markets should I start with?
Two or three. Each is researched independently, so the review load grows with the count, and the first pass teaches you more than breadth does.
How can I avoid connecting an app from the wrong account?
Check the selected workspace, connected store account and app listing before pressing Connect. Similar names are common across test apps, regional listings and client portfolios, so use the store identity and account context as well as the visible name. For App Store Connect, the list comes from the apps the selected credential can access. If the expected app is missing, investigate that account's access rather than connecting a similarly named app as a placeholder. Each connected app receives its own configuration and review work.
How should I choose the first markets for an app?
Choose markets where you understand the audience and can review the resulting language. Existing customers, launch priorities and available localization support are useful inputs to your decision. A small initial scope helps you evaluate the research and listing changes before expanding the work. Treat the store, country and language as part of the choice: the same English phrase can have a different audience or competitive context in another storefront. Your selected markets define where you should interpret the resulting proposals and rankings.
Does adding an app also create a new store listing?
Connecting an app selects an existing app available through your store account; it is not a replacement for creating the app and its required records with the store. Spek reads the connected app's context so you can configure research and review listing drafts. Later actions, such as opening an App Store localization or publishing metadata, have their own provider effects and controls. Check the action's exact purpose instead of treating every setup button as a purely local preference.
What should I review after connecting a second app?
Confirm its Agent setup, selected markets and competitor list independently of the first app. Two apps from the same team may serve different audiences and need different wording, even when their visual branding is similar. Check the app switcher before reviewing proposals or editing a listing, and give colleagues enough context to know which app a shared task concerns. Existing work on another app remains separate; connecting a new app does not make its drafts, competitors or ranking history interchangeable with the rest of the portfolio.