# Podcast Serach

## Get podcast by iTunes ID

<mark style="color:blue;">`GET`</mark> `https://podcast.inglis.dev/podcast/id`

Returns JSON representation of podcast Rss feeed, containg the feed details and episodes.

#### Query Parameters

| Name      | Type    | Description                                                                     |
| --------- | ------- | ------------------------------------------------------------------------------- |
| id        | integer | iTunes id of the podcast                                                        |
| accedning | boolean | indicates if the oldest episode to be first in the array. Defaults to \`false\` |
| count     | integer | number of items to return back                                                  |
| index     | integer | the zero-base starting point to get items                                       |

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}

```
{
    "metadata": {
        "feedUrl": "http://www.hellointernet.fm/podcast?format=rss",
        "title": "Hello Internet",
        "description": "CGP Grey and Brady Haran talk about YouTube, life, work, whatever.",
        "imageUrl": "https://images.squarespace-cdn.com/content/52d66949e4b0a8cec3bcdd46/1391195775824-JVU9K0BX50LWOKG99BL5/Hello+Internet.003.png?content-type=image%2Fpng",
        "language": "en-US",
        "category": "Education",
        "explicit": false,
        "author": "CGP Grey & Brady Haran",
        "link": "http://www.hellointernet.fm/",
        "ownerEmail": "HelloInternet@CGPGrey.com",
        "ownerName": "CGP Grey"
    },
    "items": [
        {
            "title": "H.I. #136: Dog Bingo",
            "enclosure": {
                "length": -1,
                "type": "audio/mpeg",
                "url": "http://traffic.libsyn.com/hellointernet/136FinalFinal.mp3"
            },
            "metadata": {
                "feedUrl": "http://www.hellointernet.fm/podcast?format=rss",
                "title": "Hello Internet",
                "description": "CGP Grey and Brady Haran talk about YouTube, life, work, whatever.",
                "imageUrl": "https://images.squarespace-cdn.com/content/52d66949e4b0a8cec3bcdd46/1391195775824-JVU9K0BX50LWOKG99BL5/Hello+Internet.003.png?content-type=image%2Fpng",
                "language": "en-US",
                "category": "Education",
                "explicit": false,
                "author": "CGP Grey & Brady Haran",
                "link": "http://www.hellointernet.fm/",
                "ownerEmail": "HelloInternet@CGPGrey.com",
                "ownerName": "CGP Grey"
            },
            "guid": "52d66949e4b0a8cec3bcdd46:52d67282e4b0cca8969714fa:5e58de8a37459e0d069efda0",
            "pubDate": "2020-02-28T20:13:27",
            "description": "<p>Grey and Brady discuss: The Mt Doom Edition, Dinosaurs Attack! randomness, YouTube videos from beyond the grave, betting on your weight, speedrunning, date formatting, the Space Force logo, and emoji.</p>\n<h2 id=\"sponsors-\">Sponsors:</h2>\n<p><a href=\"https://www.hellofresh.com/hellointernet10\">HelloFresh: tasty recipes &amp; fresh ingredients delivered to your door - get ten free meals including shipping - go to hellofresh.com/hellointernet10 and use promo code hellointernet10</a></p>\n<p><a href=\"http://audible.com/hellointernet\">Audible: the largest selection of audiobooks and original audio performances anywhere - start a 30-day trial and get 1 audiobook and 2 Audible Originals absolutely free by signing up at audible.com/hellointernet or text \"hellointernet\" to 500-500</a></p>\n<p><a href=\"www.dashlane.com/hellointernet\">Dashlane: password manager app and secure digital wallet - try Dashlane here for a free 30 day trial: www.dashlane.com/hellointernet (plus, here's a promo code -&gt; HelloInternet to get a 10% discount for Dashlane Premium)</a></p>\n<p><a href=\"https://www.patreon.com/hellointernet\">Listeners like YOU on Patreon</a></p>\n<h2 id=\"show-notes-\">Show Notes:</h2>\n<p><strong><a href=\"https://old.reddit.com/r/CGPGrey/\">Discuss this episode on the reddit</a></strong></p>\n<p><a href=\"http://www.bradyharanblog.com/vinyl/mount-doom\">Mt Doom Edition</a></p>\n<p><a href=\"https://loudwire.com/apollo-masters-fire-vinyl-record-production-endangered/\">Vinyl supply threatened</a></p>\n<p><a href=\"http://www.podcastpostcards.com\">Podcast Postcards</a></p>\n<p><a href=\"https://i.redd.it/j359t37wpbe41.jpg\">A Tim and David Allen</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=JSdLNJW0ct4\">\"I've been murdered\"</a></p>\n<p><a href=\"https://en.wikipedia.org/wiki/Aaron_Swartz\">Aaron Swartz</a></p>\n<p><a href=\"https://www.bbc.co.uk/news/business-51406167\">Weight loss wager firms</a></p>\n<p><a href=\"https://en.wikipedia.org/wiki/Speedrun\">Speedrunning</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=ruLQ0LShWR0\">Pitfall 2 Speed Run</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=xMX0uQpDsYU\">Doom level speedrun explained</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=pXqzaFvimqM\">House of the Dead</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=9jA53IkHZJg\">Confessions of a Tetris Addict</a></p>\n<p><a href=\"https://en.wikipedia.org/wiki/United_States_Space_Force\">United States Space Force</a></p>\n<p><a href=\"https://blog.emojipedia.org/117-new-emojis-in-final-list-for-2020/\">New Emoji season</a></p>",
            "duration": -1,
            "link": "http://www.hellointernet.fm/podcast/136",
            "image": null,
            "explicit": false
        }
    ]
}
```

{% endtab %}

{% tab title="404 Could not find a cake matching this query." %}

```
{    "message": "podcast with id 1234 not found" }
```

{% endtab %}
{% endtabs %}

## Get podcast by url

<mark style="color:blue;">`GET`</mark> `https://podcast.inglis.dev/podcast/url`

