# Morgunblaðið Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/mbl/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/mbl-search |

## Description

Search Morgunblaðið (mbl.is) Icelandic news articles in real time by keyword, section, and date range and receive title, author, publish date, section, and URL as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/mbl/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'kosningar 2026' in innlent

```json
{
  "meta": {
    "page": 1,
    "query": "kosningar 2026",
    "total_pages": 74,
    "total_results": 1842,
    "results_per_page": 25
  },
  "results": [
    {
      "id": "2026/05/17/sjalfstaedisflokkurinn_med_storsigur_i_reykjavik",
      "url": "https://www.mbl.is/frettir/innlent/2026/05/17/sjalfstaedisflokkurinn_med_storsigur_i_reykjavik/",
      "title": "Sjálfstæðisflokkurinn með stórsigur í Reykjavík",
      "author": "Jón Pétur Jónsson",
      "section": "innlent",
      "snippet": "Sjálfstæðisflokkurinn fagnar stórsigri í sveitarstjórnarkosningum 2026 í Reykjavík með níunda mann í borgarstjórn samkvæmt lokatölum.",
      "subtitle": "Hildur Björnsdóttir leiðir flokkinn til kosningasigurs",
      "image_url": "https://www.mbl.is/img/cache/1280x720/static/cache/image/hildur_kosningar_2026.jpg",
      "is_premium": false,
      "updated_at": "2026-05-17T03:15:00+00:00",
      "published_at": "2026-05-17T01:42:00+00:00",
      "section_label": "Innlent"
    },
    {
      "id": "2026/05/16/hveitibraudsdagar_rikisstjornarinnar_endanlega_bunir",
      "url": "https://www.mbl.is/frettir/innlent/2026/05/16/hveitibraudsdagar_rikisstjornarinnar_endanlega_bunir/",
      "title": "Hveitibrauðsdagar ríkisstjórnarinnar endanlega búnir",
      "author": "Þorsteinn Ásgrímsson Mélen",
      "section": "innlent",
      "snippet": "Greinendur segja að ríkisstjórnin standi frammi fyrir mikilli áskorun eftir kosningar 2026 og að stuðningurinn fari minnkandi.",
      "subtitle": "Greining stjórnmálafræðings á niðurstöðu kosninga",
      "image_url": "https://www.mbl.is/img/cache/1280x720/static/cache/image/rikisstjorn_2026.jpg",
      "is_premium": false,
      "updated_at": "2026-05-17T00:12:00+00:00",
      "published_at": "2026-05-16T22:08:00+00:00",
      "section_label": "Innlent"
    },
    {
      "id": "2026/05/16/lokatolur_i_kopavogi_asdis_med_hreinan_meirihluta",
      "url": "https://www.mbl.is/frettir/innlent/2026/05/16/lokatolur_i_kopavogi_asdis_med_hreinan_meirihluta/",
      "title": "Lokatölur í Kópavogi: Ásdís með hreinan meirihluta",
      "author": "Skúli Halldórsson",
      "section": "innlent",
      "snippet": "Lokatölur úr Kópavogi sýna að Sjálfstæðisflokkurinn nær hreinum meirihluta í kosningum 2026 með Ásdísi Kristjánsdóttur í forystu.",
      "subtitle": "Sjálfstæðisflokkurinn bætir við sig fulltrúa",
      "image_url": "https://www.mbl.is/img/cache/1280x720/static/cache/image/asdis_kopavogur.jpg",
      "is_premium": true,
      "updated_at": "2026-05-17T01:04:00+00:00",
      "published_at": "2026-05-16T23:51:00+00:00",
      "section_label": "Innlent"
    }
  ],
  "search_parameters": {
    "page": 1,
    "sort": "newest",
    "query": "kosningar 2026",
    "section": "innlent",
    "to_date": "2026-05-17",
    "from_date": "2026-05-01"
  }
}
```

## Documentation

## Overview

Morgunblaðið is Iceland's flagship daily newspaper, with mbl.is as its primary digital outlet publishing around 200 articles per day across nine sections. mbl.is uses Cloudflare. Piloterr handles the bypass and returns paginated search results with article URLs, titles, snippets, section, byline, publish and update timestamps, lead image, and a premium paywall flag as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/mbl/search?query=kosningar%202026&section=innlent
```

## Main use cases

- Power an Iceland-focused media monitoring dashboard that surfaces every mbl.is article mentioning a brand or executive within minutes of publication
- Feed a financial news pipeline with mbl.is Viðskipti articles to track Icelandic market sentiment and ISK currency coverage in real time
- Aggregate Icelandic sports coverage from mbl.is Íþróttir alongside other Nordic outlets for a unified sports analytics layer
- Run a daily political coverage briefing that surfaces every mbl.is article tagged with election keywords and feeds them to a Slack or email digest
- Build a long-term Icelandic news archive indexed by section, date range, and author for academic research on Nordic media