Feed

https://feed.mfn.se/v1

Description

Endpoint for fetching press releases. Support filtering by query params like (type, tag, lang, etc) and pagination using offset/limit.

By default 48 items are fetched unless the limit query param is used, max limit is 500. The feed contains automatically calculated URLs with offset/limit for pagination in the next_url/prev_url fields.

The feed_id is provided by us when initiating the integration.

All items returned according to the following model

Model

All allowed query params are documented below (click to expand)

Get Press Release Feed

GET https://feed.mfn.se/v1/feed/:feed_id[.format]

Returns a feed of press releases filtered by the query params. Available in both JSON (default) and XML formats. Use .json or .xml to select format.

Path Parameters

Name	Type	Description
feed_id*	string	Feed Id Provided by MFN Team
format	string	Format of the feed to return. Defaults to json [ json | xml ]

Query Parameters

Name	Type	Description
type	string	Press release type [ ir | pr ]
tag	string	Include items that matches tag Examples: All Reports tag=sub:report Annual Reports tag=sub:report:annual Regulatory releases tag=:regulatory
lang	string	Filter items by lang (ISO 639-1 two-letter lang code)
filter	string	Advanced filtering
query	string	Basic text search Currently uses no stemming or fuzzy search The feed query search applies prefix matching. For example the search query=share would find texts containing words starting with or equal to share like share and shareholder but not words where the query is contained or postfixed like timeshare. The results are then returned ordered by the frequency of their matching lexemes.
from	string	Returns items with a .content.publish_date above this date. RFC3339 formatted. Note: needs to be URL formatted.Example: RFC3339 Input: 2021-01-01T00:00:00Z Query param: from=2021-01-01T00%3A00%3A00Z
to	string	Returns items with a .content.publish_date below this date. RFC3339 formatted. Note: needs to be URL formatted.Example: RFC3339 Input: 2021-12-31T23:59:59Z Query Param: to=2021-12-31T23%3A59%3A59Z
source	string	Press release source
news-slug	string	Filter by the specified news item slug. This is the .content.slug field of a News Item
group-id	string	Filter by the specified group_id If the content is tagged correctly this should return all news items belonging to the same group. Basically all language versions of the same press release.
news-id	string	Filter by the specifiednews_id Note: will only return one item
compact	boolean	Return less data. Leaves out content.html
offset	number	Offset the feed by this many items
limit	number	How many items to return. Maximum is 500.
not-tag	String	Include items except those matching tag
ext-properties	boolean	ext-properties=true shows total amount of releases in feed

200 JSON Feed example

{
  "version": "https://www.mfn.se/feed/version/1",
  "home_page_url": "https://feed.mfn.se/v1/feed/2c07a2db-2f22-4a67-ab46-ccb464296638",
  "feed_url": "https://feed.mfn.se/v1/feed/2c07a2db-2f22-4a67-ab46-ccb464296638",
  "next_url": "https://feed.mfn.se/v1/feed/2c07a2db-2f22-4a67-ab46-ccb464296638?limit=48&offset=48",
  "items": [
    {
      "news_id": "0c929408-c553-4a3b-b529-15e17f9db2e0",
      "group_id": "673ec417-cae7-41e8-a19f-d02b5c79d1fd",
      "url": "https://feed.mfn.se/v1/item/0c929408-c553-4a3b-b529-15e17f9db2e0.html",
      "author": {
        "entity_id": "2c07a2db-2f22-4a67-ab46-ccb464296638",
        "slug": "modfin",
        "slugs": [
          "modfin",
          "modular-finance-ab"
        ],
        "name": "Modular Finance AB",
        "brand_image_url": "https://storage.mfn.se/c51c5561-0f94-49f0-a6de-f1e65b427898"
      },
      "subjects": [
        {
          "entity_id": "2c07a2db-2f22-4a67-ab46-ccb464296638",
          "slug": "modfin",
          "slugs": [
            "modfin",
            "modular-finance-ab"
          ],
          "name": "Modular Finance AB",
          "brand_image_url": "https://storage.mfn.se/c51c5561-0f94-49f0-a6de-f1e65b427898"
        }
      ],
      "properties": {
        "lang": "en",
        "tags": [
          ":regulatory",
          ":regulatory:mar",
          "sub:report",
          "sub:report:interim",
          "sub:report:interim:q1",
          "cus:mfn"
        ],
        "type": "ir",
        "scopes": [
          "SE"
        ]
      },
      "content": {
        "title": "Interim Report Jan-Mar Q1 2021",
        "slug": "interim-report-jan-mar-q1-2021",
        "publish_date": "2021-04-26T09:06:00Z",
        "html": "<div class=\"mfn-preamble\"><p><strong>After a strong quarter, ... ",
        "attachments": [
          {
            "file_title": "Interim Report Q1",
            "content_type": "application/pdf",
            "url": "https://storage.mfn.se/8cc49f8c-6a72-45ef-9ec6-7e81ebd90001/interim-report-q1.pdf",
            "tags": [
              ":generated",
              ":primary"
            ]
          }
        ]
      },
      "extensions": {},
      "source": "mfn"
    }
  ]
}