Abstract user icon
nl
Makers

StoryCategories: Web Stories API-referentie

A Storycategory resource contains information on a particular category, including the display name and the encoded version.

Methods

listReturns a list of categories that can be associated with Web Stories.

API Request

GET https://webstories.today/api/v1/categories/list

Parameters

apikeystring, required
languagestring, required, default: en
The language parameter specifies in which language the category list should be returned.


Request body

Do not provide a request body when calling this method.

Response

The following table defines the properties that appear in this resource:

displaynamestring
The display name of the category
displayname_encodedstring
Used in the search queries to represent the story category


If successful, this method returns a response body with the following structure:
[
  {
    "displayname": "Animals \u0026 Pets",
    "displayname_encoded": "pets"
  },
  {
    "displayname": "Art",
    "displayname_encoded": "art"
  },
  {
    "displayname": "Auto \u0026 Moto",
    "displayname_encoded": "auto-moto"
  },
  {
    "displayname": "Beauty",
    "displayname_encoded": "beauty"
  },
  {
    "displayname": "Blog,Podcast,Vlog",
    "displayname_encoded": "blog-podcast-vlog"
  },
  {
    "displayname": "Books",
    "displayname_encoded": "books"
  },
  ...
  ]