# Flathub

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/flathub

## Actions

### 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 (`app`, text, required): 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_id` (text): The app's Flathub id, such as org.gimp.GIMP, which every app field takes
- `bug_tracker_url` (text): Where bugs are reported; often empty
- `categories` (list): The desktop categories the app lists, such as Graphics
- `description` (text): The app's full description as plain text
- `developer` (text): Who publishes the app
- `donation_url` (text): Where to donate to its developers; often empty
- `end_of_life_message` (text): Flathub's note on why it is end of life; often empty
- `found` (true/false): False when Flathub has no app with that id; renamed_to and end_of_life_message then say why when Flathub knows
- `help_url` (text): Its help pages; often empty
- `homepage_url` (text): The app's own website
- `icon_url` (text): The app's icon
- `install_command` (text): The command that installs it from Flathub
- `is_end_of_life` (true/false): True when the app is no longer maintained on Flathub
- `is_free_license` (true/false): True when the licence is a free software licence
- `keywords` (list): Search words the developer gave the app
- `latest_release_date` (text): When the newest version came out, as YYYY-MM-DD
- `latest_version` (text): The newest version listed
- `license` (text): The app's licence as an SPDX id, or Proprietary
- `minimum_age` (number): The youngest age its content rating suits, and 0 for all ages
- `mobile_friendly` (true/false): True when the app adapts to phone screens
- `name` (text): The app's name
- `releases` (list): Its recent releases, newest first
- `renamed_to` (text): The app's new id when the one asked for was renamed; empty otherwise
- `runtime` (text): The Flatpak runtime it is built on
- `screenshot_urls` (list): Its screenshots, at the largest size published
- `searched_for` (text): What was typed in the app field
- `source_code_url` (text): Where its source code is browsed; often empty
- `summary` (text): One line on what the app does
- `translate_url` (text): Where to help translate it; often empty
- `type` (text): What kind of entry this is, such as desktop-application
- `url` (text): The app's page on flathub.org, or its new page when renamed
- `verified` (true/false): True when Flathub has verified who publishes the app
- `verified_as` (text): Who the publisher was verified as: a website, an account, or Checked by Flathub; empty when unverified

**Example output**

```json
{
  "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 (`app`, text, required): 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 (`days`, number): 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_id` (text): The app's Flathub id, such as org.gimp.GIMP, which every app field takes
- `country_count` (number): How many countries it has been installed in
- `daily_installs` (list): Installs day by day, oldest first, up to the last day Flathub has finished counting
- `days` (number): How many days of daily installs were asked for
- `installs_in_period` (number): Installs over those days added up
- `installs_last_7_days` (number): Installs over the last 7 days
- `installs_last_month` (number): Installs over the last 30 days
- `installs_total` (number): Installs since it was added to Flathub
- `name` (text): The app's name
- `top_countries` (list): The ten countries with the most installs, most first

**Example output**

```json
{
  "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 (`app`, text, required): 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_id` (text): The app's Flathub id, such as org.gimp.GIMP, which every app field takes
- `architectures` (list): The processors it runs on
- `branch` (text): The Flatpak branch described, usually stable
- `command` (text): The command the app starts with
- `devices` (list): The devices it may use, such as all or dri
- `download_size` (text): The download size written out, such as 102.1 MB
- `download_size_bytes` (number): How much is downloaded to install it, in bytes
- `downloads_extra_data` (true/false): True when installing it downloads parts from its publisher rather than Flathub
- `filesystems` (list): The folders it may reach, as Flatpak writes them
- `full_file_access` (true/false): True when it may read the whole home folder or the whole system
- `installed_size` (text): The installed size written out, such as 268.2 MB
- `installed_size_bytes` (number): How much disk space it takes, in bytes
- `name` (text): The app's name
- `network_access` (true/false): True when the app may use the network
- `runtime` (text): The Flatpak runtime it needs, such as org.gnome.Platform/x86_64/49
- `runtime_is_end_of_life` (true/false): True when the runtime it needs no longer gets updates
- `runtime_name` (text): The runtime's name, such as GNOME Application Platform version 49
- `session_bus_access` (list): Desktop services it may talk to
- `sockets` (list): The display, sound and other sockets it may use
- `system_bus_access` (list): System services it may talk to
- `updated_at` (text): When this build was published, as an ISO 8601 UTC time
- `url` (text): The app's page on flathub.org

**Example output**

```json
{
  "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 (`date`, date): 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_id` (text): The app's Flathub id, such as org.gimp.GIMP, which every app field takes
- `date` (text): The day, as YYYY-MM-DD
- `developer` (text): Who publishes the app
- `icon_url` (text): The app's icon
- `install_command` (text): The command that installs it from Flathub
- `is_stand_in` (true/false): True when nothing was picked for that day and Flathub answered with Kodi, its stand-in
- `name` (text): The app's name
- `summary` (text): One line on what the app does
- `url` (text): The app's page on flathub.org

**Example output**

