Schedule API documentation/New Filter?

jaydeflix wrote 9 years ago: 1

I noticed in the API updates that there's a filter available for the schedule call, but I didn't see it in the actual documentation yet, so, rolling two requests into one:

Can the http://www.tvmaze.com/api page get updated?

Can we get a filter to only return new episodes? I know I can filter it on the client end, but, if the api is being developed, I figured I'd ask.


gazza911 wrote 9 years ago: 1

Not sure what you mean, it already has the following on that page:

• URL: /schedule?country=:countrycode&date=:date

• (optional) countrycode: an ISO 3166-1 code of the country; defaults to US

• (optional) date: an ISO 8601 formatted date; defaults to the current day


david wrote 9 years ago: 1

He means a call like: http://api.tvmaze.com/schedule?filter=primetime

The filter option currently isn't documented on purpose - because we're not too sure about the implementation yet, so I can't guarantee it'll keep behaving the same way in the future. Once it's stable I'll add it to the documentation!

What do you mean with "only new episodes" exactly?

jaydeflix wrote 9 years ago: 1

david wrote:
He means a call like: http://api.tvmaze.com/schedule?filter=primetime
The filter option currently isn't documented on purpose - because we're not too sure about the implementation yet, so I can't guarantee it'll keep behaving the same way in the future. Once it's stable I'll add it to the documentation!
What do you mean with "only new episodes" exactly?

Okay. I hoped that since it was listed as new a year ago it might be stable by now.

Only new episodes as in http://epguides.com/new/ uses the api for data and only displays new episodes. I'd love to have it done server side rather than client side, just to reduce data. So, something like http://api.tvmaze.com/schedule?filter=primetime&episode=new.

Or am I missing something in the API description where it only returns new episodes (which is kind of what it looks like considering the missing holes in the schedule in this off season....


gazza911 wrote 9 years ago: 1

If you omit the date when calling the schedule, it reverts to the current day... however I think that TVMaze's server is set to the wrong date; at 9th July 04:10 GMT - the time that I'm looking at it, it's showing the schedule for the 7th July.

For all future episodes you use http://api.tvmaze.com/schedule/full - this gets cached for 24 hours so you'd expect there to be upto a day offset from the current date, but this is currently showing episodes since the 6th July

jaydeflix wrote 9 years ago: 1

gazza911 wrote:
If you omit the date when calling the schedule, it reverts to the current day... however I think that TVMaze's server is set to the wrong date; at 9th July 04:10 GMT - the time that I'm looking at it, it's showing the schedule for the 7th July.
For all future episodes you use http://api.tvmaze.com/schedule/full - this gets cached for 24 hours so you'd expect there to be upto a day offset from the current date, but this is currently showing episodes since the 6th July

Not exactly what I'm looking for, but thanks.


david wrote 9 years ago: 1

jaydeflix wrote:
Or am I missing something in the API description where it only returns new episodes (which is kind of what it looks like considering the missing holes in the schedule in this off season....

We only provide premiere airdates ("new episodes"). Reruns are never shown.

jaydeflix wrote 9 years ago: 1

david wrote:
We only provide premiere airdates ("new episodes"). Reruns are never shown.

Aha! Always hard to be 100% sure on that. PERFECT.

Try 30 days of free premium.