Most Popular: Referencia de la API de historias web (Web Stories)
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. " } ] }