Questa pagina è disponibile solo in inglese.

Public API

Mera has one public data endpoint: the list of publications it reads. There's no public API for articles, headlines, topics or accounts.

The app's own GraphQL and inference endpoints are for the app. Reading news through them needs a signed-in session from a real device.

List publications

No key or account is needed.

curl --compressed https://mera.news/publications.json

This is the same data the publications directory uses, and it's the best address to use. It's about 2.3 MB, or about 330 KB with gzip.

The website reads it from the auth service, which you can also call directly:

curl https://auth.mera.news/public/v1/publications

Response

{
  "generatedAt": "2026-11-05T16:45:42.725Z",
  "count": 1,
  "publications": [
    {
      "id": "...",
      "name": "Example Daily",
      "names": { "de": "Beispiel Tageblatt" },
      "website": "https://example.com",
      "countryCode": "DEU",
      "countryIso2": "DE",
      "countryName": "Germany",
      "languages": ["de"],
      "type": "...",
      "categories": ["..."],
      "region": "..."
    }
  ]
}

Field	Type	Meaning
`id`	string	Mera's identifier for the publication
`name`	string	Display name
`names`	object, optional	Localised names, by language code, where they differ
`website`	string, optional	A site address for the publication, usually its homepage. Never a feed URL
`countryCode`	string	ISO 3166-1 alpha-3, or `GLOBAL` for international sources
`countryIso2`	string, optional	ISO 3166-1 alpha-2
`countryName`	string	English country name
`languages`	array	Language codes
`type`	string, optional	Kind of publication
`categories`	array	Subject categories
`region`	string, optional	Region within the country

For the feed URLs themselves, see the feed registry.

Limits and caching

Address	Cached	Limit
`mera.news/publications.json`	1 hour. The website refreshes its copy about every 6 hours	None published
`auth.mera.news/public/v1/publications`	1 hour	120 requests a minute across all callers, plus a limit per address

The list changes when feeds are added, so a daily fetch is plenty. On a failed refresh, the website can return a stale or empty list with a short cache life, so check count before you replace your copy.

Stability

This endpoint exists for Mera's own directory. Mera makes no stability promise for it today and may add fields.

Using the data

The list describes publications. The articles belong to their publishers. For how Mera reads feeds, see Crawler and feeds.