# Flathub — Zapi reference

> Linux desktop apps as Flatpaks — licence, runtime and SDK, content rating, publisher verification, plus install counts broken down by day and by country.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/application/flathub
- Endpoint catalog: https://zpi.web.id/category/application
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Flathub

**Category:** application · **Slug:** `flathub`
**Detail page:** https://zpi.web.id/api/application/flathub

Linux desktop apps as Flatpaks — licence, runtime and SDK, content rating, publisher verification, plus install counts broken down by day and by country.

### App Detail

One Flatpak's appstream record — licence, runtime and SDK, content rating, mimetypes, and whether Flathub verified the publisher.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/application:flathub/app`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | query | yes | Flatpak application id |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/application:flathub/app?id=org.mozilla.firefox" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/application:flathub/app?id=org.mozilla.firefox", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/application:flathub/app?id=org.mozilla.firefox",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "org.mozilla.firefox",
  "sdk": "org.freedesktop.Sdk/x86_64/25.08",
  "url": "https://flathub.org/apps/org.mozilla.firefox",
  "free": true,
  "icon": "https://dl.flathub.org/media/icons/128x128/org.mozilla.firefox.png",
  "name": "Firefox",
  "type": "desktop",
  "price": 0,
  "bundle": "app/org.mozilla.firefox/x86_64/stable",
  "source": "flathub",
  "license": "MPL-2.0",
  "runtime": "org.freedesktop.Platform/x86_64/25.08",
  "summary": "Fast, Private & Safe Web Browser",
  "keywords": [
    "Browser",
    "Explorer",
    "Internet"
  ],
  "verified": true,
  "developer": {
    "name": "Mozilla"
  },
  "endOfLife": false,
  "mimetypes": [
    "application/json",
    "application/pdf",
    "application/rdf+xml",
    "application/rss+xml",
    "application/x-xpinstall",
    "application/xhtml+xml",
    "application/xml",
    "audio/flac"
  ],
  "categories": [
    "Network",
    "WebBrowser"
  ],
  "description": "When it comes to your life online, you have a choice: accept the factory settings or put your privacy first. When you choose Firefox as your default browser, you’re choosing to protect your data while supporting an independent tech company. Firefox is also the only major browser backed by a non-profit fighting to give you more openness, transparency and control of your life online. Join hundreds of millions of people who choose to protect what's important by choosing Firefox - a web browser designed to be fast, easy to use, customizable and private.",
  "freeLicense": true,
  "manifestUrl": "https://hg.mozilla.org/mozilla-central/file/tip/browser/installer/linux/app/flatpak",
  "contentRating": "Early Childhood",
  "mobileFriendly": false,
  "contentRatingAge": 3,
  "verificationMethod": "manual",
  "contentRatingSystem": "ESRB"
}
```

---

### Collections

One of the store's curated lists: popular, recently added, recently updated, trending, verified, or mobile.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/application:flathub/collection`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `collection` | enum(popular|recently-added|recently-updated|trending|verified|mobile) | query | no | Which list. Default popular. |
| `page` | number | query | no | Result page. Default 1. |
| `count` | number | query | no | Items per page. Default 25, max 100. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/application:flathub/collection?collection=popular&page=1&count=25" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/application:flathub/collection?collection=popular&page=1&count=25", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/application:flathub/collection?collection=popular&page=1&count=25",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 10,
  "items": [
    {
      "id": "org.vinegarhq.Sober",
      "url": "https://flathub.org/apps/org.vinegarhq.Sober",
      "free": true,
      "icon": "https://dl.flathub.org/media/org/vinegarhq/Sober/53a35f34cedfbd06c961a0f84bfb076f/icons/128x128/org.vinegarhq.Sober.png",
      "name": "Sober",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "LicenseRef-proprietary=https://sober.vinegarhq.org/notice.txt",
      "summary": "Play, chat & explore on Roblox",
      "updated": 1787001453,
      "installs": 235549,
      "verified": true,
      "developer": {
        "name": "VinegarHQ & Sober contributors"
      }
    },
    {
      "id": "org.mozilla.firefox",
      "url": "https://flathub.org/apps/org.mozilla.firefox",
      "free": true,
      "icon": "https://dl.flathub.org/media/icons/128x128/org.mozilla.firefox.png",
      "name": "Firefox",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "MPL-2.0",
      "summary": "Fast, Private & Safe Web Browser",
      "updated": 1786451271,
      "installs": 197829,
      "verified": true,
      "developer": {
        "name": "Mozilla"
      }
    },
    {
      "id": "com.discordapp.Discord",
      "url": "https://flathub.org/apps/com.discordapp.Discord",
      "free": true,
      "icon": "https://dl.flathub.org/media/com/discordapp/Discord/cdbdd79ba164f5bb18fcd4788f93de44/icons/128x128/com.discordapp.Discord.png",
      "name": "Discord",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "LicenseRef-proprietary",
      "summary": "Talk, play, hang out",
      "updated": 1786744896,
      "installs": 190446,
      "verified": true,
      "developer": {
        "name": "Discord Inc."
      }
    },
    {
      "id": "com.google.Chrome",
      "url": "https://flathub.org/apps/com.google.Chrome",
      "free": true,
      "icon": "https://dl.flathub.org/media/com/google/Chrome/b385eea1b44c96758801ce1d76b3b110/icons/128x128/com.google.Chrome.png",
      "name": "Google Chrome",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "LicenseRef-proprietary",
      "summary": "The browser built to be yours",
      "updated": 1786564851,
      "installs": 182541,
      "developer": {
        "name": "Google"
      }
    },
    {
      "id": "com.brave.Browser",
      "url": "https://flathub.org/apps/com.brave.Browser",
      "free": true,
      "icon": "https://dl.flathub.org/media/com/brave/Browser/94f633aaad7b8a1567a2f56b38c54fc2/icons/128x128/com.brave.Browser.png",
      "name": "Brave",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "MPL-2.0",
      "summary": "Fast Internet, AI, Adblock",
      "updated": 1786555668,
      "installs": 166797,
      "verified": true,
      "developer": {
        "name": "Brave Software"
      }
    },
    {
      "id": "com.usebottles.bottles",
      "url": "https://flathub.org/apps/com.usebottles.bottles",
      "free": true,
      "icon": "https://dl.flathub.org/media/com/usebottles/bottles/4a2b5d5a5471c40929c6e016c45b3da0/icons/128x128/com.usebottles.bottles.png",
      "name": "Bottles",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "GPL-3.0-only",
      "summary": "Run Windows software",
      "updated": 1786907809,
      "installs": 147427,
      "verified": true,
      "developer": {
        "name": "The Bottles Contributors"
      }
    },
    {
      "id": "org.videolan.VLC",
      "url": "https://flathub.org/apps/org.videolan.VLC",
      "free": true,
      "icon": "https://dl.flathub.org/media/org/videolan/VLC/34e7c2b6a026c5c290606225a84582d3/icons/128x128/org.videolan.VLC.png",
      "name": "VLC",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "GPL-2.0+",
      "summary": "VLC media player, the open-source multimedia player",
      "updated": 1784336350,
      "installs": 127046,
      "developer": {
        "name": "VideoLAN et al."
      }
    },
    {
      "id": "com.spotify.Client",
      "url": "https://flathub.org/apps/com.spotify.Client",
      "free": true,
      "icon": "https://dl.flathub.org/media/com/spotify/Client/2be38d678bbcc0e04cec0c19c60a80fe/icons/128x128/com.spotify.Client.png",
      "name": "Spotify",
      "type": "desktop-application",
      "price": 0,
      "source": "flathub",
      "license": "LicenseRef-proprietary=https://www.spotify.com/us/legal/end-user-agreement/",
      "summary": "Online music streaming service",
      "updated": 1786557109,
      "installs": 124086,
      "developer": {
        "name": "Spotify"
      }
    }
  ],
  "total": 3299,
  "source": "flathub",
  "hasMore": true,
  "nextPage": 2,
  "collection": "popular"
}
```

---

### Install Stats

Install counts for one app — the running total, the last month and week, a daily series, and the full per-country breakdown the store page never renders.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/application:flathub/stats`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | query | yes | Flatpak application id |
| `days` | number | query | no | How many recent days of the daily series to return. Default 30, max 365. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/application:flathub/stats?id=org.mozilla.firefox&days=30" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/application:flathub/stats?id=org.mozilla.firefox&days=30", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/application:flathub/stats?id=org.mozilla.firefox&days=30",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "org.mozilla.firefox",
  "count": 14,
  "daily": [
    {
      "date": "2026-08-03",
      "installs": 6346
    },
    {
      "date": "2026-08-04",
      "installs": 6333
    },
    {
      "date": "2026-08-05",
      "installs": 6387
    },
    {
      "date": "2026-08-06",
      "installs": 6271
    },
    {
      "date": "2026-08-07",
      "installs": 6887
    },
    {
      "date": "2026-08-08",
      "installs": 7255
    },
    {
      "date": "2026-08-09",
      "installs": 7102
    },
    {
      "date": "2026-08-10",
      "installs": 6314
    }
  ],
  "source": "flathub",
  "byCountry": [
    {
      "country": "US",
      "installs": 1545775
    },
    {
      "country": "DE",
      "installs": 361790
    },
    {
      "country": "GB",
      "installs": 294332
    },
    {
      "country": "BR",
      "installs": 201969
    },
    {
      "country": "RU",
      "installs": 194713
    },
    {
      "country": "CA",
      "installs": 171227
    },
    {
      "country": "FR",
      "installs": 162500
    },
    {
      "country": "ES",
      "installs": 117814
    }
  ],
  "installsTotal": 12006593,
  "installsLast7Days": 39885,
  "installsLastMonth": 197829
}
```

---


_Generated: 2026-08-18T06:06:42.779Z_