Latest: Web Stories API Reference

Returns a list of the latest Web Stories that match the search parameters specified in an API request.

Methods

latest

Returns a list of Web Stories.

API Request

GET https://webstories.today/api/v1/latest

Parameters

apikey	string, required
category	string, optional Use the displayname_encoded from the StoryCategory Resource.
language	string, required, default: en The language parameter specifies in which language the category list should be returned.
maxresults	string, optional default: 10, max 50

Request body

Do not provide a request body when calling this method.

Response

The following table defines the properties that appear in this resource:

title	string Title of the web story
description	string The description of the web stories, max 280 chars long
language	string The language of the story, 2 letter language code.
url	string The full URL of the web story
channelinfo	ChannelInfo Information on the channel/creator who owns the web story.
category	StoryCategory Information on the category, the web story belongs too.

If successful, this method returns a response body with the following structure:

{
  "searchquery": "",
  "searchcategory": "",
  "pagination": 1,
  "webstories": [
    {
      "title": "Celebrities",
      "url": "ny-times-best-sellers-celebrities",
      "language": "en",
      "category": {
        "displayname": "Books",
        "displayname_encoded": "books"
      },
      "description": "The New York Times Best Sellers\u003Cbr /\u003E\u003Csmall\u003ELatest update: zondag 15 januari 2017\u003C/small\u003E"
    },
    {
      "title": "Business",
      "url": "ny-times-best-sellers-business-books",
      "language": "en",
      "category": {
        "displayname": "Books",
        "displayname_encoded": "books"
      },
      "description": "The New York Times Best Sellers\u003Cbr /\u003E\u003Csmall\u003ELatest update: zondag 14 augustus 2022\u003C/small\u003E"
    },
    {
      "title": "Audio Nonfiction",
      "url": "ny-times-best-sellers-audio-nonfiction",
      "language": "en",
      "category": {
        "displayname": "Books",
      },
      "description": "The New York Times Best Sellers\u003Cbr /\u003E\u003Csmall\u003ELatest update: zondag 14 augustus 2022\u003C/small\u003E"
    }
  ]
}