Trending: Referência da API de Histórias da Web

Retorna uma lista de Web Stories que estão em alta nas últimas 48 horas e que correspondem aos parâmetros de pesquisa especificados em uma solicitação de API.

Métodos

trending

Retorna uma lista de Web Stories.

Solicitação de API

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

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": "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?"
    }
  ]
}