{"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"},{"name":"Network"}],"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's detail","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"A software slug for one platform's detail","schema":{"type":"string"},"example":"mastodon"},{"name":"limit","in":"query","required":false,"description":"Max results (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/server":{"get":{"operationId":"get_v1_server","tags":["Servers"],"summary":"Live NodeInfo for any server, read directly from it","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"A fediverse server domain","schema":{"type":"string"},"example":"mastodon.social"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live NodeInfo for one fediverse server, read directly from the server (not the FediDB aggregate) — so it works for any ActivityPub server, including small or new ones FediDB doesn't track, and is as fresh as the server reports. users_total is registered accounts; active_month/active_halfyear are active users; local_posts is statuses posted on this server. Some servers omit active counts (null). Pass domain (e.g. mastodon.social).","domain":"mastodon.social","source":"NodeInfo (live, direct from the server)","version":"4.6.0-nightly.2026-06-12","software":"mastodon","node_name":"Mastodon","protocols":["activitypub"],"server_url":"https://mastodon.social","local_posts":177681098,"users_total":3307019,"active_month":273548,"active_halfyear":713385,"node_description":"The original server of Mastodon, operated by Mastodon GmbH for the common good.","open_registrations":true},"meta":{"timestamp":"2026-06-13T14:10:42.291Z","request_id":"89d6ab03-4027-4bf9-aab1-2e1da9ef5e8e"},"status":"ok","message":"Server NodeInfo 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":"limit","in":"query","required":false,"description":"Max results (1-40)","schema":{"type":"string"},"example":"20"},{"name":"software","in":"query","required":false,"description":"Filter to one platform","schema":{"type":"string"},"example":"mastodon"}],"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"}