{"openapi":"3.1.0","info":{"title":"Flathub API","version":"1.0.0","description":"The Linux desktop-app store — Flathub (Flatpak) — as an API. Look up any app by its reverse-DNS id for its name, summary and description, developer, license, categories, homepage / bug-tracker / donation links, latest version and release date, screenshot count and total install count; search the whole store by keyword; and read an app's install statistics, including last-month and last-7-day installs and the top countries. Every app comes with the exact `flatpak install` command. Covers the Linux desktop from Firefox, Blender, GIMP, OBS Studio and Inkscape to VLC, Krita and LibreOffice. Live from the official flathub.org API. Ideal for app catalogs and dashboards, software-center integrations, Linux developer tooling and install-analytics. Open data from Flathub.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/flathub-api","description":"oanor gateway"}],"tags":[{"name":"Flathub"},{"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/app":{"get":{"operationId":"get_v1_app","tags":["Flathub"],"summary":"App metadata + install count","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Flatpak app id (reverse-DNS), e.g. org.mozilla.firefox","schema":{"type":"string"},"example":"org.mozilla.firefox"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"app":{"id":"org.mozilla.firefox","help":"https://support.mozilla.org/","name":"Firefox","install":"flatpak install flathub org.mozilla.firefox","license":"MPL-2.0","summary":"Fast, Private & Safe Web Browser","donation":"https://donate.mozilla.org/","homepage":"https://www.mozilla.org/firefox/","keywords":["Browser","Explorer","Internet"],"developer":"Mozilla","bugtracker":"https://bugzilla.mozilla.org/","categories":["Network","WebBrowser"],"description":"When it comes to your life online, you have a choice: accept the factory settings or put your privacy first. When you choose Firefox as your default browser, you’re choosing to protect your data while supporting an independent tech company. Firefox is also the only major browser backed by a non-profit fighting to give you more openness, transparency and control of your life online. Join hundreds of millions of people who choose to protect what's important by choosing Firefox - a web browser designed to be fast, easy to use, customizable and private.","flathub_url":"https://flathub.org/apps/org.mozilla.firefox","installs_total":11464201,"latest_version":"151.0.2","is_free_license":true,"screenshot_count":3,"installs_last_month":187942,"latest_release_date":"2026-05-25"}},"meta":{"timestamp":"2026-05-31T13:49:01.556Z","request_id":"5423d815-7c1d-4b7c-bd64-3933807f50e6"},"status":"ok","message":"App retrieved","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/search":{"get":{"operationId":"get_v1_search","tags":["Flathub"],"summary":"Search the store","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"blender"},{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"blender","results":[{"name":"Blender","app_id":"org.blender.Blender","license":"GPL-3.0","summary":"Free and open source 3D creation suite","developer":"Blender Foundation","categories":[],"flathub_url":"https://flathub.org/apps/org.blender.Blender","installs_last_month":26892},{"name":"Bforartists","app_id":"de.bforartists.Bforartists","license":"GPL-3.0","summary":"Blender but with a UX for artists","developer":"Bforartists","categories":[],"flathub_url":"https://flathub.org/apps/de.bforartists.Bforartists","installs_last_month":689},{"name":"UPBGE","app_id":"org.upbge.UPBGE","license":"GPL-3.0-only","summary":"UPBGE is a free and open source 3D Game Engine integrated in Blender","developer":"UPBGE Community","categories":[],"flathub_url":"https://flathub.org/apps/org.upbge.UPBGE","installs_last_month":392},{"name":"OpenSCAD","app_id":"org.openscad.OpenSCAD","license":"GPL-3.0+","summary":"The Programmers Solid 3D CAD Modeller","developer":"The OpenSCAD Developers","categories":[],"flathub_url":"https://flathub.org/apps/org.openscad.OpenSCAD","installs_last_month":2361},{"name":"Dragengine IGDE","app_id":"ch.dragondreams.deigde","license":"MIT","summary":"Edit Drag[en]gine game projects.","developer":"DragonDreams GmbH","categories":[],"flathub_url":"https://flathub.org/apps/ch.dragondreams.deigde","installs_last_month":137},{"name":"OpenShot Video Editor","app_id":"org.openshot.OpenShot","license":"GPL-3.0-or-later","summary":"An easy to use, quick to learn, and surprisingly powerful video editor","developer":"OpenShot Studios, LLC","categories":[],"flathub_url":"https://flathub.org/apps/org.openshot.OpenShot","installs_last_month":6811},{"name":"Godot Engine","app_id":"org.godotengine.Godot","license":"MIT","summary":"Easily create 2D and 3D games","developer":"The Godot Engine Community","categories":[],"flathub_url":"https://flathub.org/apps/org.godotengine.Godot","installs_last_month":6579},{"name":"Godot Engine (C#/.NET)","app_id":"org.godotengine.GodotSharp","license":"MIT","summary":"Easily create 2D and 3D games","developer":"The Godot Engine Community","categories":[],"flathub_url":"https://flathub.org/apps/org.godotengine.GodotSharp","installs_last_month":763},{"name":"godotGem","app_id":"io.github.iSlammedMyKindle.godotGem","license":"CC-BY-SA-4.0","summary":"Controller client to emulate an xbox360 controller for windows","developer":"iSlammedMyKindle","categories":[],"flathub_url":"https://flathub.org/apps/io.github.iSlammedMyKindle.godotGem","installs_last_month":523},{"name":"KGeography","app_id":"org.kde.kgeography","license":"GPL-2.0+","summary":"Geography learning tool","developer":"KDE","categories":[],"flathub_url":"https://flathub.org/apps/org.kde.kgeography","installs_last_month":446}]},"meta":{"timestamp":"2026-05-31T13:49:01.747Z","request_id":"c42ad876-61f4-4ad5-a501-22e3c57d9343"},"status":"ok","message":"Apps searched","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/stats":{"get":{"operationId":"get_v1_stats","tags":["Flathub"],"summary":"Install statistics + top countries","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Flatpak app id, e.g. org.mozilla.firefox","schema":{"type":"string"},"example":"org.mozilla.firefox"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"stats":{"id":"org.mozilla.firefox","flathub_url":"https://flathub.org/apps/org.mozilla.firefox","top_countries":[{"country":"US","installs":1380749},{"country":"DE","installs":322097},{"country":"GB","installs":263814},{"country":"BR","installs":177089},{"country":"RU","installs":172157},{"country":"CA","installs":153712},{"country":"FR","installs":144620},{"country":"ES","installs":105986},{"country":"AU","installs":86678},{"country":"PL","installs":81847}],"installs_total":11464201,"installs_last_month":187942,"installs_last_7_days":35935}},"meta":{"timestamp":"2026-05-31T13:49:01.857Z","request_id":"972cfdb1-5ca7-4505-be34-d95918ca2a8e"},"status":"ok","message":"Stats retrieved","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":"Source & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live Flathub data. /v1/app = app metadata (summary, description, developer, license, categories, links, latest version, install count) + the flatpak install command; /v1/search = search the store; /v1/stats = install statistics with top countries. Apps are addressed by reverse-DNS id, e.g. org.mozilla.firefox.","source":"Flathub — the Linux desktop-app store (Flatpak)","endpoints":["/v1/app","/v1/search","/v1/stats","/v1/meta"]},"meta":{"timestamp":"2026-05-31T13:49:01.942Z","request_id":"2b27863a-ddc6-43e8-b948-3fc34040423a"},"status":"ok","message":"Meta retrieved","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":3580,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":425,"monthly_call_quota":47900,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1275,"monthly_call_quota":238000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3395,"monthly_call_quota":1192000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/flathub-api"}