{"endpoint":"POST /api/atlas/usage","accepts":["application/json","text/csv","text/plain (format sniffed)"],"query":{"format":"'json' (default) or 'csv' for a spreadsheet-ready enriched export"},"limits":{"maxBodyBytes":1000000,"maxMarkets":400},"jsonContract":{"product":"Your product name","asOf":"2026-06-30","source":"your analytics dashboard","markets":[{"country":"US","mau":120000000,"dau":68000000,"revenue":88000000},{"country":"BR","mau":85000000,"dau":51000000,"note":"launched 2024"}]},"csvContract":"# product: Your product name\n# as_of: 2026-06-30\n# source: your analytics dashboard\ncountry,mau,dau,revenue,note\nUS,120000000,68000000,88000000,\nBR,85000000,51000000,12000000,\nJP,24000000,11500000,21000000,launched 2024\nDE,18500000,8200000,,revenue not tracked here\n","fieldNotes":{"country":"ISO-3166-1 alpha-2: the join key across Atlas. 'UK' is accepted as 'GB'.","mau":"Monthly active users. Accepts 12345, '12,345', '1.5M', '450k', '2.1B'. 0 is legal.","dau":"Daily active users, optional. DAU > MAU is kept but flagged.","revenue":"Monthly revenue for the market in USD, optional (aliases: monthly_revenue, revenue_usd, rev, mrr). Same period as MAU; no currency conversion is attempted. Same count formats as mau, leading '$' tolerated. Negative revenue drops the row; revenue with zero MAU is kept but flagged (no ARPU).","note":"Optional free-form annotation (≤200 chars), carried through."},"derivedMetrics":{"stickiness":"DAU ÷ MAU","penetrationOnline":"MAU ÷ addressable online population (World Bank internet users)","penetrationPop":"MAU ÷ total population (CLDR)","headroomOnline":"max(0, online population − MAU): the audience you haven't reached","arpu":"revenue ÷ MAU (monthly USD per user); null when revenue is absent or MAU is 0","revenueOpportunityOnline":"headroomOnline × ARPU: the unreached audience valued at this market's current ARPU. null unless both terms exist. Display-only: launch-planner scoring never reads it.","languages":"Each market's MAU apportioned across its languages by normalized CLDR L1+L2 share: a prioritization model, not measurement."},"templates":{"csv":"/atlas/usage-template.csv","sampleJson":"/atlas/usage-sample.json"},"docs":"docs/ATLAS.md in the repository"}