API V2.x Discussion

[codegrabber]

Another thing which I just encountered:

The model for Series says that seriesId is an integer, but the query yields a string:

Code: Select all

"data": {
    "id": 343949,
    // ...
    "seriesId": "343949",
    // ...
}

This is rather annoying unfortunately...

[Nozavi]

Is there a reason why /series/{id}/episodes/summary is not integrated into /series/{id}/episodes ?

[MattS]

Greetings,

I've tried to use swagger.json for new API to autogenerate some client code and realized that swagger definition is incorrect.
Specifically, /search/series returns an object with "data" field that is an array of Series object, and not a single object as swagger.json says.

What I can do to fix the definition?

Thanks

Greetings,

I've tried to use swagger.json for new API to autogenerate some client code and realized that swagger definition is incorrect.
Specifically, /search/series returns an object with "data" field that is an array of Series object, and not a single object as swagger.json says.

What I can do to fix the definition?

Thanks

It's also out of date when querying for episodes:

The newest poll returns additional language info:

"language": {
"episodeName": "en",
"overview": ""
},

Which is nowhere mentioned...

Another thing which I just encountered:

The model for Series says that seriesId is an integer, but the query yields a string:

Code: Select all

"data": {
    "id": 343949,
    // ...
    "seriesId": "343949",
    // ...
}

This is rather annoying unfortunately...

These fixes should be up on dev now (https://api-dev.thetvdb.com/swagger). I'll look at getting it pushed live shortly, have some other things I'd like to finish before deploying to prod.

For future issues, it's best to create a GitLab account (if you haven't already) and submit issues there (https://gitlab.thetvdb.com/site/thetvdb_api/issues). It's difficult to keep up with here and Trello isn't much better.

[dremy]

Apologies if this is a little off topic, but is there a way to find the newest poster of a series using the API? The api doesn't appear to return the upload date for artwork, and I had been going by the poster file name, which usually had an integer at the end of it to denote it was added after lower integer files. But it appears with the site remodel that poster names are now completely random. I'd like my app to always display the newest poster if at all possible. Has anyone else found a solution for this?

[codegrabber]

Greetings,

I've tried to use swagger.json for new API to autogenerate some client code and realized that swagger definition is incorrect.
Specifically, /search/series returns an object with "data" field that is an array of Series object, and not a single object as swagger.json says.

What I can do to fix the definition?

Thanks

Greetings,

I've tried to use swagger.json for new API to autogenerate some client code and realized that swagger definition is incorrect.
Specifically, /search/series returns an object with "data" field that is an array of Series object, and not a single object as swagger.json says.

What I can do to fix the definition?

Thanks

It's also out of date when querying for episodes:

The newest poll returns additional language info:

"language": {
"episodeName": "en",
"overview": ""
},

Which is nowhere mentioned...

Another thing which I just encountered:

The model for Series says that seriesId is an integer, but the query yields a string:

Code: Select all

"data": {
    "id": 343949,
    // ...
    "seriesId": "343949",
    // ...
}

This is rather annoying unfortunately...

These fixes should be up on dev now (https://api-dev.thetvdb.com/swagger). I'll look at getting it pushed live shortly, have some other things I'd like to finish before deploying to prod.

For future issues, it's best to create a GitLab account (if you haven't already) and submit issues there (https://gitlab.thetvdb.com/site/thetvdb_api/issues). It's difficult to keep up with here and Trello isn't much better.

Good to know I can submit issues over there. If I can make it easier for you guys to keep track of them, I'll most certainly do.

[brandbrilliance]

Can't login to my account. Also, forgot password isn't sending out any e-mails. So now Im unable to retrieve my userkey for the new API.

[Hansaplastique]

I'm new to this forum, and have been searching through all the posts and carefully studying the v2 API, and could not find an answer.

I'm wondering if a "lastupdated" field could be added to search results when searching for a show (for example: https://api.thetvdb.com/search/series?name=lost). This way I know if I can rely on my local data, or if I need to refresh my local data, for the show details.

Case:

Here is the usual workflow;
1) a user enters a name of a TV show he/she is looking for. For example "lost" (https://api.thetvdb.com/search/series?name=lost)
2) a long list is returned from which the user can select the best match.
3) The user can now select a show in the list to see the details of the show (for each show for example https://api.thetvdb.com/series/73739)
4) When the user found the correct show, he/she can then retrieve all episodes of the selected show.

Now, previous each data retrieval will be stored in a local SQLite database, so the application doesn't need to pull all the info from TheTVDB.
The only problem I'm running into is that the search (step 1) doesn't provide a "lastupdated" field.
Therefor I will not know if I can rely on my local data in step 3 or not, so effectively I have to download the show details each and every time, for every selected show, even if the data has not changed - which seems like a waste of resources.

I can imagine a proper "lastupdated" field in the result results could save a nice number of queries per day, and it most certainly will speed up my application.

(obviously, for the episodes I'm already relying on "lastupdated" in the show details query (https://api.thetvdb.com/series/73739)

My apologies if this has been addressed elsewhere - I couldn't find it in this forum.

[roign]

Also just discovered that filtering a Series properties with LastUpdated, and any other properties, LastUpdated doesn't appear in results.

I've noticed the same issue with the /series/{id}/filter endpoint.
A request to "api.thetvdb.com/series/275274/filter?keys=lastUpdated,seriesId,seriesName" returns:

Code: Select all

{
  "data": {
    "seriesId": "275274",
    "seriesName": "Rick and Morty"
  },
  "errors": {}
}

No matter the key combination, lastUpdated is never returned.

Is this going to be fixed? In V3 maybe?

[jowi]

Using v2.2.2 api; GET series by id, omitting the Accept-Language (so leaving it empty) returns a spanish response automatically (i'm in Netherlands). If i enter 'en' for english, it also returns Spanish... surely English must be supported? German works, Spanish, French, but not English? Why? Btw, series id used was 275274 (Rick and Morty).

Code: Select all

curl -X GET --header 'Accept: application/json' --header 'Accept-Language: en' --header 'Authorization: Bearer eyJhbGciOiJS[...]BDUhSBQpehg' 'https://api.thetvdb.com/series/275274'

Code: Select all

{
  "data": {
    "id": 275274,
    "seriesName": "Rick and Morty",
    "aliases": [],
    "banner": "graphical/275274-g6.jpg",
    "seriesId": "275274",
    "status": "Continuing",
    "firstAired": "2013-12-02",
    "network": "Adult Swim",
    "networkId": "",
    "runtime": "25",
    "genre": [
      "Adventure",
      "Animation",
      "Comedy",
      "Science-Fiction"
    ],
    "overview": "Rick & Morty relata las aventuras de un científico loco, mal encarado y alcohólico que vive en casa de su hija, Beth, junto a Jerry, el marido de ésta y los dos hijos de la pareja, Summer y Morty, compañero de su abuelo en sus andanzas.",
    "lastUpdated": 1573662855,
    "airsDayOfWeek": "Sunday",
    "airsTime": "11:30 PM",
    "rating": "TV-MA",
    "imdbId": "tt2861424",
    "zap2itId": "EP01833673",
    "added": "2013-11-13 09:41:13",
    "addedBy": 346515,
    "siteRating": 9.3,
    "siteRatingCount": 127,
    "slug": "rick-and-morty"
  }
}

[devonuto]

I'm currently getting (401) Unauthorized errors polling the API. Is this happening for anyone else, or is it an issue with my API key?

Also getting 404 errors on API Page on the site:
No webpage was found for the web address: https://api.thetvdb.com/swagger