threefold docs
threefold is a market-entry library for app builders and their agents. It answers two families of question: what is different there (how apps like yours look, rank and advertise in another market) and is my app ready for there (the i18n readiness check and market resources).
Quickstart
- Connect. Add
https://api.threefold.eco/mcpto your MCP client, or runnpx threefold mcp install. See Install and connect. - Ask your agent. Ask your agent a market question, such as "What wins in fitness apps in Japan compared to the US?"
- Inspect the evidence. The agent calls the
markettool with{ "market": "jp", "genre": "health-fitness", "vs": "us" }and returns a concise markdown digest with citations and a link to view the evidence on threefold.eco (see Agent tools).
No account? Use https://api.threefold.eco/mcp?keyless=1, or call the REST API without a key:
curl "https://api.threefold.eco/api/compare?from=es&to=mx&niche=finance"What is in these docs
| Section | For |
|---|---|
| MCP server | Tools, sign-in, structured results and cost metadata |
| REST API and API reference | Routes, auth, headers, paging, the OpenAPI document |
| CLI and SDKs | Terminal and TypeScript or Python |
| i18n readiness check | The local check, verdicts and the CI gate |
| Market resources | Glossary, variant lint, listing check, price points, launch checklist, translate |
| Visual answers | Screenshot galleries, previews and collections |
| Watches | Change alerts by webhook or email |
| AI analyses | Model-written explanations and briefs |
| Data and freshness | Sources, coverage, refresh and retention |
| Accounts and keys | Sign-in, keys, scopes, OAuth, plans, enterprise features |
| Errors | The closed set of error codes |
Coverage at a glance
- Markets: United Kingdom (
gb), United States (us), Spain (es), Mexico (mx), Argentina (ar), Brazil (br), Germany (de), France (fr), Japan (jp), South Korea (kr). Each has a language variant (es-MX, not justes), market-native channels and a monetisation profile. - Niches:
games,education,health-fitness,finance,productivity,lifestyle(the App Store genres; meditation is underhealth-fitness). - Stores: App Store (
ios, the default) and Google Play (play). - Pillars: Brand (listings, charts, reviews), Paid (ad libraries) and Organic (creator posts). Paid and Organic need supplier connections that are not live yet; until then those answers are live links, filtered by country. See Data and freshness.
Machine-readable entry points
- OpenAPI 3.1: https://api.threefold.eco/openapi.json
llms.txt: https://api.threefold.eco/llms.txt- Task search:
GET https://api.threefold.eco/api/discover?q=<task> - Status: https://api.threefold.eco/status