API

The public API at LezWatchTV is available for anyone anywhere to consume and reproduce the data found on this site. Improvements and additions are made regularly. If there is a specific type of data not listed here, please contact us and we’ll do our best to write it up.

The URL for the API is https://lezwatchtv.com/wp-json/ and we support the following endpoints:

Alexa Skills

Usage restricted to Amazon Alexa only.

Flash Briefing

Outputs ten most recent posts with excerpt. Simplified JSON output for Alexa Flash Briefing API.

  • Endpoint: /lwtv/v1/alexa-skills/briefing/

Used By: LezWatchTV Flash Briefing (Alexa Skill)

News

Allows you to ask for information generated by the site.

  • Endpoint: /wp-json/lwtv/v1/alexa-skills/news/
  • Supports the following asks:
    • “Ask LezWatchTV what happened in 2017?”
    • “Ask LezWatchTV who died on March 3rd”
    • “Ask LezWatchTV who is Ali Liebert?”
    • “Ask LezWatchTV who is the character of the day?”

Used By: LezWatchTV News (Alexa Skill)

Last Death

Outputs most recent death: Post ID, character name, URL, timestamp

  • Endpoint: /lwtv/v1/last-death/

Used By: LezWatchTV News (WordPress Plugin), LezWatchTV News (Alexa Skill)

… Of The Day

Every day at midnight a new character and show of the day are generated. Also actors with birthdays are calculated.

  • Endpoints:
    • /lwtv/v1/of-the-day/
    • /lwtv/v1/of-the-day/{character|show}/
    • /lwtv/v1/of-the-day/birthday/

Used By: LezWatchTV News (WordPress Plugin), Automated Tweet/Facebook/Tumblr posts of the day (via Zapier), LezWatchTV News (Alexa Skill)

On This Day

  • Endpoints:
    • /lwtv/v1/on-this-day/
    • /lwtv/v1/on-this-day/DD-MM/
  • Outputs death(s) for day: Post ID, character name, URL, year of death

Used By: LezWatch.TV News and Information (WordPress Plugin)LezWatch.TV News (Alexa Skill)

Stats

The statistics output can be used to download and generate your own spreadsheets etc.

Basic Statistics

Generates the number of shows, number of characters, number of tropes, number of cliches

  • Endpoint: /lwtv/v1/stats/

Show Statistics

Generates statistics based on shows.

  • Overview:
    • Endpoint: /lwtv/v1/stats/shows/
    • Output: total shows, number of stations, number of show formats, number of genres, number of nations, number of tropes
    • Endpoint: /lwtv/v1/stats/shows/complex/
    • Output: All shows by name with nested arrays – post id, number of characters, number of dead, thumb up (yes/no), trigger warnings, stars, and if we love it. (note: To see more pages, append ?page=2 to the URL)
  • Show Formats
    • Endpoint: /lwtv/v1/stats/formats/
    • Output: Count of shows by show format
  • Genres
    • Endpoint: /lwtv/v1/stats/genres/
    • Output: Count of shows by genre
  • Shows We Love
    • Endpoint: /lwtv/v1/stats/loved/
    • Output: Count of shows by loved value (yes, no)
  • Nations
    • Endpoint: /lwtv/v1/stats/nations/
    • Output: Count of shows by nation including number of characters, and number of dead characters
    • Endpoint: /lwtv/v1/stats/nations/complex/
    • Output: All nations with break downs of character representation (gender etc). (note: To see more pages, append ?page=2 to the URL)
  • Stations
    • Endpoint: /lwtv/v1/stats/stations/
    • Output: Count of shows by station including number of characters, and number of dead characters
    • Endpoint: /lwtv/v1/stats/stations/complex/
    • Output: All stations with break downs of character representation (gender etc). (note: To see more pages, append ?page=2 to the URL)
  • Stars
    • Endpoint: /lwtv/v1/stats/stars/
    • Output: Count of shows by star value
  • Trigger Levels
    • Endpoint: /lwtv/v1/stats/triggers/
    • Output: Count of shows by trigger level value
  • Tropes
    • Endpoint: /lwtv/v1/stats/tropes/
    • Output: Count of shows by trope
  • Worth It
    • Endpoint: /lwtv/v1/stats/worth-it/
    • Output: Count of shows by worth it value (yes, no, meh)

Character Statistics

Generates statistics based on characters.

  • Overview
    • Endpoint/lwtv/v1/stats/characters/
    • Output: total characters, number of dead characters, number of sexualities, number of genders, number of romantic orientations, number of cliches
    • Endpoint/lwtv/v1/stats/characters/complex/
    • Output: All characters by name with nested arrays – post ID, date of death (empty if none), number of actors, number of shows
  • Cliches
    • Endpoint: /lwtv/v1/stats/characters/cliches/
    • Output: number of characters in each cliche
  • Gender Identity
    • Endpoint: /lwtv/v1/stats/characters/gender/
    • Output: number of characters in each gender identity
  • Romantic Orientation
    • Endpoint: /lwtv/v1/stats/characters/romantic/
    • Output: number of characters in each romantic orientation
  • Sexual Orientation
    • Endpoint: /lwtv/v1/stats/characters/sexuality/
    • Output: number of characters in each sexuality

Actor Statistics

Generates statistics based on actors.

  • Overview
    • Endpoint/lwtv/v1/stats/actors/
    • Output: total characters, number of genders, number of sexualities
    • Endpoint/lwtv/v1/stats/actors/shows/complex/
    • Output: All characters by name with nested arrays – post ID, number of characters, number of dead characters
  • Gender Identity
    • Endpoint: /lwtv/v1/stats/actors/gender/
    • Output: number of actors in each gender identity
  • Sexual Orientation
    • Endpoint: /lwtv/v1/stats/actors/sexuality/
    • Output: number of actors in each sexuality

Death

Generates statistics on death, dead characters, and shows with dead characters.

  • Overview
    • Endpoint: /lwtv/v1/stats/death/
    • Output: characters – number dead, number alive ; shows – number with death, number without
  • Years
    • Endpoint: /lwtv/v1/stats/years/
    • Output: All years from 1961 to today – year, number of dead, URL to ‘this year’ page

Used By: LezWatch.TV News and Information (WordPress Plugin), LezWatch.TV News (Alexa Skill)

What Happened

Generates data based on what happened on a given date.

  • Endpoints:
    • /lwtv/v1/what-happened/
    • /lwtv/v1/what-happened/YYYY-MM-DD
    • /lwtv/v1/what-happened/YYYY-MM
    • /lwtv/v1/what-happened/YYYY
  • Output: Overview of data from the time period, including deaths, posts made, characters added, etc.

Used By: LezWatch.TV News and Information (WordPress Plugin), LezWatch.TV News (Alexa Skill)