Most Popular: Referência da API de Histórias da Web

Retorna uma lista das Web Stories mais populares de todos os tempos e que correspondem aos parâmetros de pesquisa especificados em uma solicitação de API.

Métodos

mostpopular

Retorna uma lista de Web Stories.

Solicitação de API

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

Parâmetros

apikey	string, requeridos
category	string, opcional Use o displayname_encoded do recurso StoryCategory.
language	string, requeridos, predefinição: en O parâmetro language especifica em qual idioma a lista de categorias deve ser retornada.
maxresults	string, opcional predefinição: 10, max 50

Corpo de solicitação

Não forneça um corpo de solicitação ao chamar este método.

Resposta

A tabela a seguir define as propriedades que aparecem no resultado da busca:

title	string Título da webstory
description	string A descrição das webstories, com no máximo 280 caracteres
language	string A linguagem da história, código de linguagem de 2 letras.
url	string O URL completo da história da web
channelinfo	ChannelInfo Informações sobre o canal/criador que possui a história na web.
category	StoryCategory Informações sobre a categoria à qual a história da web pertence.

Se for bem-sucedido, este método retorna um corpo de resposta com a seguinte estrutura:

{
  "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. "
    }
  ]
}