Returns json representation of podcast Rss feed, containing the feed details and episodes

#### Query Parameters

| Name      | Type    | Description                                                                     |
| --------- | ------- | ------------------------------------------------------------------------------- |
| url       | integer | url                                                                             |
| accedning | boolean | indicates if the oldest episode to be first in the array. Defaults to \`false\` |
| count     | integer | number of items to return back                                                  |
| index     | integer | the zero-base starting point to get items                                       |

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}

```
{
    "metadata": {
        "feedUrl": "http://www.hellointernet.fm/podcast?format=rss",
        "title": "Hello Internet",
        "description": "CGP Grey and Brady Haran talk about YouTube, life, work, whatever.",
        "imageUrl": "https://images.squarespace-cdn.com/content/52d66949e4b0a8cec3bcdd46/1391195775824-JVU9K0BX50LWOKG99BL5/Hello+Internet.003.png?content-type=image%2Fpng",
        "language": "en-US",
        "category": "Education",
        "explicit": false,
        "author": "CGP Grey & Brady Haran",
        "link": "http://www.hellointernet.fm/",
        "ownerEmail": "HelloInternet@CGPGrey.com",
        "ownerName": "CGP Grey"
    },
    "items": [
        {
            "title": "H.I. #136: Dog Bingo",
            "enclosure": {
                "length": -1,
                "type": "audio/mpeg",
                "url": "http://traffic.libsyn.com/hellointernet/136FinalFinal.mp3"
            },
            "metadata": {
                "feedUrl": "http://www.hellointernet.fm/podcast?format=rss",
                "title": "Hello Internet",
                "description": "CGP Grey and Brady Haran talk about YouTube, life, work, whatever.",
                "imageUrl": "https://images.squarespace-cdn.com/content/52d66949e4b0a8cec3bcdd46/1391195775824-JVU9K0BX50LWOKG99BL5/Hello+Internet.003.png?content-type=image%2Fpng",
                "language": "en-US",
                "category": "Education",
                "explicit": false,
                "author": "CGP Grey & Brady Haran",
                "link": "http://www.hellointernet.fm/",
                "ownerEmail": "HelloInternet@CGPGrey.com",
                "ownerName": "CGP Grey"
            },
            "guid": "52d66949e4b0a8cec3bcdd46:52d67282e4b0cca8969714fa:5e58de8a37459e0d069efda0",
            "pubDate": "2020-02-28T20:13:27",
            "description": "<p>Grey and Brady discuss: The Mt Doom Edition, Dinosaurs Attack! randomness, YouTube videos from beyond the grave, betting on your weight, speedrunning, date formatting, the Space Force logo, and emoji.</p>\n<h2 id=\"sponsors-\">Sponsors:</h2>\n<p><a href=\"https://www.hellofresh.com/hellointernet10\">HelloFresh: tasty recipes &amp; fresh ingredients delivered to your door - get ten free meals including shipping - go to hellofresh.com/hellointernet10 and use promo code hellointernet10</a></p>\n<p><a href=\"http://audible.com/hellointernet\">Audible: the largest selection of audiobooks and original audio performances anywhere - start a 30-day trial and get 1 audiobook and 2 Audible Originals absolutely free by signing up at audible.com/hellointernet or text \"hellointernet\" to 500-500</a></p>\n<p><a href=\"www.dashlane.com/hellointernet\">Dashlane: password manager app and secure digital wallet - try Dashlane here for a free 30 day trial: www.dashlane.com/hellointernet (plus, here's a promo code -&gt; HelloInternet to get a 10% discount for Dashlane Premium)</a></p>\n<p><a href=\"https://www.patreon.com/hellointernet\">Listeners like YOU on Patreon</a></p>\n<h2 id=\"show-notes-\">Show Notes:</h2>\n<p><strong><a href=\"https://old.reddit.com/r/CGPGrey/\">Discuss this episode on the reddit</a></strong></p>\n<p><a href=\"http://www.bradyharanblog.com/vinyl/mount-doom\">Mt Doom Edition</a></p>\n<p><a href=\"https://loudwire.com/apollo-masters-fire-vinyl-record-production-endangered/\">Vinyl supply threatened</a></p>\n<p><a href=\"http://www.podcastpostcards.com\">Podcast Postcards</a></p>\n<p><a href=\"https://i.redd.it/j359t37wpbe41.jpg\">A Tim and David Allen</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=JSdLNJW0ct4\">\"I've been murdered\"</a></p>\n<p><a href=\"https://en.wikipedia.org/wiki/Aaron_Swartz\">Aaron Swartz</a></p>\n<p><a href=\"https://www.bbc.co.uk/news/business-51406167\">Weight loss wager firms</a></p>\n<p><a href=\"https://en.wikipedia.org/wiki/Speedrun\">Speedrunning</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=ruLQ0LShWR0\">Pitfall 2 Speed Run</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=xMX0uQpDsYU\">Doom level speedrun explained</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=pXqzaFvimqM\">House of the Dead</a></p>\n<p><a href=\"https://www.youtube.com/watch?v=9jA53IkHZJg\">Confessions of a Tetris Addict</a></p>\n<p><a href=\"https://en.wikipedia.org/wiki/United_States_Space_Force\">United States Space Force</a></p>\n<p><a href=\"https://blog.emojipedia.org/117-new-emojis-in-final-list-for-2020/\">New Emoji season</a></p>",
            "duration": -1,
            "link": "http://www.hellointernet.fm/podcast/136",
            "image": null,
            "explicit": false
        }
    ]
}
```

{% endtab %}

{% tab title="404 Could not find a cake matching this query." %}

```
{    "message": "podcast with id 1234 not found" }
```

{% endtab %}
{% endtabs %}
