Newspaper Archive API
Changes from SvD Paper Archive API
There are few changes in the API compared to SvD Paper Archive API:
- A lot of fields changed its names to keep consistent naming with the correct domain terms used in publishing (for example what we called "section" previously is called "product" now.)
- Returned URL for images are only valid for specified time span that is maximum 7 days.
- Instead of returning page numbers that spanned multiple products we return only page number within the single product (specified by productCode). The page number we return in current version always corresponds to the page number printed on the page, however for the old, scanned material it may happen that it differs - there are usually no divisions into separate products, and all the parts of the paper are indexed under the main newspaper.Previously if for example one newspaper sold on one day consisted of multiple products - like "News", "Business", "Culture" we returned page numbers that spanned all those products sold together. Currently it will be exactly as it's printed on the page - so if "Business" is separate product and first page of "Business" product has got number "1" printed as page number - then "1" will be the page number what we will return (this rule applies to both fields page.page and page.maxPage).To sum up: current pageNumber is equivalent of old page.sectionPageNumber, there is no equivalent of page.page anymore as there are no "bundles" anymore and both productMaxPageNumber and effectiveEditionMaxPageNumber are different than old page.maxPage, cause they are calculated within single product (its all editions) or just one edition of a product, but not bundle of products.
- Unlike in SvD Paper Achieve there may be cases when we return multiple editions of the same page. It means that for given day, product and page number we may return two editions (which can be distinguished by having a different value in "edition" field). This case usually happens when there were different editions printed for different geographic areas or when there were multiple versions of the same page. It is still possible to make sure we that only one page is returned (similar to SvD Paper Archive) by passing parameter "edition=1" to the query.
- We will return topics such as NEWS, BUSINESS, etc., but they are only available for a small portion of the content and in the future versions of the API.