Flathub App Scraper

Fetches structured metadata for Linux apps published on Flathub — name, developer, license, verification status, release history, and runtime/SDK details — directly from Flathub's official appstream JSON API. Built for developers maintaining app catalogs, Linux distro tooling, package monitoring dashboards, or anyone tracking Flatpak app updates and licensing at scale.

Why this scraper

• Reads Flathub's official appstream JSON API instead of scraping rendered HTML, so fields like release history, verification method, runtime/SDK, and content-rating age come out structured and complete rather than parsed from markup.
• Returns 26 flattened fields per app, including release changelogs, developer verification, and license flags — data that thinner metadata scrapers typically don't expose.
• Priced at $0.002 per run, charged once per actor start regardless of how many app IDs you pass in.

Output fields

Field	Type	Description
appId	string	Flathub application ID, e.g. org.gimp.GIMP
name	string	Application display name
summary	string	Short one-line summary of the app
description	string	Full HTML description text
developerName	string	Name of the developer or team
projectLicense	string	SPDX project license identifier
isFreeLicense	boolean	Whether the license is a free/open-source license
categories	string	Comma-separated AppStream categories
keywords	string	Comma-separated search keywords
iconUrl	string	URL of the 128x128 app icon
homepageUrl	string	Project homepage URL
bugtrackerUrl	string	Bug tracker URL
donationUrl	string	Donation page URL
verified	boolean	Whether the developer identity is verified by Flathub
verificationMethod	string	Method used to verify the developer, e.g. website
isEol	boolean	Whether the app is marked end-of-life
latestVersion	string	Version string of the newest release
latestReleaseDate	string	Unix timestamp of the newest release
latestReleaseDescription	string	HTML changelog of the newest release
releaseCount	integer	Number of releases listed for the app
runtime	string	Flatpak runtime the app is built against
sdk	string	Flatpak SDK the app is built with
appType	string	AppStream component type, e.g. desktop-application
isMobileFriendly	boolean	Whether the app is flagged mobile-friendly
contentRatingAge	integer	Minimum content-rating age (ESRB) in years
screenshotCount	integer	Number of screenshots available for the app

Input

{
  "startUrls": [
    { "url": "https://flathub.org/api/v2/appstream/org.gimp.GIMP" }
  ],
  "maxItems": 50
}

Output

{
  "appId": "org.gimp.GIMP",
  "name": "GNU Image Manipulation Program",
  "summary": "High-end image creation and manipulation",
  "developerName": "The GIMP team",
  "projectLicense": "GPL-3.0+ AND LGPL-3.0+",
  "isFreeLicense": true,
  "categories": "Graphics, 2DGraphics, RasterGraphics",
  "keywords": "GIMP, Photoshop",
  "iconUrl": "https://dl.flathub.org/media/org/gimp/GIMP/ab48223ba11e3bad9493fcda45e9ac04/icons/128x128/org.gimp.GIMP.png",
  "homepageUrl": "https://www.gimp.org/",
  "bugtrackerUrl": "https://gitlab.gnome.org/GNOME/gimp/issues/new",
  "donationUrl": "https://www.gimp.org/donating/",
  "verified": true,
  "verificationMethod": "website",
  "isEol": false,
  "latestVersion": "3.2.4",
  "latestReleaseDate": "1776384000",
  "releaseCount": 4,
  "runtime": "org.gnome.Platform/x86_64/50",
  "sdk": "org.gnome.Sdk/x86_64/50",
  "appType": "desktop-application",
  "isMobileFriendly": false,
  "contentRatingAge": 3,
  "screenshotCount": 4
}

Pricing

$0.002 per actor run, charged once regardless of how many app IDs you list in startUrls. Scraping 50 apps in a single run still costs $0.002 total.

Use cases

• Maintaining a third-party Flatpak catalog or search index that needs license, verification, and runtime data not shown in the Flathub web UI.
• Monitoring a set of apps for new releases by polling latestVersion and latestReleaseDate on a schedule.
• Auditing Flatpak dependencies across a distro or CI pipeline for license compliance using projectLicense and isFreeLicense.