# Feed syndication (RSS / Atom)

Vulnerability-Lookup exposes RSS and Atom feeds for new vulnerabilities,
Known Exploited Vulnerabilities (KEV), sightings, comments, bundles, and
individual user activity. Feeds are designed for low-volume, human-facing
consumers — RSS readers, chat-room bots, alert pipes, dashboards — where a
small set of recent items is enough.

```{tip}
Building a mirror, scanner, or other large-scale automated consumer?
Feeds are not the right tool — paginated history is capped per feed.
See [Access patterns for automated consumers](access-patterns.md) for
the canonical sync path (`since=` over the [API](api.md), plus the
pub/sub stream where the operator enables it).
```

## Available endpoints

| Path | Purpose |
| --- | --- |
| `/recent/{source}.{format}` | Recent vulnerabilities, per source or across all sources. Optional `?vendor={vendor-id}` filters by vendor; optional `?vulnerability={vuln-id}` returns vulnerabilities linked to the given one. |
| `/recent/{source}.md` | One page of recent vulnerabilities as Markdown, for notes and tickets rather than for readers. `?mode=index` (the default) lists the identifiers as links; `?mode=full` also embeds each stored record as it came from the source (bounded to 8 MiB per page, without the enrichment shown on the vulnerability page). Takes the same `page`, `date_sort` and `sort_order` as `/recent`, so it exports exactly the page on screen. |
| `/known-exploited-vulnerabilities-catalog/feed.{format}` | Recent entries from a single [GCVE BCP-07](https://gcve.eu/bcp/gcve-bcp-07/) KEV catalog. Optional `?catalog_uuid={uuid}` selects a catalog; omitted, it returns this instance's local catalog. |
| `/kev-catalogs/feed.{format}` | Recent KEV entries aggregated across every GCVE BCP-07 catalog known to this instance; each entry is labelled with its originating catalog. |
| `/sightings/feed.{format}` | Recent sightings (across all vulnerabilities). Optional `?vulnerability={vuln-id}`, `?source={source}` and `?user={login}` narrow it down. |
| `/sightings/cpesearch/{cpe}/feed.{format}` | Recent sightings for any vulnerability affecting the given CPE. |
| `/comments/feed.{format}` | Recent comments. Optional `?user={login}` and `?vulnerability={vuln-id}` narrow it down. |
| `/bundles/feed.{format}` | Recent bundles. Optional `?user={login}` narrows to one author. |
| `/user/{login}.{format}` | Recent activity (sightings, comments, bundles) for a given user. |
| `/product/{uuid}/recent.{format}` | Recent vulnerabilities matching a product's CPE names. |
| `/organization/{uuid}/recent.{format}` | Recent vulnerabilities of an organization. `?tab=products` (default), `gna` or `cna`, as on its page. |
| `/cna-root/{root}/recent.{format}` | Latest vulnerabilities published under a CNA root. |
| `/user/notifications/watchlist/feed.{format}?X-FEED-KEY={key}` | Your watchlist. The feed key is on your profile page. |

### `{format}`

Either `rss` or `atom`. Both contain the same items; pick whichever your
reader prefers. Another suffix is a 404 on `/recent` (except `.md`, the Markdown
export above), `/product` and `/organization`; the other feeds serve RSS.

### `{source}`

Either `all`, or any source identifier configured on this instance (`all` is not
accepted by the `.md` export). The
authoritative list for a given deployment is exposed on `/about` and on
[https://www.vulnerability-lookup.org/sources](https://www.vulnerability-lookup.org/sources).
Common identifiers include (some are disabled in the sample `modules.cfg`):

- **Core:** `cvelistv5`, `nvd`, `fkie_nvd`, `github`, `pysec`, `gsd`
- **Community & national databases:** `jvndb`, `cnvd`, `fstec`, `variot`, `tailscale`, `bitnami_vulndb`, `cleanstart`, `drupal`, `ossf_malicious_packages`, `emb3d`, `avid`
- **CERT-FR:** `certfr_avis`, `certfr_alerte`
- **CSAF providers:** `csaf_abb`, `csaf_certbund`, `csaf_cisa`, `csaf_cisco`, `csaf_microsoft`, `csaf_ncscnl`, `csaf_nozominetworks`, `csaf_opensuse`, `csaf_ox`, `csaf_redhat`, `csaf_se`, `csaf_sick`, `csaf_siemens`, `csaf_suse`, `csaf_trustsource`, `csaf_tuxcare`
- **OSV:** `osv_almalinux`, `osv_bellsoft`, `osv_haskell`, `osv_homebrew`, `osv_ocaml`, `osv_openeuler`, `osv_ossfuzz`, `osv_rocky`, `osv_rustsec`, `osv_ubuntu`
- **Weakness & attack pattern catalogs:** `cwec`, `capec`
- **GNAs:** `gna-<id>`, one per GNA whose records this instance pulls

```{note}
Enrichment feeders — `vulnrichment` (CISA ADP), `epss`, `redhat_vex`
(Red Hat CSAF VEX), `microsoft_vex` (Microsoft CSAF VEX) and `suse_vex` (SUSE CSAF VEX) — are **not**
feed sources: they attach metadata to existing CVE records instead of creating
records of their own, so a `/recent/{source}` feed for them is always empty.
Their data is exposed on the vulnerability page, in the VEX top-menu index,
and through the [API](api.md): `with_meta=true` on the vulnerability endpoints,
`/api/epss/{vuln_id}`, `/api/vex/` to browse available VEX records and pivot to
the related vulnerability, and `/api/vex/{vuln_id}` (with the stored CSAF
document at `/api/vex/{vuln_id}/{source}/csaf`).
```

### Known Exploited Vulnerabilities (KEV) feeds

Two KEV feeds are available, both over the [GCVE BCP-07](https://gcve.eu/bcp/gcve-bcp-07/)
KEV catalogs the instance knows about (the CISA KEV catalog is one of them,
imported by [gcve-eu-kev](https://github.com/gcve-eu/gcve-eu-kev)):

- **`/known-exploited-vulnerabilities-catalog/feed.{format}`** — a single
  **GCVE BCP-07** KEV catalog. Without parameters it returns this
  instance's *local* catalog. Pass `?catalog_uuid={uuid}` to follow a
  specific catalog (for example CISA KEV, EUVD KEV, or another instance's
  catalog). Entries are ordered by their BCP-07 `status_updated_at`, so
  the feed reflects recent exploitation-status activity, and include
  status, exploitation flag, characteristics, evidence count, and
  timestamps.

- **`/kev-catalogs/feed.{format}`** — the same BCP-07 entries, but
  **aggregated across every catalog** the instance knows about, newest
  status update first. Each entry title is prefixed with its originating
  catalog (e.g. `[CISA KEV]`, `[EUVD KEV]`).

```{note}
The catalog feeds are *recent-activity streams*: they carry the most
recently updated entries, not the full catalog. A vulnerability can appear
in the coverage table on the `/kev-catalogs` page yet be absent from the
feed simply because its last status update is older than the feed window.
For the complete contents of a catalog, use the NDJSON
export (`/known-exploited-vulnerabilities-catalog/export.ndjson`) or the
[KEV API](api.md). The same CVE may also appear more than once in the
aggregated feed when several catalogs reference it — once per catalog.
```

The UUIDs of the catalogs known to a given instance are listed on its
`/kev-catalogs` page.

The former `/known-exploited-vulnerabilities.{format}` feed, which served
the CISA list from a separate non-BCP-07 mirror, now redirects permanently
to `/kev-catalogs/feed.{format}`.

### Pagination

Feeds accept `page` and `per_page` query parameters. `per_page` is
**capped** per instance by `FEED_MAX_PER_PAGE` in `config/website.py`
(default `50`); requests above the cap are clamped to it. Each feed has
its own default page size, applied when `per_page` is omitted — most
readers don't paginate, so the default is sized for one page of recent
items:

- Most feeds (recent vulnerabilities, sightings, comments, bundles, user
  activity) default to **10** entries.
- The KEV catalog feeds (`/known-exploited-vulnerabilities-catalog` and
  `/kev-catalogs`) default to **20** entries.

## Examples

### Subscribing to recent vulnerabilities

All sources, Atom format:

```bash
$ curl https://vulnerability.circl.lu/recent/all.atom
```

A single source:

```bash
$ curl https://vulnerability.circl.lu/recent/pysec.atom
```

### Filtering recent vulnerabilities

By vendor:

```bash
$ curl 'https://vulnerability.circl.lu/recent/cvelistv5.atom?vendor=MISP&per_page=2&page=8'
```

Vulnerabilities linked to a specific vulnerability (e.g. cross-source
correlation, follow-ups):

```bash
$ curl 'https://vulnerability.circl.lu/recent/all.atom?vulnerability=cve-2021-22280'
```

Sample response:

```xml
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
  <id>https://vulnerability.circl.lu/rss/recent/all/10</id>
  <title>Most recent entries from all</title>
  <updated>2024-11-26T08:03:09.000211+00:00</updated>
  <author>
    <name>Vulnerability-Lookup</name>
    <email>info@circl.lu</email>
  </author>
  <link href="https://vulnerability.circl.lu" rel="alternate"/>
  <subtitle>Contains only the most 10 recent entries.</subtitle>
  <entry>
    <id>https://vulnerability.circl.lu/vuln/ghsa-x53h-2cjp-mwcx</id>
    <title>ghsa-x53h-2cjp-mwcx</title>
    <updated>2024-11-26T08:03:09.013675+00:00</updated>
    <link href="https://vulnerability.circl.lu/vuln/ghsa-x53h-2cjp-mwcx"/>
  </entry>
  <!-- ... -->
</feed>
```

### Subscribing to Known Exploited Vulnerabilities

This instance's local GCVE BCP-07 catalog:

```bash
$ curl https://vulnerability.circl.lu/known-exploited-vulnerabilities-catalog/feed.atom
```

A specific BCP-07 catalog by UUID (UUIDs are listed on `/kev-catalogs`):

```bash
$ curl 'https://vulnerability.circl.lu/known-exploited-vulnerabilities-catalog/feed.atom?catalog_uuid=405284c2-e461-4670-8979-7fd2c9755a60'
```

All catalogs at once, aggregated and labelled by source:

```bash
$ curl https://vulnerability.circl.lu/kev-catalogs/feed.atom
```

### Subscribing to sightings

For a specific vulnerability:

```bash
$ curl 'https://vulnerability.circl.lu/sightings/feed.atom?vulnerability=CVE-2024-0012'
```

For every vulnerability affecting a product (CPE):

```bash
$ curl 'https://vulnerability.circl.lu/sightings/cpesearch/cpe:2.3:a:fortinet:forticlient_enterprise_management_server:*:*:*:*:*:*:*:*/feed.atom'
```

Sightings are aggregated from various trusted sources, including security
websites, Exploit-DB, GitHub repositories, security blogs, social
networks, and MISP.

### Subscribing to comments, bundles, or user activity

Recent comments across the instance:

```bash
$ curl https://vulnerability.circl.lu/comments/feed.atom
```

Comments by a single user:

```bash
$ curl 'https://vulnerability.circl.lu/comments/feed.atom?user=alice'
```

Recent activity for a single user (sightings + comments + bundles in one
feed):

```bash
$ curl https://vulnerability.circl.lu/user/alice.atom
```

## See also

- [API](api.md) — paginated, programmatic access including
  `since=`-based incremental sync, cross-source correlation, and the
  full OpenAPI specification.
- [Access patterns for automated consumers](access-patterns.md) —
  authoritative guidance on which surface to use for which use case
  (feeds vs. API vs. stream vs. bulk dumps), identification etiquette,
  and rate-limit posture.
