This API Description may be a little bit unclear

ivanskodje wrote 8 years ago: 1

The description inside: http://www.tvmaze.com/api#season-episodes
--------
A list of episodes in this season. Specials are always included in this list; they can be recognized by a NULL value for number.

URL:/seasons/:id/episodes

Example: http://api.tvmaze.com/seasons/1/episodes
--------

The API would benefit from specifying further which ID it expects. (In this case, it was the season ID)

The only reason I bring this up, is because this specific example made me run a few laps before figuring which ID it wanted. Now, after learning which ID it uses - it is obvious. Of course, it was not obvious until I realized that - a process that could be hastened by adding :id-season/episodes, or equivalent descriptions to the parameters.

gazza911 wrote 8 years ago: 1

If it's :id then it's whatever precedes it, so:

URL: /people/:id/castcredits

Example: http://api.tvmaze.com/people/1/castcredits

Would be the cast credits for the person with ID 1.

tnt wrote 8 years ago: 1

For example, by using /singlesearch/shows?q=:query you'll get the show ID. This ID you could use in /shows/:id/seasons to get the ID for each season of the show. And those IDs can be used in /seasons/:id/episodes to get the list of the episodes.