NOS Archief

Het toegankelijke archief van publieke nieuwsberichten.


Endpoint

Op dit moment is er maar een endpoint: www.media.insight-democracy.com/api/v1.

Deze endpoint maakt het mogelijk door de database te zoeken en met een paar argumenten de resultaten te filteren.


Argumenten

De volgende URL een acceptable API oproep, die van alle argumenten gebruik maakt: https://www.media.insight-democracy.com/api/v1?q=sinterklaas+zwarte+piet&title=False&categorie=binnenland&start=2023-01-01&end=2025-01-12&limit=10&page=2

De volgende argumenten zijn beschikbaar voor uw zoekinstellingen:

  • Zoekwoorden: p

    • Dit argument laat je de gezochte resultaten filteren door zoekwoorden toe te voegen, die gesplitst worden met +.

  • Alleen titels: title

    • Dit argument laat je de gezochte resultaten filteren door alleen titels to doorzoeken met True, alle andere metadata wordt genegeerd.

    De volgende waarden zijn toegestaan:
    True
    False
  • Categorieën: category

    • Dit argument laat je de gezochte resultaten filteren door een of meer categorieën toe te voegen, die gesplitst worden met +.

    De volgende waarden zijn toegestaan:
    alles
    algemeen
    binnenland
    politiek
    economie
    opmerkelijk
    koningshuis
    cultuur+en+media
    tech
    voetbal
    wielrennen
    schaatsen
    tennis
    formule+1
    nieuwsuur
    NOS+op+3
    NOS+jeugdjournaal
  • Begindatum: start

    • Dit argument laat je de gezochte resultaten filteren door het begindatum van resultaten vast te leggen in het volgende formaat: YYYY-MM-DD

  • Einddatum: end

    • Dit argument laat je de gezochte resultaten filteren door het einddatum van resultaten vast te leggen in het volgende formaat: YYYY-MM-DD

  • Limiet: limit

    • Dit argument laat je de gezochte resultaten pagineren door het maximum limiet van zoekresultaten per antwoord vast te leggen.

  • Pagina: page

    • Dit argument laat je de gezochte resultaten pagineren door de pagina van de zoekresultaten per antwoord vast te leggen.


    Rate limit

    De rate limit van de API is verhoogd naar 5000 per dag, 1000 per uur en 100 per minuut. Mocht dat niet genoeg zijn, kun je altijd de data direct vragen, of een aangepaste rate limit aanvragen: insight.democracy@gmail.com.


    Structuur

    Het antwoord van de API wordt gestuurd met de volgende structuur:

    {"result_amount":68,
    "result_pagination":{
      "limit":10,
      "max_page":7,
      "page":2},
    "result_query":{
      "categories":["binnenland"],
      "end_date":"2025-01-12",
      "search":"sinterklaas zwarte piet",
      "start_date":"2023-01-01",
      "title_only":"False"},
    "results":[
      ["'Amerikaanse Nobelprijs' voor kankeronderzoeker Piet Borst",["binnenland"],"2023-09-21T19:37:23+02:00"],
      ["Justitie verdedigt inzet kroongetuige in nieuwe liquidatiezaak",["algemeen","binnenland"],"2024-08-29T15:26:16+02:00"],
      ["Merel Westrik vervangt Dieuwertje Blok bij Sinterklaasjournaal",["algemeen","binnenland","cultuur en media"],"2024-08-12T12:25:46+02:00"],
      ["Drugsbaron Piet S. moet 19 miljoen betalen aan OM, 81 miljoen minder dan ge\u00ebist",["algemeen","binnenland"],"2024-12-17T18:19:37+01:00"],
      ["Caravans in brand op festivalcamping van Zwarte Cross",["algemeen","binnenland"],"2024-07-20T07:19:29+02:00"],
      ["OM eist 16 jaar tegen Haagse 'drugsmakelaar' Piet S.",["binnenland"],"2023-05-26T18:41:11+02:00"],
      ["Naast Gerrit Hiemstra ook Piet Paulusma ge\u00eberd met stormnaam",["binnenland"],"2023-09-01T09:04:56+02:00"],
      ["Wekdienst 16/11: Intocht Sinterklaas \u2022 Nederland-Hongarije in Nations League",["algemeen","binnenland","buitenland"],"2024-11-16T07:22:01+01:00"],
      ["ON-presentator Raisa Blommestijn veroordeeld tot 80 uur taakstraf, meer dan de eis",["algemeen","binnenland"],"2024-12-05T13:31:33+01:00"],
      ["Verontruste ouders krijgen persoonlijke mail van Sinterklaasjournaal",["binnenland","cultuur en media"],"2024-11-27T10:54:14+01:00"]
     ]
    }