```json
{
  "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 (`date`, date): Any day in the week to look up. Leave it empty for this week.

**Outputs**

- `apps` (list): The week's apps, in the order Flathub shows them
- `count` (number): How many apps were picked; 0 when none are scheduled yet
- `date` (text): The day asked about, as YYYY-MM-DD
- `week_number` (number): The ISO week number that day falls in

**Example output**

```json
{
  "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 (`days`, number): 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_count` (number): How many apps Flathub has
- `daily_downloads` (list): Downloads day by day, oldest first, up to the last day Flathub has finished counting
- `days` (number): How many days of daily downloads were asked for
- `downloads_in_period` (number): Downloads over those days added up
- `top_countries` (list): The ten countries with the most downloads, most first
- `total_downloads` (number): Downloads from Flathub since 2018
- `verified_app_count` (number): How many of them are verified

**Example output**

```json
{
  "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 (`year`, number): The year to review, from 2018. Leave it empty for last year; the current year is published once it ends. At least 2018.

**Outputs**

- `architectures` (list): Downloads by processor
- `best_newcomers` (list): The most downloaded new app in each category
- `downloads_change` (number): How many more downloads than the year before
- `downloads_change_percentage` (number): The change on the year before, in percent
- `hidden_gems` (list): Apps Flathub picked as hidden gems
- `new_app_count` (number): Apps added that year
- `top_apps` (list): The most downloaded apps that year
- `top_countries` (list): The countries with the most downloads that year
- `top_games` (list): The most downloaded games that year
- `total_app_count` (number): Apps on Flathub at the end of the year
- `total_downloads` (number): Downloads that year
- `update_count` (number): Updates downloaded that year
- `year` (number): The year reviewed

**Example output**

```json
{
  "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 (`developer`, text, required): The developer's name as an app's page on flathub.org shows it. Capitals do not matter.
- How many to return (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `developer` (text): The developer whose apps these are
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`app`, text, required): 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**

- `addons` (list): The add-ons, in id order
- `app_id` (text): The app's Flathub id, such as org.gimp.GIMP, which every app field takes
- `count` (number): How many add-ons it has
- `name` (text): The app's name
- `url` (text): The app's page on flathub.org

**Example output**

```json
{
  "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 (`category`, text, required): Which category to list.
- Subcategory (`subcategory`, text): 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 (`sort`, text): How to rank the apps. One of: `popular` (Most installed last month), `trending`. Default: `popular`.
- How many to return (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `category` (text): The category's id
- `category_name` (text): The category's name on flathub.org
- `count` (number): How many apps are in this result
- `page` (number): Which page of the list this is, from 1
- `sort` (text): popular or trending: how the apps are ordered
- `subcategory` (text): The subcategory it was narrowed to, empty when it was not
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`keyword`, text, required): The keyword, as one word or a short phrase.
- How many to return (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `keyword` (text): The keyword asked for
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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**

- `categories` (list): Flathub's main categories
- `count` (number): How many categories there are
- `total_apps` (number): How many apps Flathub lists in all

**Example output**

```json
{
  "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 (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`which`, text): 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_contains`, text): Only apps whose old id contains this text. Leave it empty for all of them.
- How many to return (`limit`, number): 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**

- `apps` (list): The apps, in id order
- `count` (number): How many apps are in this result
- `id_contains` (text): The text the ids were narrowed to, empty when they were not
- `matched_count` (number): How many matched before the limit trimmed the list
- `which` (text): all, renamed or end_of_life: which apps were asked for

**Example output**

```json
{
  "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 (`limit`, number): 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 (`page`, number): 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**

- `apps` (list): The apps, in the order Flathub ranks them
- `count` (number): How many apps are in this result
- `page` (number): Which page of the list this is, from 1
- `total_count` (number): How many apps the list holds across every page
- `total_pages` (number): How many pages the list has at this page size

**Example output**

```json
{
  "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 (`query`, text, required): What to look for, such as a kind of app or a name.
- Category (`category`, text): Only apps in this category. Leave it empty for every category.
- Licence (`licensing`, text): 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 (`architecture`, text): 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_only`, true/false): Only apps whose publisher Flathub has verified, such as Mozilla for Firefox. Default: `false`.
- Phone-friendly only (`mobile_friendly_only`, true/false): Only apps that adapt to a phone's screen. Default: `false`.
- How many to return (`limit`, number): How many apps to return, best match first. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

- `apps` (list): The apps that matched, best match first
- `architecture` (text): any, x86_64 or aarch64: the processor it was narrowed to
- `category` (text): The category it was narrowed to, empty when it was not
- `count` (number): How many apps are in this result
- `licensing` (text): any, free or proprietary: the licences it was narrowed to
- `mobile_friendly_only` (true/false): True when only phone-friendly apps were asked for
- `query` (text): What was searched for
- `total_count` (number): About how many apps match in all; Flathub's search estimates this
- `verified_only` (true/false): True when only verified apps were asked for

**Example output**

```json
{
  "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
}
```
