Flathub
App · 20 actions
Look up Linux apps on Flathub, the app store most Linux desktops install from. Search and browse its apps by category, developer or keyword, or by what is popular, trending, new or just updated; get an app's full listing, its download size and permissions, its install numbers and its add-ons; read Flathub's app of the day, apps of the week, overall statistics and year in review; and find the apps that were retired or renamed. Triggers start a workflow when a new app arrives on Flathub or an app publishes a new release. Every action reads public data. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Get an app | Get an app's whole Flathub listing: its name, description, developer, licence, links, screenshots, its latest version and release notes, whether its publisher is verified, its age rating, and the command that installs it. |
| Get an app's installs | Get how many times an app has been installed from Flathub: in total, over the last month and week, day by day, and in the countries that install it most. |
| Get an app's size and permissions | Get how much an app downloads and how much space it takes once installed, the processors and runtime it needs, and what it is allowed to reach: the network, your files, devices such as a webcam, and other services on your computer. |
| Get the app of the day | Get the app Flathub features on its front page on a given day, with what it does and the command that installs it. |
| Get the apps of the week | Get the five apps Flathub features for the week a day falls in, in the order it shows them. |
| Get the statistics | Get Flathub's own totals: how many apps it has, how many are verified, how many downloads it has served in all and day by day, and the countries that download the most. |
| Get the year in review | Get Flathub's look back at a year: downloads and how they changed, the new apps, the most downloaded apps and games, its hidden gems, the best newcomer in each category, and where the downloads came from. |
| List a developer's apps | List every app one developer or organisation publishes on Flathub, such as The GNOME Project or KDE, most installed first. |
| List an app's add-ons | List the plugins and extensions published on Flathub for an app, such as GIMP's filters or OBS Studio's plugins, each with its name, what it adds and its id. |
| List apps in a category | List the apps in one of Flathub's categories, or in one of its subcategories such as arcade games or photography, ranked by installs last month or by how fast they are trending. |
| List apps with a keyword | List the apps their developers tagged with one keyword, such as photo, pdf or chess. |
| List categories | List Flathub's main categories, such as Games and Graphics & Photography, with how many apps each holds and the id 'List apps in a category' takes. |
| List most favourited apps | List the apps the most Flathub users have marked as a favourite, with how many have. |
| List new apps | List the apps added to Flathub most recently, newest first, each with the day it arrived. |
| List popular apps | List the apps installed most often from Flathub over the last month, most installed first. |
| List recently updated apps | List the apps that published an update on Flathub most recently, newest first, each with the time it was updated. |
| List recently verified apps | List the apps whose publisher Flathub verified most recently, with who each was verified as: a website or an account. |
| List retired and renamed apps | List the apps that left Flathub: the ones renamed to a new id, with that id, and the ones retired, with Flathub's note on why and what to use instead. |
| List trending apps | List the apps whose installs grew fastest over the last two weeks, which surfaces new and rising apps rather than the usual favourites. |
| Search apps | Search Flathub's apps by name, description and keywords, the way the search box on flathub.org does. |
Get an app
Get an app's whole Flathub listing: its name, description, developer, licence, links, screenshots, its latest version and release notes, whether its publisher is verified, its age rating, and the command that installs it. An app that has left Flathub comes back saying so, with its new id when it was renamed.
Inputs
- App
apptextRequired - Which app. Pick one from the list, or type its Flathub id (the last part of its address on flathub.org, such as org.gimp.GIMP) or its exact name.
Outputs
app_idtext- The app's Flathub id, such as org.gimp.GIMP, which every app field takes
bug_tracker_urltext- Where bugs are reported; often empty
categorieslist- The desktop categories the app lists, such as Graphics
descriptiontext- The app's full description as plain text
developertext- Who publishes the app
donation_urltext- Where to donate to its developers; often empty
end_of_life_messagetext- Flathub's note on why it is end of life; often empty
foundtrue/false- False when Flathub has no app with that id; renamed_to and end_of_life_message then say why when Flathub knows
help_urltext- Its help pages; often empty
homepage_urltext- The app's own website
icon_urltext- The app's icon
install_commandtext- The command that installs it from Flathub
is_end_of_lifetrue/false- True when the app is no longer maintained on Flathub
is_free_licensetrue/false- True when the licence is a free software licence
keywordslist- Search words the developer gave the app
latest_release_datetext- When the newest version came out, as YYYY-MM-DD
latest_versiontext- The newest version listed
licensetext- The app's licence as an SPDX id, or Proprietary
minimum_agenumber- The youngest age its content rating suits, and 0 for all ages
mobile_friendlytrue/false- True when the app adapts to phone screens
nametext- The app's name
releaseslist- Its recent releases, newest first
renamed_totext- The app's new id when the one asked for was renamed; empty otherwise
runtimetext- The Flatpak runtime it is built on
screenshot_urlslist- Its screenshots, at the largest size published
searched_fortext- What was typed in the app field
source_code_urltext- Where its source code is browsed; often empty
summarytext- One line on what the app does
translate_urltext- Where to help translate it; often empty
typetext- What kind of entry this is, such as desktop-application
urltext- The app's page on flathub.org, or its new page when renamed
verifiedtrue/false- True when Flathub has verified who publishes the app
verified_astext- Who the publisher was verified as: a website, an account, or Checked by Flathub; empty when unverified
Example output
{
"app_id": "org.gimp.GIMP",
"bug_tracker_url": "https://www.gimp.org/bugs/",
"categories": [
"Graphics",
"2DGraphics",
"RasterGraphics"
],
"description": "GIMP is an acronym for GNU Image Manipulation Program. It is Community-driven Free Software for high-end image creation and manipulation.",
"developer": "The GIMP team",
"donation_url": "https://www.gimp.org/donating/",
"end_of_life_message": "",
"found": true,
"help_url": "https://www.gimp.org/docs/",
"homepage_url": "https://www.gimp.org/",
"icon_url": "https://dl.flathub.org/media/org/gimp/GIMP/95e6d7d59d33a0f9364535dbe023d807/icons/128x128/org.gimp.GIMP.png",
"install_command": "flatpak install flathub org.gimp.GIMP",
"is_end_of_life": false,
"is_free_license": true,
"keywords": [
"GIMP",
"Photoshop"
],
"latest_release_date": "2026-09-10",
"latest_version": "3.2.6",
"license": "GPL-3.0+ AND LGPL-3.0+",
"minimum_age": 3,
"mobile_friendly": false,
"name": "GNU Image Manipulation Program",
"releases": [
{
"date": "2026-09-10",
"notes": "This new bugfix release of GIMP 3.2 brings a whole new level of stability:\n\n- New input axis \"Rotation\" (a.k.a. \"barrel rotation\") supported in dynamics\n- Bug fixes and usability improvements to recently added features and non-destructive workflows",
"type": "stable",
"url": "https://www.gimp.org/release/3.2.6/",
"version": "3.2.6"
},
{
"date": "2026-04-17",
"notes": "The second bugfix release of the GIMP 3.2 series brings it to quite a stable state again as bugs reports are slowing down.\n\n- Bug fixed where GIMP would fail to open some XCF\n- When moving a floating layer or selection with a selection tool, marching ants are now disabled",
"type": "stable",
"url": "https://www.gimp.org/release/3.2.4/",
"version": "3.2.4"
}
],
"renamed_to": "",
"runtime": "org.gnome.Platform/x86_64/51",
"screenshot_urls": [
"https://dl.flathub.org/media/org/gimp/GIMP/95e6d7d59d33a0f9364535dbe023d807/screenshots/image-1_orig.png",
"https://dl.flathub.org/media/org/gimp/GIMP/95e6d7d59d33a0f9364535dbe023d807/screenshots/image-2_orig.png"
],
"searched_for": "GIMP",
"source_code_url": "https://gitlab.gnome.org/GNOME/gimp/",
"summary": "High-end image creation and manipulation",
"translate_url": "",
"type": "desktop-application",
"url": "https://flathub.org/apps/org.gimp.GIMP",
"verified": true,
"verified_as": "gimp.org"
}Get an app's installs
Get how many times an app has been installed from Flathub: in total, over the last month and week, day by day, and in the countries that install it most. Use it to track an app's growth in a spreadsheet or a weekly report.
Inputs
- App
apptextRequired - Which app. Pick one from the list, or type its Flathub id (the last part of its address on flathub.org, such as org.gimp.GIMP) or its exact name.
- Days of daily installs
daysnumber - How many days of day-by-day installs to return, up to the last day Flathub has finished counting. Defaults to 30.From 1 to 365. Default:
30.
Outputs
app_idtext- The app's Flathub id, such as org.gimp.GIMP, which every app field takes
country_countnumber- How many countries it has been installed in
daily_installslist- Installs day by day, oldest first, up to the last day Flathub has finished counting
daysnumber- How many days of daily installs were asked for
installs_in_periodnumber- Installs over those days added up
installs_last_7_daysnumber- Installs over the last 7 days
installs_last_monthnumber- Installs over the last 30 days
installs_totalnumber- Installs since it was added to Flathub
nametext- The app's name
top_countrieslist- The ten countries with the most installs, most first
Example output
{
"app_id": "org.gimp.GIMP",
"country_count": 227,
"daily_installs": [
{
"date": "2026-10-16",
"installs": 1859
},
{
"date": "2026-10-17",
"installs": 2145
},
{
"date": "2026-10-18",
"installs": 2045
}
],
"days": 3,
"installs_in_period": 6049,
"installs_last_7_days": 11728,
"installs_last_month": 60299,
"installs_total": 3898445,
"name": "GNU Image Manipulation Program",
"top_countries": [
{
"country_code": "US",
"installs": 315309
},
{
"country_code": "DE",
"installs": 167617
},
{
"country_code": "BR",
"installs": 144201
}
]
}Get an app's size and permissions
Get how much an app downloads and how much space it takes once installed, the processors and runtime it needs, and what it is allowed to reach: the network, your files, devices such as a webcam, and other services on your computer. Use it to check an app before installing it.
Inputs
- App
apptextRequired - Which app. Pick one from the list, or type its Flathub id (the last part of its address on flathub.org, such as org.gimp.GIMP) or its exact name.
Outputs
app_idtext- The app's Flathub id, such as org.gimp.GIMP, which every app field takes
architectureslist- The processors it runs on
branchtext- The Flatpak branch described, usually stable
commandtext- The command the app starts with
deviceslist- The devices it may use, such as all or dri
download_sizetext- The download size written out, such as 102.1 MB
download_size_bytesnumber- How much is downloaded to install it, in bytes
downloads_extra_datatrue/false- True when installing it downloads parts from its publisher rather than Flathub
filesystemslist- The folders it may reach, as Flatpak writes them
full_file_accesstrue/false- True when it may read the whole home folder or the whole system
installed_sizetext- The installed size written out, such as 268.2 MB
installed_size_bytesnumber- How much disk space it takes, in bytes
nametext- The app's name
network_accesstrue/false- True when the app may use the network
runtimetext- The Flatpak runtime it needs, such as org.gnome.Platform/x86_64/49
runtime_is_end_of_lifetrue/false- True when the runtime it needs no longer gets updates
runtime_nametext- The runtime's name, such as GNOME Application Platform version 49
session_bus_accesslist- Desktop services it may talk to
socketslist- The display, sound and other sockets it may use
system_bus_accesslist- System services it may talk to
updated_attext- When this build was published, as an ISO 8601 UTC time
urltext- The app's page on flathub.org
Example output
{
"app_id": "org.gimp.GIMP",
"architectures": [
"x86_64",
"aarch64"
],
"branch": "stable",
"command": "gimp",
"devices": [
"all"
],
"download_size": "102.1 MB",
"download_size_bytes": 102084991,
"downloads_extra_data": false,
"filesystems": [
"xdg-config/GIMP:create",
"xdg-config/gtk-3.0:ro",
"/tmp",
"xdg-run/gvfsd",
"host",
"xdg-run/gvfs"
],
"full_file_access": true,
"installed_size": "268.2 MB",
"installed_size_bytes": 268155392,
"name": "GNU Image Manipulation Program",
"network_access": true,
"runtime": "org.gnome.Platform/x86_64/51",
"runtime_is_end_of_life": false,
"runtime_name": "GNOME Application Platform version 51",
"session_bus_access": [
"com.canonical.AppMenu.Registrar",
"org.freedesktop.FileManager1",
"org.gnome.Shell.Screenshot",
"org.gtk.vfs.*",
"org.kde.kwin.Screenshot"
],
"sockets": [
"fallback-x11",
"wayland"
],
"system_bus_access": [],
"updated_at": "2026-10-19T01:26:04Z",
"url": "https://flathub.org/apps/org.gimp.GIMP"
}Get the app of the day
Get the app Flathub features on its front page on a given day, with what it does and the command that installs it. Good for a daily post to a team channel.
Inputs
- Date
datedate - The day to look up. Leave it empty for today. Flathub schedules its picks a few days ahead, so the next few days work too.
Outputs
app_idtext- The app's Flathub id, such as org.gimp.GIMP, which every app field takes
datetext- The day, as YYYY-MM-DD
developertext- Who publishes the app
icon_urltext- The app's icon
install_commandtext- The command that installs it from Flathub
is_stand_intrue/false- True when nothing was picked for that day and Flathub answered with Kodi, its stand-in
nametext- The app's name
summarytext- One line on what the app does
urltext- The app's page on flathub.org
Example output
{
"app_id": "me.iepure.devtoolbox",
"date": "2026-10-19",
"developer": "Alessandro Iepure",
"icon_url": "https://dl.flathub.org/media/me/iepure/devtoolbox/640a058cc8ec23f49c5b63ac55b669d0/icons/128x128/me.iepure.devtoolbox.png",
"install_command": "flatpak install flathub me.iepure.devtoolbox",
"is_stand_in": false,
"name": "Dev Toolbox",
"summary": "Dev tools at your fingertips",
"url": "https://flathub.org/apps/me.iepure.devtoolbox"
}Get the apps of the week
Get the five apps Flathub features for the week a day falls in, in the order it shows them.
Inputs
- Date
datedate - Any day in the week to look up. Leave it empty for this week.
Outputs
appslist- The week's apps, in the order Flathub shows them
countnumber- How many apps were picked; 0 when none are scheduled yet
datetext- The day asked about, as YYYY-MM-DD
week_numbernumber- The ISO week number that day falls in
Example output
{
"apps": [
{
"app_id": "app.drey.Haystack",
"developer": "Jan-Willem Harmannij",
"icon_url": "https://dl.flathub.org/media/app/drey/Haystack/1d477cf69f71011651211242198b6dd9/icons/128x128/app.drey.Haystack.png",
"name": "Haystack",
"position": 1,
"summary": "Edit OpenQA needles",
"url": "https://flathub.org/apps/app.drey.Haystack"
},
{
"app_id": "io.github.screwys.Rufin",
"developer": "screwy",
"icon_url": "https://dl.flathub.org/media/io/github/screwys.Rufin/01a25cfbaf9198603ca33711d46698f1/icons/128x128/io.github.screwys.Rufin.png",
"name": "Rufin",
"position": 2,
"summary": "Feel at home with your music",
"url": "https://flathub.org/apps/io.github.screwys.Rufin"
},
{
"app_id": "org.gnome.design.Emblem",
"developer": "Maximiliano Sandoval",
"icon_url": "https://dl.flathub.org/media/org/gnome/design.Emblem/19c789012a28f226c5377da199bb77ec/icons/128x128/org.gnome.design.Emblem.png",
"name": "Emblem",
"position": 3,
"summary": "Generate project avatars",
"url": "https://flathub.org/apps/org.gnome.design.Emblem"
}
],
"count": 3,
"date": "2026-10-19",
"week_number": 43
}Get the statistics
Get Flathub's own totals: how many apps it has, how many are verified, how many downloads it has served in all and day by day, and the countries that download the most.
Inputs
- Days of daily downloads
daysnumber - How many days of day-by-day downloads to return, up to the last day Flathub has finished counting. Defaults to 30.From 1 to 365. Default:
30.
Outputs
app_countnumber- How many apps Flathub has
daily_downloadslist- Downloads day by day, oldest first, up to the last day Flathub has finished counting
daysnumber- How many days of daily downloads were asked for
downloads_in_periodnumber- Downloads over those days added up
top_countrieslist- The ten countries with the most downloads, most first
total_downloadsnumber- Downloads from Flathub since 2018
verified_app_countnumber- How many of them are verified
Example output
{
"app_count": 3715,
"daily_downloads": [
{
"date": "2026-10-17",
"downloads": 4847317
},
{
"date": "2026-10-18",
"downloads": 5512393
},
{
"date": "2026-10-19",
"downloads": 4974984
}
],
"days": 3,
"downloads_in_period": 15334694,
"top_countries": [
{
"country_code": "US",
"downloads": 1092687862
},
{
"country_code": "DE",
"downloads": 517419553
},
{
"country_code": "BR",
"downloads": 394249288
}
],
"total_downloads": 4858669778,
"verified_app_count": 2202
}Get the year in review
Get Flathub's look back at a year: downloads and how they changed, the new apps, the most downloaded apps and games, its hidden gems, the best newcomer in each category, and where the downloads came from.
Inputs
- Year
yearnumber - The year to review, from 2018. Leave it empty for last year; the current year is published once it ends.At least 2018.
Outputs
architectureslist- Downloads by processor
best_newcomerslist- The most downloaded new app in each category
downloads_changenumber- How many more downloads than the year before
downloads_change_percentagenumber- The change on the year before, in percent
hidden_gemslist- Apps Flathub picked as hidden gems
new_app_countnumber- Apps added that year
top_appslist- The most downloaded apps that year
top_countrieslist- The countries with the most downloads that year
top_gameslist- The most downloaded games that year
total_app_countnumber- Apps on Flathub at the end of the year
total_downloadsnumber- Downloads that year
update_countnumber- Updates downloaded that year
yearnumber- The year reviewed
Example output
{
"architectures": [
{
"architecture": "x86_64",
"downloads": 432642656,
"percentage": 98.74
},
{
"architecture": "aarch64",
"downloads": 5513641,
"percentage": 1.26
}
],
"best_newcomers": [
{
"app_id": "org.vinegarhq.Sober",
"category": "game",
"category_name": "Games",
"downloads": 1285220,
"name": "Sober"
},
{
"app_id": "app.zen_browser.zen",
"category": "network",
"category_name": "Networking",
"downloads": 662601,
"name": "Zen"
}
],
"downloads_change": 77732233,
"downloads_change_percentage": 21.6,
"hidden_gems": [
{
"app_id": "org.tropy.Tropy",
"downloads": 2263,
"name": "Tropy",
"rank": 1,
"summary": "Explore your research photos",
"url": "https://flathub.org/apps/org.tropy.Tropy"
},
{
"app_id": "io.github.leolost2605.emergency-alerts",
"downloads": 2249,
"name": "Emergency Alerts",
"rank": 2,
"summary": "Receive emergency alerts",
"url": "https://flathub.org/apps/io.github.leolost2605.emergency-alerts"
}
],
"new_app_count": 446,
"top_apps": [
{
"app_id": "org.mozilla.firefox",
"downloads": 2713715,
"name": "Firefox",
"rank": 1,
"summary": "Fast, Private & Safe Web Browser",
"url": "https://flathub.org/apps/org.mozilla.firefox"
},
{
"app_id": "com.google.Chrome",
"downloads": 2364954,
"name": "Google Chrome",
"rank": 2,
"summary": "The browser built to be yours",
"url": "https://flathub.org/apps/com.google.Chrome"
}
],
"top_countries": [
{
"country_code": "US",
"downloads": 42669996
},
{
"country_code": "DE",
"downloads": 16603856
}
],
"top_games": [
{
"app_id": "org.vinegarhq.Sober",
"downloads": 1285220,
"name": "Sober",
"rank": 1,
"summary": "Play, chat & explore on Roblox",
"url": "https://flathub.org/apps/org.vinegarhq.Sober"
},
{
"app_id": "com.mojang.Minecraft",
"downloads": 260002,
"name": "Minecraft Launcher",
"rank": 2,
"summary": "Create your own world in one of the most popular video games",
"url": "https://flathub.org/apps/com.mojang.Minecraft"
}
],
"total_app_count": 3249,
"total_downloads": 438168716,
"update_count": 727382294,
"year": 2025
}List a developer's apps
List every app one developer or organisation publishes on Flathub, such as The GNOME Project or KDE, most installed first.
Inputs
- Developer
developertextRequired - The developer's name as an app's page on flathub.org shows it. Capitals do not matter.
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
developertext- The developer whose apps these are
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2018-05-24T19:12:43Z",
"app_id": "org.gnome.Boxes",
"architectures": [
"aarch64",
"x86_64"
],
"category": "system",
"category_name": "System",
"developer": "The GNOME Project",
"favorites": 277,
"icon_url": "https://dl.flathub.org/media/org/gnome/Boxes.desktop/21197cc56a7bd29d89fe91d2bda9b910/icons/128x128/org.gnome.Boxes.desktop.png",
"installs_last_month": 16499,
"is_free_license": true,
"license": "LGPL-2.1+",
"mobile_friendly": false,
"name": "Boxes",
"runtime": "org.gnome.Platform/x86_64/50",
"subcategories": [
"Emulator",
"Development"
],
"summary": "Virtualization made simple",
"trending_score": -0.48,
"updated_at": "2026-03-19T08:44:47Z",
"url": "https://flathub.org/apps/org.gnome.Boxes",
"verified": true,
"verified_as": "gnome.org"
},
{
"added_at": "2023-04-27T18:16:30Z",
"app_id": "org.gnome.Snapshot",
"architectures": [
"aarch64",
"x86_64"
],
"category": "audiovideo",
"category_name": "Audio & Video",
"developer": "The GNOME Project",
"favorites": 102,
"icon_url": "https://dl.flathub.org/media/org/gnome/Snapshot/8ea640f901efdd4e9178f96ab1e41c9c/icons/128x128/org.gnome.Snapshot.png",
"installs_last_month": 15392,
"is_free_license": true,
"license": "GPL-3.0-or-later",
"mobile_friendly": true,
"name": "Camera",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [
"Video",
"Recorder"
],
"summary": "Take pictures and videos",
"trending_score": 3.25,
"updated_at": "2026-09-17T15:35:10Z",
"url": "https://flathub.org/apps/org.gnome.Snapshot",
"verified": true,
"verified_as": "GNOME GitLab account msandova"
}
],
"count": 2,
"developer": "The GNOME Project",
"page": 1,
"total_count": 35,
"total_pages": 12
}List an app's add-ons
List the plugins and extensions published on Flathub for an app, such as GIMP's filters or OBS Studio's plugins, each with its name, what it adds and its id.
Inputs
- App
apptextRequired - Which app. Pick one from the list, or type its Flathub id (the last part of its address on flathub.org, such as org.gimp.GIMP) or its exact name.
Outputs
addonslist- The add-ons, in id order
app_idtext- The app's Flathub id, such as org.gimp.GIMP, which every app field takes
countnumber- How many add-ons it has
nametext- The app's name
urltext- The app's page on flathub.org
Example output
{
"addons": [
{
"app_id": "org.gimp.GIMP.Plugin.Fourier",
"developer": "",
"license": "GPL-3.0",
"name": "Fourier",
"summary": "Fourier GIMP Plugin"
},
{
"app_id": "org.gimp.GIMP.Plugin.GMic",
"developer": "G'MIC developers",
"license": "CECILL-C",
"name": "G'MIC",
"summary": "GREYC's Magic for Image Computing"
},
{
"app_id": "org.gimp.GIMP.Plugin.Resynthesizer",
"developer": "",
"license": "GPL-3.0+",
"name": "Resynthesizer",
"summary": "Resynthesizer GIMP Plugins"
}
],
"app_id": "org.gimp.GIMP",
"count": 3,
"name": "GNU Image Manipulation Program",
"url": "https://flathub.org/apps/org.gimp.GIMP"
}List apps in a category
List the apps in one of Flathub's categories, or in one of its subcategories such as arcade games or photography, ranked by installs last month or by how fast they are trending.
Inputs
- Category
categorytextRequired - Which category to list.
- Subcategory
subcategorytext - Only apps in this subcategory. The list holds the subcategories the chosen category's apps use, busiest first. Leave it empty for the whole category.
- Order
sorttext - How to rank the apps.One of:
popular(Most installed last month),trending. Default:popular. - How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
categorytext- The category's id
category_nametext- The category's name on flathub.org
countnumber- How many apps are in this result
pagenumber- Which page of the list this is, from 1
sorttext- popular or trending: how the apps are ordered
subcategorytext- The subcategory it was narrowed to, empty when it was not
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2023-08-22T21:38:48Z",
"app_id": "com.supermodel3.Supermodel",
"architectures": [
"aarch64",
"x86_64"
],
"category": "game",
"category_name": "Games",
"developer": "The Supermodel Team",
"favorites": 16,
"icon_url": "https://dl.flathub.org/media/com/supermodel3/Supermodel/7fef40ec8b005a6a3bb87df350b5a68e/icons/128x128/com.supermodel3.Supermodel.png",
"installs_last_month": 31745,
"is_free_license": true,
"license": "GPL-3.0-or-later",
"mobile_friendly": false,
"name": "Supermodel",
"runtime": "org.freedesktop.Platform/x86_64/25.08",
"subcategories": [
"ArcadeGame",
"Emulator"
],
"summary": "A Sega Model 3 Arcade Emulator",
"trending_score": 0.6,
"updated_at": "2026-05-29T17:49:07Z",
"url": "https://flathub.org/apps/com.supermodel3.Supermodel",
"verified": false,
"verified_as": ""
},
{
"added_at": "2021-12-28T08:33:42Z",
"app_id": "com.github.k4zmu2a.spacecadetpinball",
"architectures": [
"aarch64",
"x86_64"
],
"category": "game",
"category_name": "Games",
"developer": "Andrey Muzychenko",
"favorites": 94,
"icon_url": "https://dl.flathub.org/media/com/github/k4zmu2a.spacecadetpinball/6f98dd7f691cbc07a9c0a891902e7f89/icons/128x128/com.github.k4zmu2a.spacecadetpinball.png",
"installs_last_month": 18771,
"is_free_license": true,
"license": "MIT",
"mobile_friendly": false,
"name": "Space Cadet Pinball",
"runtime": "org.freedesktop.Platform/x86_64/26.08",
"subcategories": [
"ArcadeGame"
],
"summary": "Game engine for Space Cadet Pinball",
"trending_score": -2.55,
"updated_at": "2026-09-02T13:56:37Z",
"url": "https://flathub.org/apps/com.github.k4zmu2a.spacecadetpinball",
"verified": false,
"verified_as": ""
}
],
"category": "game",
"category_name": "Games",
"count": 2,
"page": 1,
"sort": "popular",
"subcategory": "ArcadeGame",
"total_count": 110,
"total_pages": 37
}List apps with a keyword
List the apps their developers tagged with one keyword, such as photo, pdf or chess. Unlike a search, only apps tagged with exactly that word come back.
Inputs
- Keyword
keywordtextRequired - The keyword, as one word or a short phrase.
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
keywordtext- The keyword asked for
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2025-12-05T10:11:10Z",
"app_id": "io.github.cosmic_utils.camera",
"architectures": [
"aarch64",
"x86_64"
],
"category": "audiovideo",
"category_name": "Audio & Video",
"developer": "Frederic Laing",
"favorites": 17,
"icon_url": "https://dl.flathub.org/media/io/github/cosmic_utils.camera/fd515165866550cfaf1b16c1d2f972a3/icons/128x128/io.github.cosmic_utils.camera.png",
"installs_last_month": 11275,
"is_free_license": true,
"license": "GPL-3.0-only",
"mobile_friendly": true,
"name": "Camera",
"runtime": "org.freedesktop.Platform/x86_64/26.08",
"subcategories": [
"Video",
"Recorder",
"Photography"
],
"summary": "Camera for photos, videos and QR codes",
"trending_score": 0.17,
"updated_at": "2026-09-25T08:00:36Z",
"url": "https://flathub.org/apps/io.github.cosmic_utils.camera",
"verified": true,
"verified_as": "cosmic-utils.github.io"
},
{
"added_at": "2022-03-29T16:46:11Z",
"app_id": "io.github.webcamoid.Webcamoid",
"architectures": [
"aarch64",
"x86_64"
],
"category": "audiovideo",
"category_name": "Audio & Video",
"developer": "Gonzalo Exequiel Pedone",
"favorites": 9,
"icon_url": "https://dl.flathub.org/media/io/github/webcamoid.Webcamoid/819c2cd210e547810c0b5161968f6858/icons/128x128/io.github.webcamoid.Webcamoid.png",
"installs_last_month": 2484,
"is_free_license": true,
"license": "GPL-3.0-or-later",
"mobile_friendly": false,
"name": "Webcamoid",
"runtime": "org.kde.Platform/x86_64/6.10",
"subcategories": [
"Player"
],
"summary": "Take photos and record videos with your webcam",
"trending_score": 1.45,
"updated_at": "2026-07-07T00:04:06Z",
"url": "https://flathub.org/apps/io.github.webcamoid.Webcamoid",
"verified": false,
"verified_as": ""
}
],
"count": 2,
"keyword": "photo",
"page": 1,
"total_count": 14,
"total_pages": 5
}List categories
List Flathub's main categories, such as Games and Graphics & Photography, with how many apps each holds and the id 'List apps in a category' takes.
Inputs
None.
Outputs
categorieslist- Flathub's main categories
countnumber- How many categories there are
total_appsnumber- How many apps Flathub lists in all
Example output
{
"categories": [
{
"app_count": 366,
"id": "audiovideo",
"name": "Audio & Video",
"url": "https://flathub.org/apps/category/audiovideo"
},
{
"app_count": 267,
"id": "development",
"name": "Developer Tools",
"url": "https://flathub.org/apps/category/development"
},
{
"app_count": 173,
"id": "education",
"name": "Education",
"url": "https://flathub.org/apps/category/education"
},
{
"app_count": 0,
"id": "healthfitness",
"name": "Health & Fitness",
"url": "https://flathub.org/apps/category/healthfitness"
},
{
"app_count": 736,
"id": "game",
"name": "Games",
"url": "https://flathub.org/apps/category/game"
},
{
"app_count": 225,
"id": "graphics",
"name": "Graphics & Photography",
"url": "https://flathub.org/apps/category/graphics"
},
{
"app_count": 331,
"id": "network",
"name": "Networking",
"url": "https://flathub.org/apps/category/network"
},
{
"app_count": 253,
"id": "office",
"name": "Productivity",
"url": "https://flathub.org/apps/category/office"
},
{
"app_count": 78,
"id": "science",
"name": "Science",
"url": "https://flathub.org/apps/category/science"
},
{
"app_count": 103,
"id": "system",
"name": "System",
"url": "https://flathub.org/apps/category/system"
},
{
"app_count": 739,
"id": "utility",
"name": "Utilities",
"url": "https://flathub.org/apps/category/utility"
}
],
"count": 11,
"total_apps": 3328
}List most favourited apps
List the apps the most Flathub users have marked as a favourite, with how many have.
Inputs
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2020-01-28T20:10:25Z",
"app_id": "com.github.tchx84.Flatseal",
"architectures": [
"aarch64",
"x86_64"
],
"category": "utility",
"category_name": "Utilities",
"developer": "Martin Abente Lahaye",
"favorites": 963,
"icon_url": "https://dl.flathub.org/media/com/github/tchx84.Flatseal/462bde383c024a52b3132ae3df79704a/icons/128x128/com.github.tchx84.Flatseal.png",
"installs_last_month": 94345,
"is_free_license": true,
"license": "GPL-3.0-or-later",
"mobile_friendly": true,
"name": "Flatseal",
"runtime": "org.gnome.Platform/x86_64/50",
"subcategories": [],
"summary": "Manage Flatpak permissions",
"trending_score": 0.13,
"updated_at": "2026-05-20T18:12:58Z",
"url": "https://flathub.org/apps/com.github.tchx84.Flatseal",
"verified": true,
"verified_as": "GitHub account tchx84"
},
{
"added_at": "2017-06-18T08:02:43Z",
"app_id": "com.discordapp.Discord",
"architectures": [
"x86_64"
],
"category": "network",
"category_name": "Networking",
"developer": "Discord Inc.",
"favorites": 733,
"icon_url": "https://dl.flathub.org/media/com/discordapp/Discord/93bfd85a049c94079fb71071030fa555/icons/128x128/com.discordapp.Discord.png",
"installs_last_month": 165002,
"is_free_license": false,
"license": "Proprietary",
"mobile_friendly": false,
"name": "Discord",
"runtime": "org.freedesktop.Platform/x86_64/26.08",
"subcategories": [
"InstantMessaging"
],
"summary": "Talk, play, hang out",
"trending_score": 1.07,
"updated_at": "2026-10-15T19:39:10Z",
"url": "https://flathub.org/apps/com.discordapp.Discord",
"verified": true,
"verified_as": "discordapp.com"
}
],
"count": 2,
"page": 1,
"total_count": 3328,
"total_pages": 1110
}List new apps
List the apps added to Flathub most recently, newest first, each with the day it arrived.
Inputs
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2026-10-18T15:01:36Z",
"app_id": "app.paperjungle.paperjungle",
"architectures": [
"aarch64",
"x86_64"
],
"category": "office",
"category_name": "Productivity",
"developer": "HappySquare",
"favorites": 0,
"icon_url": "https://dl.flathub.org/media/app/paperjungle/paperjungle/bc2085497902ffcdc4faa78c1ce239c0/icons/128x128/app.paperjungle.paperjungle.png",
"installs_last_month": 29,
"is_free_license": false,
"license": "Proprietary",
"mobile_friendly": true,
"name": "Paperjungle",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [],
"summary": "Manage your documents stress-free",
"trending_score": 0.1,
"updated_at": "2026-10-18T20:36:44Z",
"url": "https://flathub.org/apps/app.paperjungle.paperjungle",
"verified": true,
"verified_as": "paperjungle.app"
},
{
"added_at": "2026-10-16T16:19:04Z",
"app_id": "io.github.phase1geo.textshine",
"architectures": [
"aarch64",
"x86_64"
],
"category": "utility",
"category_name": "Utilities",
"developer": "Trevor Williams",
"favorites": 0,
"icon_url": "https://dl.flathub.org/media/io/github/phase1geo.textshine/bd55f83e812cff24aa3d95dccc0adb2d/icons/128x128/io.github.phase1geo.textshine.png",
"installs_last_month": 63,
"is_free_license": true,
"license": "GPL-3.0+",
"mobile_friendly": false,
"name": "TextShine",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [
"WordProcessor",
"Development"
],
"summary": "Powerfully transform text",
"trending_score": 0.94,
"updated_at": "2026-10-16T16:19:04Z",
"url": "https://flathub.org/apps/io.github.phase1geo.textshine",
"verified": true,
"verified_as": "GitHub account phase1geo"
}
],
"count": 2,
"page": 1,
"total_count": 3328,
"total_pages": 1110
}List popular apps
List the apps installed most often from Flathub over the last month, most installed first.
Inputs
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2023-07-11T13:21:43Z",
"app_id": "org.mozilla.firefox",
"architectures": [
"aarch64",
"x86_64"
],
"category": "network",
"category_name": "Networking",
"developer": "Mozilla",
"favorites": 508,
"icon_url": "https://dl.flathub.org/media/icons/128x128/org.mozilla.firefox.png",
"installs_last_month": 200629,
"is_free_license": true,
"license": "MPL-2.0",
"mobile_friendly": false,
"name": "Firefox",
"runtime": "org.freedesktop.Platform/x86_64/25.08",
"subcategories": [
"WebBrowser"
],
"summary": "Fast, Private & Safe Web Browser",
"trending_score": -0.73,
"updated_at": "2026-10-13T12:42:50Z",
"url": "https://flathub.org/apps/org.mozilla.firefox",
"verified": true,
"verified_as": "Checked by Flathub"
},
{
"added_at": "2025-03-30T06:40:41Z",
"app_id": "org.vinegarhq.Sober",
"architectures": [
"x86_64"
],
"category": "game",
"category_name": "Games",
"developer": "VinegarHQ & Sober contributors",
"favorites": 377,
"icon_url": "https://dl.flathub.org/media/org/vinegarhq/Sober/efc7e405d3a366657e27e4d8bcbfe228/icons/128x128/org.vinegarhq.Sober.png",
"installs_last_month": 197095,
"is_free_license": false,
"license": "Proprietary",
"mobile_friendly": false,
"name": "Sober",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [
"GNOME",
"GTK"
],
"summary": "Play, chat & explore on Roblox",
"trending_score": 3.49,
"updated_at": "2026-10-04T23:32:38Z",
"url": "https://flathub.org/apps/org.vinegarhq.Sober",
"verified": true,
"verified_as": "vinegarhq.org"
}
],
"count": 2,
"page": 1,
"total_count": 3328,
"total_pages": 1110
}List recently updated apps
List the apps that published an update on Flathub most recently, newest first, each with the time it was updated.
Inputs
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2018-11-06T16:59:01Z",
"app_id": "io.dbeaver.DBeaverCommunity",
"architectures": [
"aarch64",
"x86_64"
],
"category": "development",
"category_name": "Developer Tools",
"developer": "DBeaver Corporation",
"favorites": 122,
"icon_url": "https://dl.flathub.org/media/io/dbeaver/DBeaverCommunity/fecdb025e53c4a6e566b37b75525162d/icons/128x128/io.dbeaver.DBeaverCommunity.png",
"installs_last_month": 14428,
"is_free_license": true,
"license": "Apache-2.0",
"mobile_friendly": false,
"name": "DBeaver Community",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [
"IDE"
],
"summary": "Free Universal Database Tool",
"trending_score": -3.18,
"updated_at": "2026-10-20T01:45:11Z",
"url": "https://flathub.org/apps/io.dbeaver.DBeaverCommunity",
"verified": false,
"verified_as": ""
},
{
"added_at": "2026-02-10T00:48:22Z",
"app_id": "io.github.mlm_games.mages",
"architectures": [
"aarch64",
"x86_64"
],
"category": "network",
"category_name": "Networking",
"developer": "MLM Games",
"favorites": 3,
"icon_url": "https://dl.flathub.org/media/io/github/mlm_games.mages/de0460f1e0cb52d0ec281555bea374c2/icons/128x128/io.github.mlm_games.mages.png",
"installs_last_month": 207,
"is_free_license": true,
"license": "AGPL-3.0-only",
"mobile_friendly": true,
"name": "Mages",
"runtime": "org.freedesktop.Platform/x86_64/26.08",
"subcategories": [
"InstantMessaging",
"Chat"
],
"summary": "Encrypted chat client for Matrix",
"trending_score": -0.2,
"updated_at": "2026-10-20T01:22:22Z",
"url": "https://flathub.org/apps/io.github.mlm_games.mages",
"verified": true,
"verified_as": "GitHub account mlm-games"
}
],
"count": 2,
"page": 1,
"total_count": 3328,
"total_pages": 1110
}List recently verified apps
List the apps whose publisher Flathub verified most recently, with who each was verified as: a website or an account.
Inputs
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2026-10-18T15:01:36Z",
"app_id": "app.paperjungle.paperjungle",
"architectures": [
"aarch64",
"x86_64"
],
"category": "office",
"category_name": "Productivity",
"developer": "HappySquare",
"favorites": 0,
"icon_url": "https://dl.flathub.org/media/app/paperjungle/paperjungle/bc2085497902ffcdc4faa78c1ce239c0/icons/128x128/app.paperjungle.paperjungle.png",
"installs_last_month": 29,
"is_free_license": false,
"license": "Proprietary",
"mobile_friendly": true,
"name": "Paperjungle",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [],
"summary": "Manage your documents stress-free",
"trending_score": 0.1,
"updated_at": "2026-10-18T20:36:44Z",
"url": "https://flathub.org/apps/app.paperjungle.paperjungle",
"verified": true,
"verified_as": "paperjungle.app"
},
{
"added_at": "2026-10-16T16:19:04Z",
"app_id": "io.github.phase1geo.textshine",
"architectures": [
"aarch64",
"x86_64"
],
"category": "utility",
"category_name": "Utilities",
"developer": "Trevor Williams",
"favorites": 0,
"icon_url": "https://dl.flathub.org/media/io/github/phase1geo.textshine/bd55f83e812cff24aa3d95dccc0adb2d/icons/128x128/io.github.phase1geo.textshine.png",
"installs_last_month": 63,
"is_free_license": true,
"license": "GPL-3.0+",
"mobile_friendly": false,
"name": "TextShine",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [
"WordProcessor",
"Development"
],
"summary": "Powerfully transform text",
"trending_score": 0.94,
"updated_at": "2026-10-16T16:19:04Z",
"url": "https://flathub.org/apps/io.github.phase1geo.textshine",
"verified": true,
"verified_as": "GitHub account phase1geo"
}
],
"count": 2,
"page": 1,
"total_count": 2202,
"total_pages": 734
}List retired and renamed apps
List the apps that left Flathub: the ones renamed to a new id, with that id, and the ones retired, with Flathub's note on why and what to use instead. Use it to keep an install script or a fleet of machines current.
Inputs
- Which apps
whichtext - Renamed apps, retired apps, or both.One of:
all(Renamed and retired apps),renamed(Only apps renamed to a new id),end_of_life(Only apps retired with a message). Default:all. - Id contains
id_containstext - Only apps whose old id contains this text. Leave it empty for all of them.
- How many to return
limitnumber - How many apps to return, in id order. Defaults to 100, and the result says how many matched.From 1 to 1000. Default:
100.
Outputs
appslist- The apps, in id order
countnumber- How many apps are in this result
id_containstext- The text the ids were narrowed to, empty when they were not
matched_countnumber- How many matched before the limit trimmed the list
whichtext- all, renamed or end_of_life: which apps were asked for
Example output
{
"apps": [
{
"app_id": "com.getferdi.Ferdi",
"message": "",
"renamed_to": "org.ferdium.Ferdium"
}
],
"count": 1,
"id_contains": "ferdi",
"matched_count": 1,
"which": "renamed"
}List trending apps
List the apps whose installs grew fastest over the last two weeks, which surfaces new and rising apps rather than the usual favourites.
Inputs
- How many to return
limitnumber - How many apps to return, from the top of the list. Defaults to 25, and 250 is the most.From 1 to 250. Default:
25. - Page
pagenumber - Which page of the list to return, from 1. Page 2 holds the apps after the first page, at the same number per page.At least 1. Default:
1.
Outputs
appslist- The apps, in the order Flathub ranks them
countnumber- How many apps are in this result
pagenumber- Which page of the list this is, from 1
total_countnumber- How many apps the list holds across every page
total_pagesnumber- How many pages the list has at this page size
Example output
{
"apps": [
{
"added_at": "2026-10-15T12:31:07Z",
"app_id": "io.github.riyaniii.Kaori",
"architectures": [
"aarch64",
"x86_64"
],
"category": "utility",
"category_name": "Utilities",
"developer": "Riyan Parvez",
"favorites": 2,
"icon_url": "https://dl.flathub.org/media/io/github/riyaniii.Kaori/e04cde4b554da04b7545034ff554a0d7/icons/128x128/io.github.riyaniii.Kaori.png",
"installs_last_month": 1185,
"is_free_license": true,
"license": "GPL-3.0-only",
"mobile_friendly": false,
"name": "Kaori",
"runtime": "org.gnome.Platform/x86_64/51",
"subcategories": [],
"summary": "Discover and read comics",
"trending_score": 20.0,
"updated_at": "2026-10-18T13:41:58Z",
"url": "https://flathub.org/apps/io.github.riyaniii.Kaori",
"verified": true,
"verified_as": "riyaniii.github.io"
},
{
"added_at": "2026-03-22T15:17:12Z",
"app_id": "io.github.nacho.mundi",
"architectures": [
"aarch64",
"x86_64"
],
"category": "education",
"category_name": "Education",
"developer": "Ignacio Casal Quinteiro",
"favorites": 38,
"icon_url": "https://dl.flathub.org/media/io/github/nacho.mundi/cba4938dc1f08e6419b62e23b67a9c45/icons/128x128/io.github.nacho.mundi.png",
"installs_last_month": 1077,
"is_free_license": true,
"license": "GPL-3.0-or-later",
"mobile_friendly": false,
"name": "Mundi",
"runtime": "org.gnome.Platform/x86_64/50",
"subcategories": [
"Geography"
],
"summary": "Learn geography",
"trending_score": 20.0,
"updated_at": "2026-09-11T13:45:27Z",
"url": "https://flathub.org/apps/io.github.nacho.mundi",
"verified": true,
"verified_as": "GitHub account nacho"
}
],
"count": 2,
"page": 1,
"total_count": 3328,
"total_pages": 1110
}Search apps
Search Flathub's apps by name, description and keywords, the way the search box on flathub.org does. Narrow the results to a category, to free or proprietary apps, to a processor, to verified publishers or to apps that work on a phone. Every app comes back with its id, which the other actions take.
Inputs
- Search for
querytextRequired - What to look for, such as a kind of app or a name.
- Category
categorytext - Only apps in this category. Leave it empty for every category.
- Licence
licensingtext - Only free and open source apps, or only proprietary ones.One of:
any(Any licence),free(Free and open source only),proprietary(Proprietary only). Default:any. - Processor
architecturetext - Only apps built for this kind of processor.One of:
any,x86_64(x86_64 (most PCs)),aarch64(aarch64 (ARM, such as a Raspberry Pi)). Default:any. - Verified publishers only
verified_onlytrue/false - Only apps whose publisher Flathub has verified, such as Mozilla for Firefox.Default:
false. - Phone-friendly only
mobile_friendly_onlytrue/false - Only apps that adapt to a phone's screen.Default:
false. - How many to return
limitnumber - How many apps to return, best match first. Defaults to 20.From 1 to 100. Default:
20.
Outputs
appslist- The apps that matched, best match first
architecturetext- any, x86_64 or aarch64: the processor it was narrowed to
categorytext- The category it was narrowed to, empty when it was not
countnumber- How many apps are in this result
licensingtext- any, free or proprietary: the licences it was narrowed to
mobile_friendly_onlytrue/false- True when only phone-friendly apps were asked for
querytext- What was searched for
total_countnumber- About how many apps match in all; Flathub's search estimates this
verified_onlytrue/false- True when only verified apps were asked for
Example output
{
"apps": [
{
"added_at": "2023-02-23T11:58:12Z",
"app_id": "me.ahola.aphototoollibre",
"architectures": [
"aarch64",
"x86_64"
],
"category": "graphics",
"category_name": "Graphics & Photography",
"developer": "aphototoollibre",
"favorites": 4,
"icon_url": "https://dl.flathub.org/media/me/ahola/aphototoollibre/8ac25931cfddcb4823c7b5404848ee63/icons/128x128/me.ahola.aphototoollibre.png",
"installs_last_month": 1704,
"is_free_license": true,
"license": "GPL-3.0-or-later",
"mobile_friendly": false,
"name": "A Photo Tool (Libre)",
"runtime": "org.kde.Platform/x86_64/6.10",
"subcategories": [],
"summary": "Photo editor for Linux",
"trending_score": 2.41,
"updated_at": "2026-01-16T01:07:44Z",
"url": "https://flathub.org/apps/me.ahola.aphototoollibre",
"verified": true,
"verified_as": "ahola.me"
},
{
"added_at": "2026-10-14T13:05:53Z",
"app_id": "io.github.Duecki1.CalibRaw",
"architectures": [
"aarch64",
"x86_64"
],
"category": "graphics",
"category_name": "Graphics & Photography",
"developer": "Duecki",
"favorites": 0,
"icon_url": "https://dl.flathub.org/media/io/github/Duecki1.CalibRaw/3bc50d8a602683b889949afd12a00823/icons/128x128/io.github.Duecki1.CalibRaw.png",
"installs_last_month": 354,
"is_free_license": true,
"license": "GPL-3.0-or-later",
"mobile_friendly": false,
"name": "CalibRaw",
"runtime": "org.freedesktop.Platform/x86_64/26.08",
"subcategories": [
"Photography"
],
"summary": "Develop RAW photos with non-destructive editing",
"trending_score": 2.0,
"updated_at": "2026-10-20T00:22:06Z",
"url": "https://flathub.org/apps/io.github.Duecki1.CalibRaw",
"verified": true,
"verified_as": "GitHub account Duecki1"
}
],
"architecture": "any",
"category": "graphics",
"count": 2,
"licensing": "free",
"mobile_friendly_only": false,
"query": "photo editor",
"total_count": 8,
"verified_only": true
}