Most Popular: Web Stories API Reference

Returns a list of Web Stories that are all-time most popular and that matches the search parameters specified in an API request.

Methods

mostpopular

Returns a list of Web Stories.

API Request

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

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": "9 DIY Kitchen Cabinet Ideas",
      "url": "9-diy-kitchen-cabinet-ideas",
      "language": "en",
      "category": {
        "displayname": "Lifestyle",
        "displayname_encoded": "lifestyle"
      },
      "description": "DIY kitchen cabinet ideas range from adding storage and fixtures to painting and refinishing. See what homeowners have done to spruce up their cabinets."
    },
    {
      "title": "Ready to get some Interior Design Ideas?",
      "url": "ready-to-get-some-interior-design-ideas",
      "language": "en",
      "category": {
        "displayname": "Lifestyle",
        "displayname_encoded": "lifestyle"
      },
      "description": "Finnish Design Shop is one of the world\u2019s largest online store specialized in Scandinavian design. They have a large selection of Scandinavian \u0026 contemporary design. Official dealer for over 150 popular design brandsincluding Artek, Vitra, Muuto, Hay, Iittala, Normann Copenha"
    },
    {
      "title": "Ronnie Spector: a life in pictures",
      "url": "ronnie-spector-a-life-in-pictures",
      "language": "en",
      "category": {
        "displayname": "Entertainment",
        "displayname_encoded": "entertainment"
      },
      "description": "The singer who defined the sound of mid-century girl groups as the frontwoman of the Ronettes has died at age 78"
    },
    {
      "title": "Bags New In February 2022",
      "url": "bags-new-in-february-2022-net-a-porter",
      "language": "en",
      "category": {
        "displayname": "Fashion for Her",
        "displayname_encoded": "fashion-for-her"
      },
      "description": "Explore the new-in collection of women\u0027s designer bags. "
    }
  ]
}