# New TV Series Agent Rest API

**URL:** <https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073>\
**Category:** Metadata & Adding Files\
**Created:** [February 18, 2022, 5:25pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073 "2022-02-18T17:25:54Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![Madilind](https://avatars.discourse-cdn.com/v4/letter/m/dec6dc/32.png) [@Madilind](https://forums.plex.tv/u/Madilind)\
**Post date:** [February 18, 2022, 5:25pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/1 "2022-02-18T17:25:54Z")

</div>

Is the new TV Series Agent API documented anywhere like the TVDB? Would really like to update my missing episodes script.

---

<div class="post-metadata">

**Author:** ![BigWheel](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/bigwheel/32/78783_2.png) [@BigWheel](https://forums.plex.tv/u/BigWheel)\
**Post date:** [February 18, 2022, 6:15pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/2 "2022-02-18T18:15:34Z")

</div>

it is not as far as I know. every episode should have the TMDB, IMDB, TMDB guids in xml if that is what you are looking for.

![https___192-168-86-79_8547a6a276424bb087f4ac766071c616_plex_direct_32400_library_metadata_34011_checkFiles_1_includeAllConcerts_1_includeBandwidths_1_includeChapters_1_includeChildren_1_includeConcerts_1_includeExtras_1_includeFields_1_incl](https://global.discourse-cdn.com/plex/original/4X/7/a/7/7a7507058c52ff7bce13410e6450906e99488801.png)

---

<div class="post-metadata">

**Author:** ![dbirch](https://avatars.discourse-cdn.com/v4/letter/d/f19dbf/32.png) [@dbirch](https://forums.plex.tv/u/dbirch)\
**Post date:** [February 18, 2022, 6:57pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/3 "2022-02-18T18:57:57Z")

</div>

Why not use the TVDB?

---

<div class="post-metadata">

**Author:** ![Madilind](https://avatars.discourse-cdn.com/v4/letter/m/dec6dc/32.png) [@Madilind](https://forums.plex.tv/u/Madilind)\
**Post date:** [February 18, 2022, 7:40pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/4 "2022-02-18T19:40:50Z")

</div>

Not sure what you are showing me. When you make a call to get tv shows before the update they would come back like this GUID {com.plexapp.agents.thetvdb://92411?lang=en}. You can get the 92411 to search the TVDB for all episodes to see if you are missing any. The new shows come back like this {plex://show/60844302404320002c149cc9}. So if they don’t still maintain the TVDB key with the TV Show I need to know how to call the new Plex TV Series agent to check all the episodes. It was a cool tool but won’t work for any of the new shows.

---

<div class="post-metadata">

**Author:** ![Madilind](https://avatars.discourse-cdn.com/v4/letter/m/dec6dc/32.png) [@Madilind](https://forums.plex.tv/u/Madilind)\
**Post date:** [February 18, 2022, 7:42pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/5 "2022-02-18T19:42:37Z")

</div>

Well the new version defaults to the Plex TV Show agent. I have a script that checks all of the series/episodes I have and then compares that to the ones listed in TVDB to see what I am missing. The new shows don’t return the TVDB key so I either need to find a way to get it or to poll the Plex TV Show Agent API for the series info instead.

---

<div class="post-metadata">

**Author:** ![BigWheel](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/bigwheel/32/78783_2.png) [@BigWheel](https://forums.plex.tv/u/BigWheel)\
**Post date:** [February 18, 2022, 7:44pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/6 "2022-02-18T19:44:05Z")

</div>

> [@Madilind](#):
>
> Not sure what you are showing me.

that is the XML for an episode of TV show that was matched the new agent. We included the other GUIDs from those three sources in the xml for [folks with third party tools that wanted them](https://forums.plex.tv/t/implemented-native-plex-agents-allow-access-to-external-provider-ids-for-media-eg-imdb-tmdb-tvdb/619090)

---

<div class="post-metadata">

**Author:** ![Madilind](https://avatars.discourse-cdn.com/v4/letter/m/dec6dc/32.png) [@Madilind](https://forums.plex.tv/u/Madilind)\
**Post date:** [February 18, 2022, 9:10pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/7 "2022-02-18T21:10:19Z")

</div>

Thanks. Sounds like it is there. Just need to figure out how to get it through the API.

---

<div class="post-metadata">

**Author:** ![dane22](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/dane22/32/4389_2.png) [@dane22](https://forums.plex.tv/u/dane22)\
**Post date:** [February 18, 2022, 10:42pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/8 "2022-02-18T22:42:21Z")

</div>

> [@Madilind](#):
>
> Just need to figure out how to get it through the API.

> [@\[implemented\] Add includeGuids URL parameter to return external Guids](https://forums.plex.tv/t/implemented-add-includeguids-url-parameter-to-return-external-guids/735620):
>
> External metadata guids were implemented for the new Plex Movie and Plex TV Series agent in this previous feature request. Example: \<Guid id="imdb://tt5433138"/\> \<Guid id="tmdb://385128"/\> \<Guid id="tvdb://8856"/\> However, these external guids are only available when retrieving the metadata XML for a single item (i.e. /library/metadata/\<ratingKey\>). They are not available when retrieving the contents of a library (i.e. /library/sections/\<librarySectionID\>/all). Many 3rd party applications d…

Edit: But remember to use paging when calling /all endpoint!

See: [Plex API support for IMDB - #4 by dane22](https://forums.plex.tv/t/plex-api-support-for-imdb/776717/4)

---

<div class="post-metadata">

**Author:** ![dane22](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/dane22/32/4389_2.png) [@dane22](https://forums.plex.tv/u/dane22)\
**Post date:** [February 18, 2022, 10:45pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/9 "2022-02-18T22:45:42Z")

</div>

And there’s also 3rd. Party tools to export, like:

> **[Tautulli](https://tautulli.com/#heading)**
>
> A Python based monitoring and tracking tool for Plex Media Server

> **[Export · WebTools-NG/WebTools-NG Wiki](https://github.com/WebTools-NG/WebTools-NG/wiki/Export)**
>
> WebTools Next Generation for Plex. Contribute to WebTools-NG/WebTools-NG development by creating an account on GitHub.

---

<div class="post-metadata">

**Author:** ![Madilind](https://avatars.discourse-cdn.com/v4/letter/m/dec6dc/32.png) [@Madilind](https://forums.plex.tv/u/Madilind)\
**Post date:** [February 19, 2022, 5:45pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/10 "2022-02-19T17:45:03Z")

</div>

I got it to work but not sure it’s the most efficient way. The InnerXml is available through the API call and I can check that for the TVDB. What I did notice is that the TVDB is not included in the XML for recorded shows. In my case I don’t care but just thought I’d mention it.

---

<div class="post-metadata">

**Author:** ![dane22](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/dane22/32/4389_2.png) [@dane22](https://forums.plex.tv/u/dane22)\
**Post date:** [February 19, 2022, 7:44pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/11 "2022-02-19T19:44:33Z")

</div>

> [@Madilind](#):
>
> The InnerXml

You can also request JSON with the accept header, if that’s better for you

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/plex/original/3X/2/a/2acb9765406f63293d357b4ec509ec39aa28f2ad.png) [@system](https://forums.plex.tv/u/system)\
**Post date:** [May 20, 2022, 7:44pm UTC](https://forums.plex.tv/t/new-tv-series-agent-rest-api/777073/12 "2022-05-20T19:44:39Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.
