API Questions...

MKKay wrote 4 years ago: 1

I have a few questions about API.

1. Do I need a membership to use the data by API in TV Maze together with Integromat (I have account)?

2. I want to get updated information on a list of 25 tv shows, with air dates. I live in Canada. I don’t know what endpoint to use. I also am hoping that I don’t have to keep changing the URL with country code and dates for each tv show, if that’s possible.

Any help would be appreciated.

Thank you,

Mary

gazza911 wrote 4 years ago: 1

1. We have two APIs;

The public one - https://www.tvmaze.com/api - you do not need a membership for (there's no authentication).

This is for information about shows/episodes/etc.

The premium one - http://static.tvmaze.com/apidoc/ - you would need an account and to purchase premium.

This is for interacting with your account, i.e. Marking episodes as watched.

2. It's important to note that we only (currently) track air dates for the premiere so the ones you're wanting to track would have to premiere in Canada (or online).

If you have the Ids for the Show's already you can use http://api.tvmaze.com/shows/1/episodes

MKKay wrote 4 years ago: 1

gazza911 wrote:
1. We have two APIs;
The public one - https://www.tvmaze.com/api - you do not need a membership for (there's no authentication).
This is for information about shows/episodes/etc.
The premium one - http://static.tvmaze.com/apidoc/ - you would need an account and to purchase premium.
This is for interacting with your account, i.e. Marking episodes as watched.
.
2. It's important to note that we only (currently) track air dates for the premiere so the ones you're wanting to track would have to premiere in Canada (or online).
If you have the Ids for the Show's already you can use http://api.tvmaze.com/shows/1/episodes

Hi gazza911

Thank you for your reply.

i have copied the link for one of the tv shows and I believe the show id is in it. Is it 593? If so, where would I place the id#?

https://www.tvmaze.com/shows/593/murdoch-mysteries

This is the link I would like to use for the tv information in Integromat.

http://api.tvmaze.com/shows/1/episodes

Besides copying the link and getting the id# that way, is there another place on the webpage that I can find the tv id number?

Once I have the number how does it work on Integromat? I realize that you might not know, but I thought I would ask.

Thank you,

Mary

MKKay wrote 4 years ago: 1

MKKay wrote:
Hi gazza911
Thank you for your reply.
i have copied the link for one of the tv shows and I believe the show id is in it. Is it 593? If so, where would I place the id#?
https://www.tvmaze.com/shows/593/murdoch-mysteries
This is the link I would like to use for the tv information in Integromat.
http://api.tvmaze.com/shows/1/episodes
Besides copying the link and getting the id# that way, is there another place on the website that I can find the tv id number?
Once I have the number how does it work with Integromat? I realize that you might not know, but I thought I would ask.
Thank you,
Mary

gazza911 wrote 4 years ago: 1

Sorry, I hadn't seen your reply.

Yes, it would be 593 for that show.

The episodes endpoint is in the format https://api.tvmaze.com/shows/:id/episodes

So for that it would be https://api.tvmaze.com/shows/593/episodes.

If you don't know the TVmaze ID, but know the name then you should use the search endpoint(s).

https://api.tvmaze.com/search/shows?q=murdoch+mysteries (or to return just one result that is less forgiving of typos - https://api.tvmaze.com/singlesearch/shows?q=murdoch+mysteries)

Unfortunately I've never used Integromat so I can't comment exactly on it but it looks like you'd want something like this example (with a HTTP request at the start instead).

MKKay wrote 4 years ago: 1

Hi gazza911

Thank you for your help with this matter.

I managed to get a scenario created, with some help, and it’s working.

I am noticing that the TV information has the TV Show ID, which is what I wanted, but I would also like to have the name of the show (about 25 different shows), the season, episode and the current airdate, for the most current episodes, too. How can I do this?

There was one show that did not have the information retrieved, KIM’s CONVENIENCE. I don’t know why that information didn’t show up.

Right now I am using these endpoints:

http://api.tvmaze.com/search/shows?q=:query

https://api.tvmaze.com/shows/:id/episodes

Any help would be appreciate.

Thank you,

Mary Kay

gazza911 wrote 4 years ago: 1

If by 'current' you mean the previous & next episode, then I'd suggest checking the previousepisode & nextepisode properties in the _links property of the search request.

That will tell you if we do have an episode listed for the future.

In terms of that specific show, I'm not sure where your problem is as it has the data you mentioned:

https://api.tvmaze.com/shows/17312/episodes

https://api.tvmaze.com/episodes/1760250

MKKay wrote 4 years ago: 1

Hi gazza911

Thank you for your help. I appreciate it.

Mary