StoryCategories: Web Stories API Reference

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

Methods

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

API Request

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

Parameters

apikey	string, required
language	string, 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:

displayname	string The display name of the category
displayname_encoded	string 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"
  },
  ...
  ]