Abstract user icon
nl
Makers

Trending: Web Stories API-referentie

Returns a list of Web Stories that are trending for the last 48h and that match the search parameters specified in an API request.

Methods

trendingReturns a list of Web Stories.

API Request

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

Parameters

apikeystring, required
categorystring, optional
Use the displayname_encoded from the StoryCategory Resource.
languagestring, required, default: en
The language parameter specifies in which language the category list should be returned.
maxresultsstring, 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:

titlestring
Title of the web story
descriptionstring
The description of the web stories, max 280 chars long
languagestring
The language of the story, 2 letter language code.
urlstring
The full URL of the web story
channelinfoChannelInfo
Information on the channel/creator who owns the web story.
categoryStoryCategory
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": "10 Greatest American Muscle Cars al All Times",
      "url": "10-greatest-american-muscle-cars-al-all-times",
      "language": "en",
      "category": {
        "displayname": "",
        "displayname_encoded": ""
      },
      "description": "American muscle cars are still some of the most popular cars on the market. We chronicled the greatest muscle cars ever made here"
    },
    {
      "title": "80s Fashion for Men",
      "url": "80s-fashion-for-men",
      "language": "en",
      "category": {
        "displayname": "",
        "displayname_encoded": ""
      },
      "description": "How to get the 1980\u0027s style"
    },
    {
      "title": "Spring 2022 Nail Trends",
      "url": "spring-2022-nail-trends",
      "language": "en",
      "category": {
        "displayname": "",
        "displayname_encoded": ""
      },
      "description": "The Looks and Products You\u0027ll Wanna Wear Now"
    },
    {
      "title": "5 Books To Read This Summer By Bill Gates",
      "url": "5-Books-To-Read-This-Summer-By-Bill-Gates",
      "language": "en",
      "category": {
        "displayname": "",
        "displayname_encoded": ""
      },
      "description": "What books does Bill Gates recommend for his summer?"
    }
  ]
}