{"openapi":"3.1.0","info":{"title":"Fediverse Statistics API","version":"1.0.0","description":"Live Fediverse statistics as an API — a read on the size and shape of the decentralised social web. The fediverse is the network of interoperable social platforms — Mastodon, Misskey, Pixelfed, Lemmy, PeerTube and dozens more — and this returns the network-wide totals (instances, users, posts and monthly active users), the breakdown by software (how many instances and users each platform runs, with its license, website and source repository, and the hosting providers it concentrates on), and the largest servers ranked by user count, with an optional filter to a single platform. The meta-social layer: not one platform's posts, but the whole federated network as clean JSON, served live from FediDB. Distinct from the single-platform Mastodon, Misskey, Mbin and Lemmy APIs — this is the cross-fediverse statistics layer for social, research and dashboard apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fediverse-api","description":"oanor gateway"}],"tags":[{"name":"Stats"},{"name":"Software"},{"name":"Servers"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/stats":{"get":{"operationId":"get_v1_stats","tags":["Stats"],"summary":"Network-wide fediverse totals","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total_posts":1596667299,"total_users":13349964,"last_updated":"2026-06-09T03:00:02+00:00","total_instances":42812,"monthly_active_users":1097954},"meta":{"timestamp":"2026-06-09T03:02:37.250Z","request_id":"1c5901f2-e593-48f0-8c42-81b6b67edbcd"},"status":"ok","message":"Stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/software":{"get":{"operationId":"get_v1_software","tags":["Software"],"summary":"Software breakdown, or one platform detail","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"A platform for full detail (e.g. mastodon)","schema":{"type":"string"},"example":"mastodon"},{"name":"limit","in":"query","required":false,"description":"Max platforms when listing (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Mastodon","slug":"mastodon","posts":979907529,"users":8574538,"license":"AGPL","website":"https://joinmastodon.org","instances":9011,"description":"Mastodon is an open source decentralized social network - by the people for the people","source_repo":"https://github.com/mastodon/mastodon","top_hosting":[{"provider":"OVH","instances":2999},{"provider":"Cloudflare","instances":1792},{"provider":"Hetzner","instances":1672},{"provider":"DigitalOcean","instances":660},{"provider":"Akamai Connected Cloud","instances":341}]},"meta":{"timestamp":"2026-06-09T03:02:37.754Z","request_id":"2fc4355b-8f46-4444-85d4-3a8f884ac34b"},"status":"ok","message":"Software retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/servers":{"get":{"operationId":"get_v1_servers","tags":["Servers"],"summary":"Largest servers by user count","description":"","parameters":[{"name":"software","in":"query","required":false,"description":"Filter to one platform","schema":{"type":"string"},"example":"lemmy"},{"name":"limit","in":"query","required":false,"description":"Max servers (1-40)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"servers":[{"rank":1,"posts":709278,"users":193391,"domain":"lemmy.world","version":"0.19.18-8-g5d8cbdd9d","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":13284},{"rank":2,"posts":133985,"users":34340,"domain":"sh.itjust.works","version":"0.19.18","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":2269},{"rank":3,"posts":63955,"users":20075,"domain":"lemmy.dbzer0.com","version":"0.19.15","location":{"country":"France"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":1310},{"rank":4,"posts":101197,"users":12899,"domain":"lemmy.ca","version":"0.19.18","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":1283},{"rank":5,"posts":26169,"users":12089,"domain":"programming.dev","version":"0.19.18","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":867},{"rank":6,"posts":92655,"users":10875,"domain":"lemmy.zip","version":"0.19.18","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":2081},{"rank":7,"posts":46933,"users":10417,"domain":"lemmy.blahaj.zone","version":"0.19.18","location":{"city":"Toronto","country":"Canada"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":923},{"rank":8,"posts":8364,"users":8625,"domain":"ttrpg.network","version":"0.19.18","location":{"city":"Nuremberg","country":"Germany"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":99},{"rank":9,"posts":4304,"users":7823,"domain":"lemmy.one","version":"0.19.7","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":false,"monthly_active_users":22},{"rank":10,"posts":27612,"users":7581,"domain":"discuss.tchncs.de","version":"0.19.18","location":{"city":"Helsinki","country":"Finland"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":733},{"rank":11,"posts":70402,"users":6133,"domain":"feddit.org","version":"0.19.18","location":{"city":"Vienna","country":"Austria"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":1497},{"rank":12,"posts":108617,"users":6012,"domain":"reddthat.com","version":"0.19.18","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":276},{"rank":13,"posts":67617,"users":5877,"domain":"sopuli.xyz","version":"0.19.18","location":{"city":"Falkenstein","country":"Germany"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":589},{"rank":14,"posts":26967,"users":4915,"domain":"infosec.pub","version":"0.19.18","location":{"city":"Falkenstein","country":"Germany"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":304},{"rank":15,"posts":17940,"users":4885,"domain":"lemmy.sdf.org","version":"0.19.11","location":{"city":"Seattle","country":"United States"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":160},{"rank":16,"posts":36668,"users":4736,"domain":"feddit.uk","version":"0.19.18-feddit","location":{"city":"Falkenstein","country":"Germany"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":343},{"rank":17,"posts":21906,"users":4212,"domain":"thelemmy.club","version":"0.19.17","location":{"city":"Manila","country":"Philippines"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":206},{"rank":18,"posts":11220,"users":3690,"domain":"startrek.website","version":"0.19.18","location":{"city":"Crestview","country":"United States"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":133},{"rank":19,"posts":14856,"users":3395,"domain":"lemmy.eco.br","version":"0.19.15","location":[],"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":65},{"rank":20,"posts":13184,"users":3340,"domain":"feddit.nl","version":"0.19.17","location":{"country":"The Netherlands"},"software":"Lemmy","software_slug":"lemmy","open_registration":true,"monthly_active_users":203}],"software":"lemmy"},"meta":{"timestamp":"2026-06-09T03:02:38.056Z","request_id":"f0f46a12-8a85-4195-85c1-d24da9802713"},"status":"ok","message":"Servers retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"FediDB public API (live)","service":"fediverse-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/stats":"Network-wide fediverse totals (instances, users, posts, MAU).","GET /v1/servers":"Largest servers by user count (limit up to 40, optional software= filter).","GET /v1/software":"Software breakdown ranked by users; add name=mastodon for one platform's detail."},"description":"Live Fediverse statistics from FediDB: network-wide totals (instances, users, posts, monthly active users), the breakdown by software (Mastodon, Misskey, Pixelfed, Lemmy, PeerTube and more — instances, users, license, source repo), and the largest servers ranked by users with an optional software filter. The meta-social layer for the decentralised social web. Live, no key. Distinct from single-platform Mastodon / Misskey / Mbin / Lemmy APIs — this is cross-fediverse statistics.","total_instances":42812},"meta":{"timestamp":"2026-06-09T03:02:38.257Z","request_id":"dcac35d3-57fe-4778-965e-c74984914eba"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":160000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1600,"monthly_call_quota":800000,"rps_limit":40,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":3900,"monthly_call_quota":4000000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fediverse-api"}