NAV Navbar
shell
  • Overview
  • Authentication
  • TV Shows
  • Movies
  • Artists
  • Songs
  • Appearances
  • Trending Songs
  • Errors
  • Overview

    This document describes the Tunefind REST API. The API provides methods for reading most of the data found on Tunefind.com. All API requests are secured, authenticated, and rate-limited as described below. Use of our data is subject to the Tunefind Terms of Use and Tunefind API Terms of Use.

    Important Note: This document describes features available to both Starter and Enterprise plan subscribers. To see which features are available at each plan level, please view our plans and pricing.

    View your current subscription level and invoices on your Subscription Dashboard.

    Trial Period Data Set

    During your initial two weeks free trial period, you will have access to tv show, movie and artist data with the songs that appeared in November and December 2019.

    All tv show titles, movie titles, and artist records will be available, but song data will only appear for episodes that aired and movies released during that 2 month window.

    Important Note: By default, your trial access will be limited to the features in the Starter plan. This document describes features available to both Starter and Enterprise plan subscribers. To see which features are available at each plan level, please view our plans and pricing. To trial Tunefind API Enterprise features, please contact us.

    Following your first payment, your account will be enabled for Tunefind's complete data set, per the terms of the plan you selected.

    Endpoint and Versioning

    The Tunefind API is offered via HTTPS only. The API version is explicitly denoted in the endpoint URL. The current endpoint as of this writing is below. If you have not yet signed up for the API, [ENDPOINT] will appear instead of your actual endpoint hostname. Reload this page after you've signed up for your URL.

    We may add fields, add methods, and fix API bugs without incrementing the version number. However, we will only make structural changes, field definition changes, or method changes along with a version number update.

    Encoding

    All responses are provided in the UTF-8 character set and default to JSON encoding.

    A client may also explicitly choose JSON or XML encoding either via an Accept request header.

    Format Accept Header
    JSON application/json
    XML application/xml

    HTTP

    We ask that clients support gzip encoding and make requests with an "Accept-Encoding: gzip" header. If possible we will gzip the response, indicated by a "Content-Encoding: gzip" response header.

    Requests may be made in either HTTP/1.0 or HTTP/1.1. We support persistent connections via HTTP/1.1 keepalives.

    Data Types

    Rate Limiting

    All plans are rate limited as described on our plans and pricing. Please contact us if you require a higher limit.

    Caching

    We encourage API developers to cache the results of API calls locally via memcached or similar mechanisms. This both alleviates load on the Tunefind service and speeds up your application. We recommend caching data for 24 hours for episodes and movies over one week old and for 1 hour for newer shows.

    Per the Tunefind API Terms of Use, API users must not cache or store API data in any form for longer than than 24 hours. Failure to meet this requirement will result in immediate account termination and possible legal action.

    Enterprise API users may cache or store data as specified in their contract. Contact [email protected] for more information.

    Debugging

    Adding a debug=xml or debug=json GET parameter forces the corresponding encoding and pretty-prints the result in HTML. These are intended for browser consumption; links in the XML encoding are clickable.

    Authentication

    An example request, using curl:

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/show/alias"
      -u username:password
    

    All API requests must be authenticated via HTTP Basic Authentication. In combination with mandatory HTTPS, this scheme provides for simple and secure client access.

    TV Shows

    Retrieve a TV Show

    Retrieve Tunefind tv show information for a tv show identified by their unique Tunefind id.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer"
      -u username:password
    

    Example Response

    {
        "id": "lucifer",
        "name": "Lucifer",
        "date_updated": "2018-06-09T18:35:09+00:00",
        "tunefind_url": "https://www.tunefind.com/show/lucifer",
        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer",
        "seasons": [
            {
                "season_name": "Season 1",
                "season_number": 1,
                "show_id": "lucifer",
                "show_name": "Lucifer",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-1",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-1",
                "song_count": 125,
                "episode_count": 13
            },
            {
                "season_name": "Season 2",
                "season_number": 2,
                "show_id": "lucifer",
                "show_name": "Lucifer",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-2",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-2",
                "song_count": 145,
                "episode_count": 18
            },
            {
                "season_name": "Season 3",
                "season_number": 3,
                "show_id": "lucifer",
                "show_name": "Lucifer",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3",
                "song_count": 194,
                "episode_count": 26
            }
        ],
        "theme_song": {
            "id": 111730,
            "name": "Being Evil Has a Price",
            "date_updated": "2018-06-05T21:59:28+00:00",
            "tunefind_url": "https://www.tunefind.com/song/111730/0/",
            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/111730",
            "stores": [
                {
                    "id": "applemusic",
                    "name": "AppleMusic",
                    "country": "US",
                    "song_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431?i=1130719444",
                    "song_id": "1130719444",
                    "album_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431",
                    "album_id": "1130719431",
                    "artist_url": "https://itunes.apple.com/us/artist/heavy-young-heathens/327418498",
                    "artist_id": "327418498"
                },
                {
                    "id": "itunes",
                    "name": "iTunes",
                    "country": "US",
                    "song_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431?i=1130719444",
                    "song_id": "1130719444",
                    "album_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431",
                    "album_id": "1130719431",
                    "artist_url": "https://itunes.apple.com/us/artist/heavy-young-heathens/327418498",
                    "artist_id": "327418498"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.com",
                    "country": "US",
                    "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.ca",
                    "country": "CA",
                    "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.fr",
                    "country": "FR",
                    "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.de",
                    "country": "DE",
                    "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.co.uk",
                    "country": "UK",
                    "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.in",
                    "country": "IN",
                    "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                }
            ]
        }
    }
    

    Request Parameters

    Path Parameter Value
    id The unique id for the tv show.

    By default, the id is expected to be a Tunefind id.
    External service id's can also be used by setting the id-type query parameter as required.
    Query Parameter Default Description
    id-type tunefind The type of the tv show id. One of tunefind, tmdb.

    Returns

    Returns a tv show object if a valid id was provided.

    Frequently Asked Questions

    Retrieve a Season

    Retrieve Tunefind tv show season information for a season identified by the unique Tunefind tv show id and the season number.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3"
      -u username:password
    

    Example Response

    {
        "season_name": "Season 3",
        "season_number": 3,
        "show_id": "lucifer",
        "show_name": "Lucifer",
        "date_updated": "2018-06-09T18:35:09+00:00",
        "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3",
        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3",
        "song_count": 194,
        "episode_count": 26,
        "episodes": [
            {
                "id": 52763,
                "name": "They're Back, Aren't They?",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/52763",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/52763",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-10-02T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 1,
                "song_count": 9
            },
            {
                "id": 53190,
                "name": "The One with the Baby Carrot",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/53190",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/53190",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-10-09T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 2,
                "song_count": 6
            },
            {
                "id": 53386,
                "name": "Mr. and Mrs. Mazikeen Smith",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/53386",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/53386",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-10-16T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 3,
                "song_count": 8
            },
            {
                "id": 53599,
                "name": "What Would Lucifer Do?",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/53599",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/53599",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-10-23T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 4,
                "song_count": 9
            },
            {
                "id": 54078,
                "name": "Welcome Back, Charlotte Richards",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/54078",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/54078",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-10-30T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 5,
                "song_count": 6
            },
            {
                "id": 54266,
                "name": "Vegas with Some Radish",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/54266",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/54266",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-11-06T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 6,
                "song_count": 8
            },
            {
                "id": 54421,
                "name": "Off the Record",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/54421",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/54421",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-11-13T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 7,
                "song_count": 8
            },
            {
                "id": 54571,
                "name": "Chloe Does Lucifer",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/54571",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/54571",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-11-20T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 8,
                "song_count": 6
            },
            {
                "id": 54865,
                "name": "The Sinnerman",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/54865",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/54865",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-12-04T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 9,
                "song_count": 4
            },
            {
                "id": 55135,
                "name": "The Sin Bin",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/55135",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/55135",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2017-12-11T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 10,
                "song_count": 5
            },
            {
                "id": 55417,
                "name": "City of Angels?",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/55417",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/55417",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-01-01T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 11,
                "song_count": 12
            },
            {
                "id": 56032,
                "name": "All About Her",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/56032",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/56032",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-01-22T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 12,
                "song_count": 7
            },
            {
                "id": 56198,
                "name": "Til Death Do Us Part",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/56198",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/56198",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-01-29T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 13,
                "song_count": 9
            },
            {
                "id": 56398,
                "name": "My Brother's Keeper",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/56398",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/56398",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-02-05T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 14,
                "song_count": 8
            },
            {
                "id": 57171,
                "name": "High School Poppycock",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/57171",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/57171",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-02-26T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 15,
                "song_count": 7
            },
            {
                "id": 57380,
                "name": "Infernal Guinea Pig",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/57380",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/57380",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-03-05T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 16,
                "song_count": 5
            },
            {
                "id": 57696,
                "name": "Let Pinhead Sing!",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/57696",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/57696",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-03-12T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 17,
                "song_count": 10
            },
            {
                "id": 57913,
                "name": "The Last Heartbreak",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/57913",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/57913",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-03-19T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 18,
                "song_count": 9
            },
            {
                "id": 58075,
                "name": "Orange is the New Maze",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/58075",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/58075",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-03-26T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 19,
                "song_count": 8
            },
            {
                "id": 61975,
                "name": "The Angel of San Bernardino",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/61975",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/61975",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-04-16T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 20,
                "song_count": 7
            },
            {
                "id": 62747,
                "name": "Anything Pierce Can Do I Can Do Better",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/62747",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/62747",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-04-23T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 21,
                "song_count": 8
            },
            {
                "id": 62922,
                "name": "All Hands on Decker",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/62922",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/62922",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-04-30T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 22,
                "song_count": 9
            },
            {
                "id": 63388,
                "name": "Quintessential Deckerstar",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/63388",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/63388",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-05-07T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 23,
                "song_count": 10
            },
            {
                "id": 63569,
                "name": "A Devil of My Word",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/63569",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/63569",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-05-14T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 24,
                "song_count": 4
            },
            {
                "id": 63958,
                "name": "Boo Normal",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/63958",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/63958",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-05-28T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 25,
                "song_count": 8
            },
            {
                "id": 63959,
                "name": "Once Upon a Time",
                "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/63959",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/63959",
                "date_updated": "2018-06-09T18:35:09+00:00",
                "air_date": "2018-05-28T00:00:00+00:00",
                "show_name": "Lucifer",
                "show_id": "lucifer",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 26,
                "song_count": 4
            }
        ],
        "theme_song": {
            "id": 111730,
            "name": "Being Evil Has a Price",
            "date_updated": "2018-06-05T21:59:28+00:00",
            "tunefind_url": "https://www.tunefind.com/song/111730/0/",
            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/111730",
            "stores": [
                {
                    "id": "applemusic",
                    "name": "AppleMusic",
                    "country": "US",
                    "song_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431?i=1130719444",
                    "song_id": "1130719444",
                    "album_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431",
                    "album_id": "1130719431",
                    "artist_url": "https://itunes.apple.com/us/artist/heavy-young-heathens/327418498",
                    "artist_id": "327418498"
                },
                {
                    "id": "itunes",
                    "name": "iTunes",
                    "country": "US",
                    "song_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431?i=1130719444",
                    "song_id": "1130719444",
                    "album_url": "https://itunes.apple.com/us/album/being-evil-has-a-price/1130719431",
                    "album_id": "1130719431",
                    "artist_url": "https://itunes.apple.com/us/artist/heavy-young-heathens/327418498",
                    "artist_id": "327418498"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.com",
                    "country": "US",
                    "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.ca",
                    "country": "CA",
                    "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.fr",
                    "country": "FR",
                    "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.de",
                    "country": "DE",
                    "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.co.uk",
                    "country": "UK",
                    "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                },
                {
                    "id": "amazon",
                    "name": "Amazon.in",
                    "country": "IN",
                    "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Heavy+Young+Heathens+Being+Evil+Has+a+Price"
                }
            ]
        }
    }
    

    Request Parameters

    Path Parameter Value
    id The unique id for the TV show.

    By default, the id is expected to be a Tunefind id.
    If id-type is tmdb, this is expected to be the TMDB id of the TV show.
    season-number The season number.
    Query Parameter Default Description
    id-type tunefind The type of the tv show id. One of tunefind, tmdb.

    Returns

    Returns a season object if a valid id was provided.

    Frequently Asked Questions

    Retrieve an Episode

    Retrieve Tunefind episode information for an episode identified by their unique Tunefind tv show id, season number and episode id.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/52763"
      -u username:password
    

    Example Response

    {
        "id": 52763,
        "name": "They're Back, Aren't They?",
        "tunefind_url": "https://www.tunefind.com/show/lucifer/season-3/52763",
        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/lucifer/season-3/52763",
        "date_updated": "2019-11-13T08:37:05+00:00",
        "air_date": "2017-10-02T00:00:00+00:00",
        "show_name": "Lucifer",
        "show_id": "lucifer",
        "season_name": "Season 3",
        "season_number": 3,
        "episode_number": 1,
        "songs": [
            {
                "id": 131616,
                "name": "Trouble",
                "album": "Trouble - EP",
                "date_updated": "2019-06-12T06:11:28+00:00",
                "tunefind_url": "https://www.tunefind.com/song/131616/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/131616",
                "artist": {
                    "id": "crmnl",
                    "name": "CRMNL",
                    "date_updated": "2019-06-14T06:29:40+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/crmnl",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/crmnl"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/trouble/1328140162?i=1328140176",
                        "song_id": "1328140176",
                        "song_isrc": "US43C1604848",
                        "album_url": "https://music.apple.com/us/album/trouble-ep/1328140162",
                        "album_id": "1328140162",
                        "artist_url": "https://music.apple.com/us/artist/crmnl/1328140164",
                        "artist_id": "1328140164"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/trouble/1328140162?i=1328140176",
                        "song_id": "1328140176",
                        "album_url": "https://music.apple.com/us/album/trouble/1328140162",
                        "album_id": "1328140162",
                        "artist_url": "https://music.apple.com/us/artist/crmnl/1328140164",
                        "artist_id": "1328140164"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=CRMNL+Trouble"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=CRMNL+Trouble"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=CRMNL+Trouble"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=CRMNL+Trouble"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=CRMNL+Trouble"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=CRMNL+Trouble"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/58hETwZKmfmxLdKCq2SbE1",
                        "song_id": "58hETwZKmfmxLdKCq2SbE1",
                        "song_isrc": "US43C1604848",
                        "album_url": "https://open.spotify.com/album/0EUImikv8EyrmyN4O5wSLY",
                        "album_id": "0EUImikv8EyrmyN4O5wSLY",
                        "artist_url": "https://open.spotify.com/artist/4KGzIN3H6JbwyLKjs93tUQ",
                        "artist_id": "4KGzIN3H6JbwyLKjs93tUQ"
                    }
                ],
                "appearance": {
                    "song_id": 131616,
                    "song_name": "Trouble",
                    "song_album": "Trouble - EP",
                    "artist_id": "crmnl",
                    "artist_name": "CRMNL",
                    "date_created": "2017-10-02T00:37:58+00:00",
                    "date_updated": "2017-10-04T08:12:24+00:00",
                    "scene": "(Position Music) Same Devil New Time Promo Trailer",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-02T00:37:58+00:00",
                    "confidence": "high",
                    "song_order": 1
                }
            },
            {
                "id": 131617,
                "name": "High in the Daytime",
                "album": "High in the Daytime - Single",
                "date_updated": "2019-06-12T06:11:28+00:00",
                "tunefind_url": "https://www.tunefind.com/song/131617/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/131617",
                "artist": {
                    "id": "dadwave",
                    "name": "DADWAVE",
                    "date_updated": "2019-06-12T06:11:28+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/dadwave",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/dadwave"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/high-in-the-daytime/1259683249?i=1259683604",
                        "song_id": "1259683604",
                        "song_isrc": "TCADE1705565",
                        "album_url": "https://music.apple.com/us/album/high-in-the-daytime-single/1259683249",
                        "album_id": "1259683249",
                        "artist_url": "https://music.apple.com/us/artist/dadwave/1259683601",
                        "artist_id": "1259683601"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/high-in-the-daytime/1259683249?i=1259683604",
                        "song_id": "1259683604",
                        "album_url": "https://music.apple.com/us/album/high-in-the-daytime/1259683249",
                        "album_id": "1259683249",
                        "artist_url": "https://music.apple.com/us/artist/dadwave/1259683601",
                        "artist_id": "1259683601"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=DADWAVE+High+in+the+Daytime"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=DADWAVE+High+in+the+Daytime"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=DADWAVE+High+in+the+Daytime"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=DADWAVE+High+in+the+Daytime"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=DADWAVE+High+in+the+Daytime"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=DADWAVE+High+in+the+Daytime"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/3KeN2kr9G2QV1DUkKNwV0I",
                        "song_id": "3KeN2kr9G2QV1DUkKNwV0I",
                        "song_isrc": "TCADE1705565",
                        "album_url": "https://open.spotify.com/album/7jWgplSmBPBLWqi7R7AXaY",
                        "album_id": "7jWgplSmBPBLWqi7R7AXaY",
                        "artist_url": "https://open.spotify.com/artist/6B5T49nPCgMjH35YunVZ5v",
                        "artist_id": "6B5T49nPCgMjH35YunVZ5v"
                    }
                ],
                "appearance": {
                    "song_id": 131617,
                    "song_name": "High in the Daytime",
                    "song_album": "High in the Daytime - Single",
                    "artist_id": "dadwave",
                    "artist_name": "DADWAVE",
                    "date_created": "2017-10-02T00:21:40+00:00",
                    "date_updated": "2017-10-04T08:12:24+00:00",
                    "scene": "ComicCon Trailer for Season 3 Premiere",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-02T00:21:40+00:00",
                    "confidence": "high",
                    "song_order": 2
                }
            },
            {
                "id": 133580,
                "name": "SHC",
                "album": "Sacred Hearts Club",
                "date_updated": "2019-06-12T07:27:05+00:00",
                "tunefind_url": "https://www.tunefind.com/song/133580/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/133580",
                "artist": {
                    "id": "foster-the-people",
                    "name": "Foster the People",
                    "date_updated": "2019-06-14T08:11:19+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/foster-the-people",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/foster-the-people"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/shc/1247002400?i=1247002419",
                        "song_id": "1247002419",
                        "song_isrc": "USSM11703987",
                        "album_url": "https://music.apple.com/us/album/sacred-hearts-club/1247002400",
                        "album_id": "1247002400",
                        "artist_url": "https://music.apple.com/us/artist/foster-the-people/414023649",
                        "artist_id": "414023649"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/shc/1247002400?i=1247002419",
                        "song_id": "1247002419",
                        "album_url": "https://music.apple.com/us/album/shc/1247002400",
                        "album_id": "1247002400",
                        "artist_url": "https://music.apple.com/us/artist/foster-the-people/414023649",
                        "artist_id": "414023649"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Foster+the+People+SHC"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Foster+the+People+SHC"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Foster+the+People+SHC"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Foster+the+People+SHC"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Foster+the+People+SHC"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Foster+the+People+SHC"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/1vcAHEXL5Cl9TUk0ESvWnN",
                        "song_id": "1vcAHEXL5Cl9TUk0ESvWnN",
                        "song_isrc": "USSM11703987",
                        "album_url": "https://open.spotify.com/album/5lFvZh6pCTJzr9UStebyCF",
                        "album_id": "5lFvZh6pCTJzr9UStebyCF",
                        "artist_url": "https://open.spotify.com/artist/7gP3bB2nilZXLfPHJhMdvc",
                        "artist_id": "7gP3bB2nilZXLfPHJhMdvc"
                    }
                ],
                "appearance": {
                    "song_id": 133580,
                    "song_name": "SHC",
                    "song_album": "Sacred Hearts Club",
                    "artist_id": "foster-the-people",
                    "artist_name": "Foster the People",
                    "date_created": "2017-10-02T07:46:39+00:00",
                    "date_updated": "2017-10-13T06:42:33+00:00",
                    "scene": "At the party, Lucifer and Chloe question Josh Hamid about the murder of his friend, Steve Banales.",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-02T07:46:39+00:00",
                    "confidence": "high",
                    "song_order": 7
                }
            },
            {
                "id": 133588,
                "name": "Charge Up the Power",
                "album": "Magic Valley",
                "date_updated": "2019-06-16T05:15:41+00:00",
                "tunefind_url": "https://www.tunefind.com/song/133588/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/133588",
                "artist": {
                    "id": "goodbye-june",
                    "name": "Goodbye June",
                    "date_updated": "2019-06-16T05:15:41+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/goodbye-june",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/goodbye-june"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/charge-up-the-power/1440891346?i=1440891943",
                        "song_id": "1440891943",
                        "song_isrc": "USUM71702196",
                        "album_url": "https://music.apple.com/us/album/magic-valley/1440891346",
                        "album_id": "1440891346",
                        "artist_url": "https://music.apple.com/us/artist/goodbye-june/532276505",
                        "artist_id": "532276505"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/charge-up-the-power/1440891346?i=1440891943",
                        "song_id": "1440891943",
                        "album_url": "https://music.apple.com/us/album/charge-up-the-power/1440891346",
                        "album_id": "1440891346",
                        "artist_url": "https://music.apple.com/us/artist/goodbye-june/532276505",
                        "artist_id": "532276505"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Goodbye+June+Charge+Up+the+Power"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Goodbye+June+Charge+Up+the+Power"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Goodbye+June+Charge+Up+the+Power"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Goodbye+June+Charge+Up+the+Power"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Goodbye+June+Charge+Up+the+Power"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Goodbye+June+Charge+Up+the+Power"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/0Y1igqVfNxFStlNN8l3XMz",
                        "song_id": "0Y1igqVfNxFStlNN8l3XMz",
                        "song_isrc": "USUM71702196",
                        "album_url": "https://open.spotify.com/album/4GQp1LbFHcJVkS9M5HUzAL",
                        "album_id": "4GQp1LbFHcJVkS9M5HUzAL",
                        "artist_url": "https://open.spotify.com/artist/1l9I7G8J8AnMScWQwlNJ4M",
                        "artist_id": "1l9I7G8J8AnMScWQwlNJ4M"
                    }
                ],
                "appearance": {
                    "song_id": 133588,
                    "song_name": "Charge Up the Power",
                    "song_album": "Magic Valley",
                    "artist_id": "goodbye-june",
                    "artist_name": "Goodbye June",
                    "date_created": "2017-10-02T18:51:44+00:00",
                    "date_updated": "2017-10-03T14:19:29+00:00",
                    "scene": "Montage of the city; Lucifer tells a man that the food truck is closed.",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-02T18:51:44+00:00",
                    "confidence": "high",
                    "song_order": 9
                }
            },
            {
                "id": 133595,
                "name": "Boy",
                "album": "Darling Destroyer",
                "date_updated": "2019-06-12T07:27:05+00:00",
                "tunefind_url": "https://www.tunefind.com/song/133595/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/133595",
                "artist": {
                    "id": "leopold-and-his-fiction",
                    "name": "Leopold and his Fiction",
                    "date_updated": "2019-06-16T06:43:53+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/leopold-and-his-fiction",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/leopold-and-his-fiction"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/boy/1204678152?i=1204678451",
                        "song_id": "1204678451",
                        "song_isrc": "QZ2P21600053",
                        "album_url": "https://music.apple.com/us/album/darling-destroyer/1204678152",
                        "album_id": "1204678152",
                        "artist_url": "https://music.apple.com/us/artist/leopold-and-his-fiction/203643881",
                        "artist_id": "203643881"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/boy/1204678152?i=1204678451",
                        "song_id": "1204678451",
                        "album_url": "https://music.apple.com/us/album/boy/1204678152",
                        "album_id": "1204678152",
                        "artist_url": "https://music.apple.com/us/artist/leopold-and-his-fiction/203643881",
                        "artist_id": "203643881"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Leopold+and+his+Fiction+Boy"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Leopold+and+his+Fiction+Boy"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Leopold+and+his+Fiction+Boy"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Leopold+and+his+Fiction+Boy"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Leopold+and+his+Fiction+Boy"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Leopold+and+his+Fiction+Boy"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/6BptMD5C2f8wVsn1t8Pdzh",
                        "song_id": "6BptMD5C2f8wVsn1t8Pdzh",
                        "song_isrc": "QZ2P21600053",
                        "album_url": "https://open.spotify.com/album/4fIQdXaNjCziWzYyOj3jiP",
                        "album_id": "4fIQdXaNjCziWzYyOj3jiP",
                        "artist_url": "https://open.spotify.com/artist/2W5wABLNgrre5orFJogc7H",
                        "artist_id": "2W5wABLNgrre5orFJogc7H"
                    }
                ],
                "appearance": {
                    "song_id": 133595,
                    "song_name": "Boy",
                    "song_album": "Darling Destroyer",
                    "artist_id": "leopold-and-his-fiction",
                    "artist_name": "Leopold and his Fiction",
                    "date_created": "2017-10-03T00:22:46+00:00",
                    "date_updated": "2017-10-04T08:12:25+00:00",
                    "scene": "Lieutenant Marcus Pierce introduces himself briefly to the precinct.",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-03T00:22:46+00:00",
                    "confidence": "high",
                    "song_order": 6
                }
            },
            {
                "id": 133596,
                "name": "Prawan",
                "album": "Original Music from Bali",
                "date_updated": "2019-06-12T07:27:05+00:00",
                "tunefind_url": "https://www.tunefind.com/song/133596/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/133596",
                "artist": {
                    "id": "ricky-sadha",
                    "name": "Ricky Sadha",
                    "date_updated": "2019-06-12T07:27:05+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/ricky-sadha",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/ricky-sadha"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/prawan/397050552?i=397050626",
                        "song_id": "397050626",
                        "song_isrc": "DEEP81002809",
                        "album_url": "https://music.apple.com/us/album/original-music-from-bali/397050552",
                        "album_id": "397050552",
                        "artist_url": "https://music.apple.com/us/artist/ricky-sadha/270119298",
                        "artist_id": "270119298"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/prawan/397050552?i=397050626",
                        "song_id": "397050626",
                        "album_url": "https://music.apple.com/us/album/prawan/397050552",
                        "album_id": "397050552",
                        "artist_url": "https://music.apple.com/us/artist/ricky-sadha/270119298",
                        "artist_id": "270119298"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Ricky+Sadha+Prawan"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Ricky+Sadha+Prawan"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Ricky+Sadha+Prawan"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Ricky+Sadha+Prawan"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Ricky+Sadha+Prawan"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Ricky+Sadha+Prawan"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/01RYc1k507n7QQ1E4mnpoB",
                        "song_id": "01RYc1k507n7QQ1E4mnpoB",
                        "song_isrc": "DEEP81002809",
                        "album_url": "https://open.spotify.com/album/4A0HlwOZWWngRwACyK2Mmu",
                        "album_id": "4A0HlwOZWWngRwACyK2Mmu",
                        "artist_url": "https://open.spotify.com/artist/2oT6fQr8CkYQzQ39qy6sy4",
                        "artist_id": "2oT6fQr8CkYQzQ39qy6sy4"
                    }
                ],
                "appearance": {
                    "song_id": 133596,
                    "song_name": "Prawan",
                    "song_album": "Original Music from Bali",
                    "artist_id": "ricky-sadha",
                    "artist_name": "Ricky Sadha",
                    "date_created": "2017-10-03T00:24:45+00:00",
                    "date_updated": "2017-10-03T14:19:32+00:00",
                    "scene": "Remedy offers Amenadiel a massage.",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-03T00:24:46+00:00",
                    "confidence": "high",
                    "song_order": 8
                }
            },
            {
                "id": 133593,
                "name": "Shave And A Haircut, Two Bits",
                "album": "",
                "date_updated": "2019-06-12T07:29:42+00:00",
                "tunefind_url": "https://www.tunefind.com/song/133593/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/133593",
                "artist": {
                    "id": "traditional",
                    "name": "Traditional",
                    "date_updated": "2019-06-16T06:29:23+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/traditional",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/traditional"
                },
                "stores": [
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Traditional+Shave+And+A+Haircut%2C+Two+Bits"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Traditional+Shave+And+A+Haircut%2C+Two+Bits"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Traditional+Shave+And+A+Haircut%2C+Two+Bits"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Traditional+Shave+And+A+Haircut%2C+Two+Bits"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Traditional+Shave+And+A+Haircut%2C+Two+Bits"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Traditional+Shave+And+A+Haircut%2C+Two+Bits"
                    }
                ],
                "appearance": {
                    "song_id": 133593,
                    "song_name": "Shave And A Haircut, Two Bits",
                    "song_album": "",
                    "artist_id": "traditional",
                    "artist_name": "Traditional",
                    "date_created": "2017-10-03T00:20:38+00:00",
                    "date_updated": "2017-10-04T08:12:25+00:00",
                    "scene": "Lucifer hunks the horn on the armored truck, as he stops at the police blockade.",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-03T00:20:38+00:00",
                    "confidence": "high",
                    "song_order": 4
                }
            },
            {
                "id": 133594,
                "name": "Knock Me Out",
                "album": "Knock Me Out - Single",
                "date_updated": "2019-06-12T07:27:05+00:00",
                "tunefind_url": "https://www.tunefind.com/song/133594/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/133594",
                "artist": {
                    "id": "vintage-trouble",
                    "name": "Vintage Trouble",
                    "date_updated": "2019-06-12T07:27:05+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/vintage-trouble",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/vintage-trouble"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/knock-me-out/1435227748?i=1435227750",
                        "song_id": "1435227750",
                        "song_isrc": "GBLFP1708466",
                        "album_url": "https://music.apple.com/us/album/knock-me-out-single/1435227748",
                        "album_id": "1435227748",
                        "artist_url": "https://music.apple.com/us/artist/vintage-trouble/385036602",
                        "artist_id": "385036602"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/knock-me-out/1435227748?i=1435227750",
                        "song_id": "1435227750",
                        "album_url": "https://music.apple.com/us/album/knock-me-out/1435227748",
                        "album_id": "1435227748",
                        "artist_url": "https://music.apple.com/us/artist/vintage-trouble/385036602",
                        "artist_id": "385036602"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Vintage+Trouble+Knock+Me+Out"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Vintage+Trouble+Knock+Me+Out"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Vintage+Trouble+Knock+Me+Out"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Vintage+Trouble+Knock+Me+Out"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Vintage+Trouble+Knock+Me+Out"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Vintage+Trouble+Knock+Me+Out"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/6hZg9eBzZtn5SpHarPehbU",
                        "song_id": "6hZg9eBzZtn5SpHarPehbU",
                        "song_isrc": "GBLFP1708466",
                        "album_url": "https://open.spotify.com/album/5X4AuforMNHvb66UZU3zfE",
                        "album_id": "5X4AuforMNHvb66UZU3zfE",
                        "artist_url": "https://open.spotify.com/artist/72Pauuctba5lMzC89R0Vk0",
                        "artist_id": "72Pauuctba5lMzC89R0Vk0"
                    }
                ],
                "appearance": {
                    "song_id": 133594,
                    "song_name": "Knock Me Out",
                    "song_album": "Knock Me Out - Single",
                    "artist_id": "vintage-trouble",
                    "artist_name": "Vintage Trouble",
                    "date_created": "2017-10-03T00:22:00+00:00",
                    "date_updated": "2017-10-04T08:12:25+00:00",
                    "scene": "Lucifer takes Chloe to the desert in an attempt to find evidence of his kidnapping.",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-03T00:22:01+00:00",
                    "confidence": "high",
                    "song_order": 5
                }
            },
            {
                "id": 130467,
                "name": "The Devil You Know",
                "album": "The Devil You Know - Single",
                "date_updated": "2019-06-16T05:15:41+00:00",
                "tunefind_url": "https://www.tunefind.com/song/130467/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/130467",
                "artist": {
                    "id": "x-ambassadors",
                    "name": "X Ambassadors",
                    "date_updated": "2019-06-16T05:15:41+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/x-ambassadors",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/x-ambassadors"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/the-devil-you-know/1445294332?i=1445294348",
                        "song_id": "1445294348",
                        "song_isrc": "USUM71705659",
                        "album_url": "https://music.apple.com/us/album/the-devil-you-know-single/1445294332",
                        "album_id": "1445294332",
                        "artist_url": "https://music.apple.com/us/artist/x-ambassadors/622429974",
                        "artist_id": "622429974"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/the-devil-you-know/1445294332?i=1445294348",
                        "song_id": "1445294348",
                        "album_url": "https://music.apple.com/us/album/the-devil-you-know/1445294332",
                        "album_id": "1445294332",
                        "artist_url": "https://music.apple.com/us/artist/x-ambassadors/622429974",
                        "artist_id": "622429974"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=X+Ambassadors+The+Devil+You+Know"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=X+Ambassadors+The+Devil+You+Know"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=X+Ambassadors+The+Devil+You+Know"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=X+Ambassadors+The+Devil+You+Know"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=X+Ambassadors+The+Devil+You+Know"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=X+Ambassadors+The+Devil+You+Know"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/5MEKqNAOlgt3sh5o0iq8EM",
                        "song_id": "5MEKqNAOlgt3sh5o0iq8EM",
                        "song_isrc": "USUM71705659",
                        "album_url": "https://open.spotify.com/album/386PuaIwJSmvEYhwgSKJoF",
                        "album_id": "386PuaIwJSmvEYhwgSKJoF",
                        "artist_url": "https://open.spotify.com/artist/3NPpFNZtSTHheNBaWC82rB",
                        "artist_id": "3NPpFNZtSTHheNBaWC82rB"
                    }
                ],
                "appearance": {
                    "song_id": 130467,
                    "song_name": "The Devil You Know",
                    "song_album": "The Devil You Know - Single",
                    "artist_id": "x-ambassadors",
                    "artist_name": "X Ambassadors",
                    "date_created": "2017-10-02T07:26:55+00:00",
                    "date_updated": "2019-05-16T01:58:27+00:00",
                    "scene": "An armored guard comes across Lucifer in the middle of the desert; (continues) The thief runs through the desert in his underwear.",
                    "air_date": "2017-10-02T00:00:00+00:00",
                    "syndication_date": "2017-10-02T07:26:56+00:00",
                    "confidence": "high",
                    "song_order": 3
                }
            }
        ]
    }
    

    Request Parameters

    Path Parameter Value
    id The unique id for the TV show.

    By default, the id is expected to be a Tunefind id.
    If id-type is tmdb, this is expected to be the TMDB id of the TV show.
    season-number The season number.
    episode-id The unique id for the episode.

    By default, the episode-id is expected to be a Tunefind episode id.
    If id-type is tmdb, this is expected to be an episode number (e.g. 1, 3, 12).
    Query Parameter Default Description
    id-type tunefind The type of the tv show id. One of tunefind, tmdb. When tmdb is selected, the episode-id will also be expected as an episode number.

    Returns

    Returns an episode object if a valid id was provided.

    Frequently Asked Questions

    List TV Shows

    Retrieve the list of all Tunefind tv shows. TV Shows are returned sorted by their names.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/show?limit=10&offset=100"
      -u username:password
    

    Example Response

    {
        "shows": [
            {
                "id": "betrayal",
                "name": "Betrayal",
                "date_updated": "2018-05-18T18:35:29+00:00",
                "tunefind_url": "https://www.tunefind.com/show/betrayal",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/betrayal"
            },
            {
                "id": "better-call-saul",
                "name": "Better Call Saul",
                "date_updated": "2018-06-06T06:34:38+00:00",
                "tunefind_url": "https://www.tunefind.com/show/better-call-saul",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/better-call-saul"
            },
            {
                "id": "better-late-than-never",
                "name": "Better Late Than Never",
                "date_updated": "2018-06-07T21:10:02+00:00",
                "tunefind_url": "https://www.tunefind.com/show/better-late-than-never",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/better-late-than-never"
            },
            {
                "id": "better-things",
                "name": "Better Things",
                "date_updated": "2018-04-07T18:49:25+00:00",
                "tunefind_url": "https://www.tunefind.com/show/better-things",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/better-things"
            },
            {
                "id": "between",
                "name": "Between",
                "date_updated": "2018-03-22T18:38:49+00:00",
                "tunefind_url": "https://www.tunefind.com/show/between",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/between"
            },
            {
                "id": "beverly-hills-90210",
                "name": "Beverly Hills, 90210",
                "date_updated": "2018-06-11T02:33:36+00:00",
                "tunefind_url": "https://www.tunefind.com/show/beverly-hills-90210",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/beverly-hills-90210"
            },
            {
                "id": "beyond",
                "name": "Beyond",
                "date_updated": "2018-05-23T20:54:43+00:00",
                "tunefind_url": "https://www.tunefind.com/show/beyond",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/beyond"
            },
            {
                "id": "big-little-lies",
                "name": "Big Little Lies",
                "date_updated": "2018-05-30T18:33:55+00:00",
                "tunefind_url": "https://www.tunefind.com/show/big-little-lies",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/big-little-lies"
            },
            {
                "id": "big-love",
                "name": "Big Love",
                "date_updated": "2018-05-17T18:34:16+00:00",
                "tunefind_url": "https://www.tunefind.com/show/big-love",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/big-love"
            },
            {
                "id": "big-mouth",
                "name": "Big Mouth",
                "date_updated": "2018-04-18T20:35:18+00:00",
                "tunefind_url": "https://www.tunefind.com/show/big-mouth",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/big-mouth"
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    date_updated null (optional) The minimum update date, in ISO 8601 format (e.g. 2018-06-05T10:31:26+00:00). If set, only returns the tv shows that were updated at or after this date.
    limit 1000 (optional) The number of tv show objects to return.
    offset 0 (optional) The index of first tv show to return. Indexes start from 0.

    Returns

    Returns an associative array with shows property that contains an array of simplified tv show objects found.

    Search TV Shows By A Term

    Retrieve the list of Tunefind tv shows that match a keyword string.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/search/show?q=strange"
      -u username:password
    

    Example Response

    {
        "results": [
            {
                "id": "stranger-things",
                "name": "Stranger Things",
                "tunefind_url": "https://www.tunefind.com/show/stranger-things",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/stranger-things"
            },
            {
                "id": "orange-is-the-new-black",
                "name": "Orange is the New Black",
                "tunefind_url": "https://www.tunefind.com/show/orange-is-the-new-black",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/orange-is-the-new-black"
            },
            {
                "id": "the-arrangement",
                "name": "The Arrangement",
                "tunefind_url": "https://www.tunefind.com/show/the-arrangement",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-arrangement"
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    q null The search query keywords.
    limit 1000 (optional) The number of tv show objects to return.
    offset 0 (optional) The index of first tv show to return. Indexes start from 0.

    Returns

    Returns an associative array with results property that contains an array of simplified tv show objects found.

    The TV Show Object

    Attribute Type Description
    id string Unique identifier for the tv show.
    name string The name of the tv show.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the tv show.
    tunefind_api_url string The Tunefind API endpoint URL for the tv show.
    seasons an array of season objects The seasons of the tv show.
    theme_song a song object The theme song of the tv show.
    appearance an appearance object The appearance information of the tv show.

    (*) Relational attributes are automatically included in responses where applicable.

    (**) Appearance information is only included when the tv show object is part of a song.

    The TV Show Object (Simplified)

    Attribute Type Description
    id string Unique identifier for the tv show.
    name string The name of the tv show.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the tv show.
    tunefind_api_url string The Tunefind API endpoint URL for the tv show.

    The Season Object

    Attribute Type Description
    season_name string The name of the season.
    season_number string The number of the season.
    show_id string Unique identifier for the tv show of the season.
    show_name string The name of the tv show of the season.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the season.
    tunefind_api_url string The Tunefind API endpoint URL for the season.
    song_count string The total number of songs in the season.
    episode_count string The total number of episodes in the season.
    episodes an array of episode objects The episodes of the season.
    theme_song a song object The theme song of the season.

    (*) Relational attributes are automatically included in responses where applicable.

    The Episode Object

    Attribute Type Description
    id string Unique identifier for the episode.
    name string The name of the episode.
    air_date date The date at which the movie was aired.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the episode.
    tunefind_api_url string The Tunefind API endpoint URL for the episode.
    episode_number string The number of the episode.
    show_id string Unique identifier for the tv show of the episode.
    show_name string The name of the tv show of the episode.
    season_name string The name of the season of the episode.
    season_number string The number of the season of the episode.
    songs an array of song objects The songs that appeared in the episode.
    theme_song a song object The theme song of the episode.
    appearance an appearance object The appearance information of the episode.

    (*) Relational attributes are automatically included in responses where applicable.

    (**) Appearance information is only included when the episode object is part of a song.

    Movies

    Retrieve a Movie

    Retrieve Tunefind movie information for a movie identified by their unique id.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/movie/matrix"
      -u username:password
    

    Example Response

    {
        "id": "matrix",
        "name": "The Matrix",
        "tunefind_url": "https://www.tunefind.com/movie/matrix",
        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/matrix",
        "date_updated": "2019-10-31T09:51:09+00:00",
        "air_date": "1999-03-31T00:00:00+00:00",
        "songs": [
            {
                "id": 21253,
                "name": "My Own Summer (Shove It)",
                "album": "Music From And Inspired By The Motion Picture The Matrix",
                "date_updated": "2019-06-10T12:16:25+00:00",
                "tunefind_url": "https://www.tunefind.com/song/21253/0//my-own-summer-shove-it",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/21253",
                "artist": {
                    "id": "deftones",
                    "name": "Deftones",
                    "date_updated": "2019-06-17T06:51:41+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/deftones",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/deftones"
                },
                "stores": [
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/6RksDZXySI6A9BQeJDFK2G",
                        "song_id": "6RksDZXySI6A9BQeJDFK2G",
                        "song_isrc": "USMV29700142",
                        "album_url": "https://open.spotify.com/album/5BofYSCt13mhMt4WkIJr7O",
                        "album_id": "5BofYSCt13mhMt4WkIJr7O",
                        "artist_url": "https://open.spotify.com/artist/6Ghvu1VvMGScGpOUJBAHNH",
                        "artist_id": "6Ghvu1VvMGScGpOUJBAHNH"
                    }
                ],
                "appearance": {
                    "song_id": 21253,
                    "song_name": "My Own Summer (Shove It)",
                    "song_album": "Music From And Inspired By The Motion Picture The Matrix",
                    "artist_id": "deftones",
                    "artist_name": "Deftones",
                    "date_created": "2010-05-08T05:37:39+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2014-09-14T18:25:56+00:00",
                    "confidence": "high",
                    "song_order": 13
                }
            },
            {
                "id": 1264,
                "name": "Minor Swing",
                "album": "Honeysuckle Rose",
                "date_updated": "2019-05-27T09:20:12+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1264/0//minor-swing",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1264",
                "artist": {
                    "id": "django-reinhardt",
                    "name": "Django Reinhardt",
                    "date_updated": "2019-06-17T05:34:03+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/django-reinhardt",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/django-reinhardt"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/minor-swing/282878229?i=282878233",
                        "song_id": "282878233",
                        "song_isrc": "DEB790304112",
                        "album_url": "https://music.apple.com/us/album/honeysuckle-rose/282878229",
                        "album_id": "282878229",
                        "artist_url": "https://music.apple.com/us/artist/django-reinhardt/104576",
                        "artist_id": "104576"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/minor-swing/282878229?i=282878233",
                        "song_id": "282878233",
                        "album_url": "https://music.apple.com/us/album/minor-swing/282878229",
                        "album_id": "282878229",
                        "artist_url": "https://music.apple.com/us/artist/django-reinhardt/104576",
                        "artist_id": "104576"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Django+Reinhardt+Minor+Swing"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Django+Reinhardt+Minor+Swing"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Django+Reinhardt+Minor+Swing"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Django+Reinhardt+Minor+Swing"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Django+Reinhardt+Minor+Swing"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Django+Reinhardt+Minor+Swing"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/3qPQxLOF4cAi7rvHUn4cqE",
                        "song_id": "3qPQxLOF4cAi7rvHUn4cqE",
                        "song_isrc": "FRZ113705332",
                        "album_url": "https://open.spotify.com/album/6n4MbIocFJ9oHFszyhN1uF",
                        "album_id": "6n4MbIocFJ9oHFszyhN1uF",
                        "artist_url": "https://open.spotify.com/artist/5Z1XZyEFY0dewG8faEIiEx",
                        "artist_id": "5Z1XZyEFY0dewG8faEIiEx"
                    }
                ],
                "appearance": {
                    "song_id": 1264,
                    "song_name": "Minor Swing",
                    "song_album": "Honeysuckle Rose",
                    "artist_id": "django-reinhardt",
                    "artist_name": "Django Reinhardt",
                    "date_created": "2005-07-08T17:18:50+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "The faint music that can be heard when Neo meets the Oracle.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:20:01+00:00",
                    "confidence": "high",
                    "song_order": 7
                }
            },
            {
                "id": 163,
                "name": "I'm Beginning to See the Light",
                "album": "Piano In The Background",
                "date_updated": "2019-06-05T12:11:29+00:00",
                "tunefind_url": "https://www.tunefind.com/song/163/0//im-beginning-to-see-the-light",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/163",
                "artist": {
                    "id": "duke-ellington",
                    "name": "Duke Ellington",
                    "date_updated": "2019-06-17T05:32:17+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/duke-ellington",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/duke-ellington"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/im-beginning-to-see-the-light/1444003063?i=937358838",
                        "song_id": "937358838",
                        "song_isrc": "US3M59783714",
                        "album_url": "https://music.apple.com/us/album/play-on-original-broadway-cast-recording/1444003063",
                        "album_id": "1444003063",
                        "artist_url": "https://music.apple.com/us/artist/duke-ellington/39525",
                        "artist_id": "39525"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Duke+Ellington+I%27m+Beginning+to+See+the+Light"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Duke+Ellington+I%27m+Beginning+to+See+the+Light"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Duke+Ellington+I%27m+Beginning+to+See+the+Light"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Duke+Ellington+I%27m+Beginning+to+See+the+Light"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Duke+Ellington+I%27m+Beginning+to+See+the+Light"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Duke+Ellington+I%27m+Beginning+to+See+the+Light"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/6IwTbcKNHtff1oYdM0tVSO",
                        "song_id": "6IwTbcKNHtff1oYdM0tVSO",
                        "song_isrc": "USSM10307455",
                        "album_url": "https://open.spotify.com/album/5HRYqb7mp810fhgWiUL0uo",
                        "album_id": "5HRYqb7mp810fhgWiUL0uo",
                        "artist_url": "https://open.spotify.com/artist/4F7Q5NV6h5TSwCainz8S5A",
                        "artist_id": "4F7Q5NV6h5TSwCainz8S5A"
                    }
                ],
                "appearance": {
                    "song_id": 163,
                    "song_name": "I'm Beginning to See the Light",
                    "song_album": "Piano In The Background",
                    "artist_id": "duke-ellington",
                    "artist_name": "Duke Ellington",
                    "date_created": "2005-07-08T17:19:49+00:00",
                    "date_updated": "2018-03-07T18:58:42+00:00",
                    "scene": "Faint music heard during Neo's visit to the Orcale. Song starts after Minor Swing as Oracle sits down after lighting a cigarette.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:20:13+00:00",
                    "confidence": "high",
                    "song_order": 8
                }
            },
            {
                "id": 21254,
                "name": "Ultrasonic Sound",
                "album": "The Matrix (The Original Motion Picture Soundtrack)",
                "date_updated": "2019-05-29T09:13:26+00:00",
                "tunefind_url": "https://www.tunefind.com/song/21254/0//ultrasonic-sound",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/21254",
                "artist": {
                    "id": "hive",
                    "name": "Hive",
                    "date_updated": "2019-05-29T09:13:26+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/hive",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/hive"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/ultrasonic-sound/643886158?i=643886641",
                        "song_id": "643886641",
                        "song_isrc": "USAE81375586"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/ultrasonic-sound/643886158?i=643886641",
                        "song_id": "643886641",
                        "album_url": "https://music.apple.com/us/album/ultrasonic-sound/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/hive/6562522",
                        "artist_id": "6562522"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Hive+Ultrasonic+Sound"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Hive+Ultrasonic+Sound"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Hive+Ultrasonic+Sound"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Hive+Ultrasonic+Sound"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Hive+Ultrasonic+Sound"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Hive+Ultrasonic+Sound"
                    }
                ],
                "appearance": {
                    "song_id": 21254,
                    "song_name": "Ultrasonic Sound",
                    "song_album": "The Matrix (The Original Motion Picture Soundtrack)",
                    "artist_id": "hive",
                    "artist_name": "Hive",
                    "date_created": "2010-05-08T05:40:52+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2014-09-14T18:25:40+00:00",
                    "confidence": "high",
                    "song_order": 14
                }
            },
            {
                "id": 1260,
                "name": "Leave You Far Behind (Lunatics Roller Coaster Mix)",
                "album": "The Matrix (Music from the Motion Picture)",
                "date_updated": "2019-05-27T09:20:12+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1260/0//leave-you-far-behind",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1260",
                "artist": {
                    "id": "lunatic-calm",
                    "name": "Lunatic Calm",
                    "date_updated": "2019-06-06T05:58:25+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/lunatic-calm",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/lunatic-calm"
                },
                "stores": [
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Lunatic+Calm+Leave+You+Far+Behind+%28Lunatics+Roller+Coaster+Mix%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Lunatic+Calm+Leave+You+Far+Behind+%28Lunatics+Roller+Coaster+Mix%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Lunatic+Calm+Leave+You+Far+Behind+%28Lunatics+Roller+Coaster+Mix%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Lunatic+Calm+Leave+You+Far+Behind+%28Lunatics+Roller+Coaster+Mix%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Lunatic+Calm+Leave+You+Far+Behind+%28Lunatics+Roller+Coaster+Mix%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Lunatic+Calm+Leave+You+Far+Behind+%28Lunatics+Roller+Coaster+Mix%29"
                    }
                ],
                "appearance": {
                    "song_id": 1260,
                    "song_name": "Leave You Far Behind (Lunatics Roller Coaster Mix)",
                    "song_album": "The Matrix (Music from the Motion Picture)",
                    "artist_id": "lunatic-calm",
                    "artist_name": "Lunatic Calm",
                    "date_created": "2005-07-08T17:16:07+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "During the fight training scene between Neo and Morpheus.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:19:21+00:00",
                    "confidence": "high",
                    "song_order": 3
                }
            },
            {
                "id": 1267,
                "name": "Rock Is Dead",
                "album": "Lest We Forget: The Best of Marilyn Manson",
                "date_updated": "2019-05-27T09:20:12+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1267/0//rock-is-dead",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1267",
                "artist": {
                    "id": "marilyn-manson",
                    "name": "Marilyn Manson",
                    "date_updated": "2019-06-15T05:55:57+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/marilyn-manson",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/marilyn-manson"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/rock-is-dead/1440746922?i=24164221",
                        "song_id": "24164221",
                        "song_isrc": "USIR19801984",
                        "album_url": "https://music.apple.com/us/album/lest-we-forget-the-best-of-marilyn-manson/1440746922",
                        "album_id": "1440746922",
                        "artist_url": "https://music.apple.com/us/artist/marilyn-manson/251375",
                        "artist_id": "251375"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Marilyn+Manson+Rock+Is+Dead"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Marilyn+Manson+Rock+Is+Dead"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Marilyn+Manson+Rock+Is+Dead"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Marilyn+Manson+Rock+Is+Dead"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Marilyn+Manson+Rock+Is+Dead"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Marilyn+Manson+Rock+Is+Dead"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/5VcT2u1rdqapSo7BWP20Ls",
                        "song_id": "5VcT2u1rdqapSo7BWP20Ls",
                        "song_isrc": "USIR19801984",
                        "album_url": "https://open.spotify.com/album/7kcbYCvOoFZs9FRPDWVrey",
                        "album_id": "7kcbYCvOoFZs9FRPDWVrey",
                        "artist_url": "https://open.spotify.com/artist/2VYQTNDsvvKN9wmU5W7xpj",
                        "artist_id": "2VYQTNDsvvKN9wmU5W7xpj"
                    }
                ],
                "appearance": {
                    "song_id": 1267,
                    "song_name": "Rock Is Dead",
                    "song_album": "Lest We Forget: The Best of Marilyn Manson",
                    "artist_id": "marilyn-manson",
                    "artist_name": "Marilyn Manson",
                    "date_created": "2005-07-08T17:21:22+00:00",
                    "date_updated": "2017-10-04T18:34:36+00:00",
                    "scene": "End Credits (after RATM)",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2013-04-19T04:28:45+00:00",
                    "confidence": "high",
                    "song_order": 11
                }
            },
            {
                "id": 1258,
                "name": "Dissolved Girl",
                "album": "Mezzanine",
                "date_updated": "2019-05-27T09:19:52+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1258/0//dissolved-girl",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1258",
                "artist": {
                    "id": "massive-attack",
                    "name": "Massive Attack",
                    "date_updated": "2019-06-14T08:16:04+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/massive-attack",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/massive-attack"
                },
                "stores": [
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Massive+Attack+Dissolved+Girl"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Massive+Attack+Dissolved+Girl"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Massive+Attack+Dissolved+Girl"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Massive+Attack+Dissolved+Girl"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Massive+Attack+Dissolved+Girl"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Massive+Attack+Dissolved+Girl"
                    }
                ],
                "appearance": {
                    "song_id": 1258,
                    "song_name": "Dissolved Girl",
                    "song_album": "Mezzanine",
                    "artist_id": "massive-attack",
                    "artist_name": "Massive Attack",
                    "date_created": "2005-07-08T17:14:47+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "Neo is sleeping, his computer starts typing and wakes him up.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:18:59+00:00",
                    "confidence": "high",
                    "song_order": 1
                }
            },
            {
                "id": 1262,
                "name": "Prime Audio Soup",
                "album": "Actual Sounds + Voices",
                "date_updated": "2019-05-27T09:20:12+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1262/0//prime-audio-soup",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1262",
                "artist": {
                    "id": "meat-beat-manifesto",
                    "name": "Meat Beat Manifesto",
                    "date_updated": "2019-06-01T09:13:55+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/meat-beat-manifesto",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/meat-beat-manifesto"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/prime-audio-soup/61336158?i=61336107",
                        "song_id": "61336107",
                        "song_isrc": "BEP010490374",
                        "album_url": "https://music.apple.com/us/album/actual-sounds-voices/61336158",
                        "album_id": "61336158",
                        "artist_url": "https://music.apple.com/us/artist/meat-beat-manifesto/4321346",
                        "artist_id": "4321346"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/prime-audio-soup/61336158?i=61336107",
                        "song_id": "61336107",
                        "album_url": "https://music.apple.com/us/album/prime-audio-soup/61336158",
                        "album_id": "61336158",
                        "artist_url": "https://music.apple.com/us/artist/meat-beat-manifesto/4321346",
                        "artist_id": "4321346"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Meat+Beat+Manifesto+Prime+Audio+Soup"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Meat+Beat+Manifesto+Prime+Audio+Soup"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Meat+Beat+Manifesto+Prime+Audio+Soup"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Meat+Beat+Manifesto+Prime+Audio+Soup"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Meat+Beat+Manifesto+Prime+Audio+Soup"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Meat+Beat+Manifesto+Prime+Audio+Soup"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/5KCxJigVaM0XlRC8TZeQl4",
                        "song_id": "5KCxJigVaM0XlRC8TZeQl4",
                        "song_isrc": "BEP010490374",
                        "album_url": "https://open.spotify.com/album/42qgi5UAy4WyKgVAe14Xjs",
                        "album_id": "42qgi5UAy4WyKgVAe14Xjs",
                        "artist_url": "https://open.spotify.com/artist/3AO9jmM1JTooPNcu9tTyZx",
                        "artist_id": "3AO9jmM1JTooPNcu9tTyZx"
                    }
                ],
                "appearance": {
                    "song_id": 1262,
                    "song_name": "Prime Audio Soup",
                    "song_album": "Actual Sounds + Voices",
                    "artist_id": "meat-beat-manifesto",
                    "artist_name": "Meat Beat Manifesto",
                    "date_created": "2005-07-08T17:17:50+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "The crew of the Nebuchadnezzar are seen plugging into the Matrix for the first time with Neo in preparation for their visit with The Oracle.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:19:39+00:00",
                    "confidence": "high",
                    "song_order": 5
                }
            },
            {
                "id": 21252,
                "name": "Bad Blood",
                "album": "The Matrix (The Original Motion Picture Soundtrack)",
                "date_updated": "2019-05-29T09:13:11+00:00",
                "tunefind_url": "https://www.tunefind.com/song/21252/0//bad-blood",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/21252",
                "artist": {
                    "id": "ministry",
                    "name": "Ministry",
                    "date_updated": "2019-06-15T06:22:01+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/ministry",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/ministry"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/bad-blood/643886158?i=643886623",
                        "song_id": "643886623",
                        "song_isrc": "USAE81375580"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/bad-blood/643886158?i=643886623",
                        "song_id": "643886623",
                        "album_url": "https://music.apple.com/us/album/bad-blood/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/ministry/609022",
                        "artist_id": "609022"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Ministry+Bad+Blood"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Ministry+Bad+Blood"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Ministry+Bad+Blood"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Ministry+Bad+Blood"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Ministry+Bad+Blood"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Ministry+Bad+Blood"
                    }
                ],
                "appearance": {
                    "song_id": 21252,
                    "song_name": "Bad Blood",
                    "song_album": "The Matrix (The Original Motion Picture Soundtrack)",
                    "artist_id": "ministry",
                    "artist_name": "Ministry",
                    "date_created": "2010-05-08T05:33:59+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2014-09-14T18:26:07+00:00",
                    "confidence": "high",
                    "song_order": 12
                }
            },
            {
                "id": 21255,
                "name": "Look To Your Orb for the Warning",
                "album": "The Matrix (The Original Motion Picture Soundtrack)",
                "date_updated": "2019-05-29T09:13:28+00:00",
                "tunefind_url": "https://www.tunefind.com/song/21255/0//look-to-your-orb-for-the-warning",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/21255",
                "artist": {
                    "id": "monster-magnet",
                    "name": "Monster Magnet",
                    "date_updated": "2019-06-14T07:12:15+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/monster-magnet",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/monster-magnet"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/look-to-your-orb-for-the-warning/643886158?i=643886645",
                        "song_id": "643886645",
                        "song_isrc": "USAE81375587"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/look-to-your-orb-for-the-warning/643886158?i=643886645",
                        "song_id": "643886645",
                        "album_url": "https://music.apple.com/us/album/look-to-your-orb-for-the-warning/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/monster-magnet/263368",
                        "artist_id": "263368"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Monster+Magnet+Look+To+Your+Orb+for+the+Warning"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Monster+Magnet+Look+To+Your+Orb+for+the+Warning"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Monster+Magnet+Look+To+Your+Orb+for+the+Warning"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Monster+Magnet+Look+To+Your+Orb+for+the+Warning"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Monster+Magnet+Look+To+Your+Orb+for+the+Warning"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Monster+Magnet+Look+To+Your+Orb+for+the+Warning"
                    }
                ],
                "appearance": {
                    "song_id": 21255,
                    "song_name": "Look To Your Orb for the Warning",
                    "song_album": "The Matrix (The Original Motion Picture Soundtrack)",
                    "artist_id": "monster-magnet",
                    "artist_name": "Monster Magnet",
                    "date_created": "2010-05-08T05:43:32+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2014-09-14T18:25:48+00:00",
                    "confidence": "high",
                    "song_order": 15
                }
            },
            {
                "id": 1265,
                "name": "Spybreak",
                "album": "The Matrix (The Original Motion Picture Soundtrack)",
                "date_updated": "2019-05-27T09:20:12+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1265/0//spybreak",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1265",
                "artist": {
                    "id": "propellerheads",
                    "name": "Propellerheads",
                    "date_updated": "2019-06-14T06:58:13+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/propellerheads",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/propellerheads"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/spybreak/643886158?i=643886620",
                        "song_id": "643886620",
                        "song_isrc": "USAE81375579",
                        "album_url": "https://music.apple.com/us/album/the-matrix-the-original-motion-picture-soundtrack/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/propellerheads/3444766",
                        "artist_id": "3444766"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/spybreak/643886158?i=643886620",
                        "song_id": "643886620",
                        "album_url": "https://music.apple.com/us/album/spybreak/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/propellerheads/3444766",
                        "artist_id": "3444766"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Propellerheads+Spybreak"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Propellerheads+Spybreak"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/1UeLrHe50rlORadjjnxL8q",
                        "song_id": "1UeLrHe50rlORadjjnxL8q",
                        "song_isrc": "US5940902083",
                        "album_url": "https://open.spotify.com/album/2ndfvfMJM3dJ8LffTpsCi5",
                        "album_id": "2ndfvfMJM3dJ8LffTpsCi5",
                        "artist_url": "https://open.spotify.com/artist/3Z7thZHrtFvqp8OpPffPKp",
                        "artist_id": "3Z7thZHrtFvqp8OpPffPKp"
                    }
                ],
                "appearance": {
                    "song_id": 1265,
                    "song_name": "Spybreak",
                    "song_album": "The Matrix (The Original Motion Picture Soundtrack)",
                    "artist_id": "propellerheads",
                    "artist_name": "Propellerheads",
                    "date_created": "2005-07-08T17:20:11+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "The big shootout in the lobby.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:20:20+00:00",
                    "confidence": "high",
                    "song_order": 9
                }
            },
            {
                "id": 76095,
                "name": "Spybreak! (Short One)",
                "album": "Spybreak! (Pink) - EP",
                "date_updated": "2019-06-05T09:26:06+00:00",
                "tunefind_url": "https://www.tunefind.com/song/76095/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/76095",
                "artist": {
                    "id": "propellerheads",
                    "name": "Propellerheads",
                    "date_updated": "2019-06-14T06:58:13+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/propellerheads",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/propellerheads"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/spybreak-short-one/1396741028?i=1396741481",
                        "song_id": "1396741481",
                        "song_isrc": "BEP011820006",
                        "album_url": "https://music.apple.com/us/album/spybreak-pink-ep/1396741028",
                        "album_id": "1396741028",
                        "artist_url": "https://music.apple.com/us/artist/propellerheads/3444766",
                        "artist_id": "3444766"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/spybreak-short-one/1396741028?i=1396741481",
                        "song_id": "1396741481",
                        "album_url": "https://music.apple.com/us/album/spybreak-short-one/1396741028",
                        "album_id": "1396741028",
                        "artist_url": "https://music.apple.com/us/artist/propellerheads/3444766",
                        "artist_id": "3444766"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak%21+%28Short+One%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Propellerheads+Spybreak%21+%28Short+One%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak%21+%28Short+One%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak%21+%28Short+One%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Propellerheads+Spybreak%21+%28Short+One%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Propellerheads+Spybreak%21+%28Short+One%29"
                    }
                ],
                "appearance": {
                    "song_id": 76095,
                    "song_name": "Spybreak! (Short One)",
                    "song_album": "Spybreak! (Pink) - EP",
                    "artist_id": "propellerheads",
                    "artist_name": "Propellerheads",
                    "date_created": "2015-01-20T03:32:04+00:00",
                    "date_updated": "2017-10-30T06:33:43+00:00",
                    "scene": "",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2015-01-20T03:32:26+00:00",
                    "confidence": "high",
                    "song_order": 17
                }
            },
            {
                "id": 1266,
                "name": "Wake Up",
                "album": "Rage Against the Machine",
                "date_updated": "2019-05-27T09:20:12+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1266/0//wake-up",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1266",
                "artist": {
                    "id": "rage-against-the-machine",
                    "name": "Rage Against the Machine",
                    "date_updated": "2019-06-16T06:13:56+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/rage-against-the-machine",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/rage-against-the-machine"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/wake-up/191450810?i=191451241",
                        "song_id": "191451241",
                        "song_isrc": "USSM19200665",
                        "album_url": "https://music.apple.com/us/album/rage-against-the-machine/191450810",
                        "album_id": "191450810",
                        "artist_url": "https://music.apple.com/us/artist/rage-against-the-machine/899409",
                        "artist_id": "899409"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/wake-up/191450810?i=191451241",
                        "song_id": "191451241",
                        "album_url": "https://music.apple.com/us/album/wake-up/191450810",
                        "album_id": "191450810",
                        "artist_url": "https://music.apple.com/us/artist/rage-against-the-machine/899409",
                        "artist_id": "899409"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Rage+Against+the+Machine+Wake+Up"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Rage+Against+the+Machine+Wake+Up"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Rage+Against+the+Machine+Wake+Up"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Rage+Against+the+Machine+Wake+Up"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Rage+Against+the+Machine+Wake+Up"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Rage+Against+the+Machine+Wake+Up"
                    }
                ],
                "appearance": {
                    "song_id": 1266,
                    "song_name": "Wake Up",
                    "song_album": "Rage Against the Machine",
                    "artist_id": "rage-against-the-machine",
                    "artist_name": "Rage Against the Machine",
                    "date_created": "2005-07-08T17:20:53+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "End Credits",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:20:40+00:00",
                    "confidence": "high",
                    "song_order": 10
                }
            },
            {
                "id": 21256,
                "name": "Du hast",
                "album": "The Matrix (The Original Motion Picture Soundtrack)",
                "date_updated": "2019-05-29T09:13:34+00:00",
                "tunefind_url": "https://www.tunefind.com/song/21256/0//du-hast",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/21256",
                "artist": {
                    "id": "rammstein",
                    "name": "Rammstein",
                    "date_updated": "2019-06-16T05:16:46+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/rammstein",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/rammstein"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/du-hast/643886158?i=643886648",
                        "song_id": "643886648",
                        "song_isrc": "USAE81375588"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/du-hast/643886158?i=643886648",
                        "song_id": "643886648",
                        "album_url": "https://music.apple.com/us/album/du-hast/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/rammstein/408932",
                        "artist_id": "408932"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Rammstein+Du+hast"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Rammstein+Du+hast"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Rammstein+Du+hast"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Rammstein+Du+hast"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Rammstein+Du+hast"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Rammstein+Du+hast"
                    }
                ],
                "appearance": {
                    "song_id": 21256,
                    "song_name": "Du hast",
                    "song_album": "The Matrix (The Original Motion Picture Soundtrack)",
                    "artist_id": "rammstein",
                    "artist_name": "Rammstein",
                    "date_created": "2010-05-08T05:44:18+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2014-09-14T18:25:32+00:00",
                    "confidence": "high",
                    "song_order": 16
                }
            },
            {
                "id": 102106,
                "name": "Clubbed to Death",
                "album": "Furious Angels",
                "date_updated": "2019-06-08T09:13:23+00:00",
                "tunefind_url": "https://www.tunefind.com/song/102106/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/102106",
                "artist": {
                    "id": "rob-dougan",
                    "name": "Rob Dougan",
                    "date_updated": "2019-06-14T09:09:54+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/rob-dougan",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/rob-dougan"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/clubbed-to-death/1857322?i=1857320",
                        "song_id": "1857320",
                        "song_isrc": "GBAQH9500703",
                        "album_url": "https://music.apple.com/us/album/furious-angels/1857322",
                        "album_id": "1857322",
                        "artist_url": "https://music.apple.com/us/artist/rob-dougan/1781918",
                        "artist_id": "1781918"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/clubbed-to-death/1857322?i=1857320",
                        "song_id": "1857320",
                        "album_url": "https://music.apple.com/us/album/clubbed-to-death/1857322",
                        "album_id": "1857322",
                        "artist_url": "https://music.apple.com/us/artist/rob-dougan/1781918",
                        "artist_id": "1781918"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Rob+Dougan+Clubbed+to+Death"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Rob+Dougan+Clubbed+to+Death"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Rob+Dougan+Clubbed+to+Death"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Rob+Dougan+Clubbed+to+Death"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Rob+Dougan+Clubbed+to+Death"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Rob+Dougan+Clubbed+to+Death"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/0vSVDF2fHaxL2L9eEmRdAK",
                        "song_id": "0vSVDF2fHaxL2L9eEmRdAK",
                        "song_isrc": "GBAQH9500703",
                        "album_url": "https://open.spotify.com/album/2aqLJYrn514iud3BpqbKVY",
                        "album_id": "2aqLJYrn514iud3BpqbKVY",
                        "artist_url": "https://open.spotify.com/artist/22xRIphSN7IkPVbErICu7s",
                        "artist_id": "22xRIphSN7IkPVbErICu7s"
                    }
                ],
                "appearance": {
                    "song_id": 102106,
                    "song_name": "Clubbed to Death",
                    "song_album": "Furious Angels",
                    "artist_id": "rob-dougan",
                    "artist_name": "Rob Dougan",
                    "date_created": "2005-07-08T17:18:24+00:00",
                    "date_updated": "2018-09-26T17:55:18+00:00",
                    "scene": "Morpheus takes Neo into the matrix for the first time, you see the woman in the red dress.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:19:49+00:00",
                    "confidence": "high",
                    "song_order": 6
                }
            },
            {
                "id": 38727,
                "name": "Dragula",
                "album": "Hellbilly Deluxe",
                "date_updated": "2019-05-31T10:42:37+00:00",
                "tunefind_url": "https://www.tunefind.com/song/38727/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/38727",
                "artist": {
                    "id": "rob-zombie",
                    "name": "Rob Zombie",
                    "date_updated": "2019-06-15T05:37:57+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/rob-zombie",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/rob-zombie"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/dragula/1440915746?i=1440915969",
                        "song_id": "1440915969",
                        "song_isrc": "USGF19821203"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/dragula/1440915746?i=1440915969",
                        "song_id": "1440915969",
                        "album_url": "https://music.apple.com/us/album/dragula/1440915746",
                        "album_id": "1440915746",
                        "artist_url": "https://music.apple.com/us/artist/rob-zombie/110374",
                        "artist_id": "110374"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Rob+Zombie+Dragula"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Rob+Zombie+Dragula"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Rob+Zombie+Dragula"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Rob+Zombie+Dragula"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Rob+Zombie+Dragula"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Rob+Zombie+Dragula"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/6Nm8h73ycDG2saCnZV8poF",
                        "song_id": "6Nm8h73ycDG2saCnZV8poF",
                        "song_isrc": "USGF19821203",
                        "album_url": "https://open.spotify.com/album/2B4lHoTCpWbxQPTZmCOjnH",
                        "album_id": "2B4lHoTCpWbxQPTZmCOjnH",
                        "artist_url": "https://open.spotify.com/artist/3HVdAiMNjYrQIKlOGxoGh5",
                        "artist_id": "3HVdAiMNjYrQIKlOGxoGh5"
                    }
                ],
                "appearance": {
                    "song_id": 38727,
                    "song_name": "Dragula",
                    "song_album": "Hellbilly Deluxe",
                    "artist_id": "rob-zombie",
                    "artist_name": "Rob Zombie",
                    "date_created": "2005-07-08T17:15:20+00:00",
                    "date_updated": "2018-09-26T17:55:17+00:00",
                    "scene": "Neo meets Trinity in the club.",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:19:12+00:00",
                    "confidence": "high",
                    "song_order": 2
                }
            },
            {
                "id": 1261,
                "name": "Mindfields",
                "album": "The Matrix (The Original Motion Picture Soundtrack)",
                "date_updated": "2019-05-27T09:20:12+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1261/0//mindfields",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1261",
                "artist": {
                    "id": "the-prodigy",
                    "name": "The Prodigy",
                    "date_updated": "2019-06-17T05:32:24+00:00",
                    "tunefind_url": "https://www.tunefind.com/artist/the-prodigy",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/the-prodigy"
                },
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/mindfields/643886158?i=643886637",
                        "song_id": "643886637",
                        "song_isrc": "USAE81375584",
                        "album_url": "https://music.apple.com/us/album/the-matrix-the-original-motion-picture-soundtrack/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/the-prodigy/1093102",
                        "artist_id": "1093102"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/mindfields/643886158?i=643886637",
                        "song_id": "643886637",
                        "album_url": "https://music.apple.com/us/album/mindfields/643886158",
                        "album_id": "643886158",
                        "artist_url": "https://music.apple.com/us/artist/the-prodigy/1093102",
                        "artist_id": "1093102"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=The+Prodigy+Mindfields"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=The+Prodigy+Mindfields"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=The+Prodigy+Mindfields"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=The+Prodigy+Mindfields"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=The+Prodigy+Mindfields"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=The+Prodigy+Mindfields"
                    }
                ],
                "appearance": {
                    "song_id": 1261,
                    "song_name": "Mindfields",
                    "song_album": "The Matrix (The Original Motion Picture Soundtrack)",
                    "artist_id": "the-prodigy",
                    "artist_name": "The Prodigy",
                    "date_created": "2005-07-08T17:17:04+00:00",
                    "date_updated": "2017-08-31T19:25:41+00:00",
                    "scene": "Club scene -- faded in from \"Dragula\" just as Trinity says \"My name is Trinity.\"",
                    "air_date": "1999-03-31T00:00:00+00:00",
                    "syndication_date": "2010-06-19T03:19:32+00:00",
                    "confidence": "high",
                    "song_order": 4
                }
            }
        ],
        "theme_song": null
    }
    

    Request Parameters

    Path Parameter Value
    id The unique id for the movie.

    By default, the id is expected to be a Tunefind id.
    External service id's can also be used by setting the id-type query parameter as required.
    Query Parameter Default Description
    id-type tunefind The type of the movie id. One of tunefind, tmdb.

    Returns

    Returns a movie object if a valid id was provided.

    Frequently Asked Questions

    List Movies

    Retrieve the list of all Tunefind movies. Movies are returned sorted by their names.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/movie?limit=5&offset=500"
      -u username:password
    

    Example Response

    {
        "movies": [
            {
                "id": "half-baked-1998",
                "name": "Half Baked (1998)",
                "tunefind_url": "https://www.tunefind.com/movie/half-baked-1998",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/half-baked-1998",
                "date_updated": "2017-08-31T19:25:27+00:00",
                "air_date": "1998-01-16T00:00:00+00:00"
            },
            {
                "id": "hall-pass",
                "name": "Hall Pass",
                "tunefind_url": "https://www.tunefind.com/movie/hall-pass",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/hall-pass",
                "date_updated": "2017-10-06T06:50:32+00:00",
                "air_date": "2011-02-15T00:00:00+00:00"
            },
            {
                "id": "hancock",
                "name": "Hancock",
                "tunefind_url": "https://www.tunefind.com/movie/hancock",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/hancock",
                "date_updated": "2018-05-17T18:33:28+00:00",
                "air_date": "2008-07-02T00:00:00+00:00"
            },
            {
                "id": "handsome-devil-2017",
                "name": "Handsome Devil (2017)",
                "tunefind_url": "https://www.tunefind.com/movie/handsome-devil-2017",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/handsome-devil-2017",
                "date_updated": "2018-05-24T07:51:02+00:00",
                "air_date": "2017-06-02T00:00:00+00:00"
            },
            {
                "id": "hangman-2017",
                "name": "Hangman (2017)",
                "tunefind_url": "https://www.tunefind.com/movie/hangman-2017",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/hangman-2017",
                "date_updated": "2018-02-07T18:32:24+00:00",
                "air_date": "2017-11-24T00:00:00+00:00"
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    date_updated null (optional) The minimum update date, in ISO 8601 format (e.g. 2018-06-05T10:31:26+00:00). If set, only returns the movies that were updated at or after this date.
    limit 1000 (optional) The number of movie objects to return.
    offset 0 (optional) The index of first movie to return. Indexes start from 0.

    Returns

    Returns an associative array with movies property that contains an array of simplified movie objects found.

    Search Movies By A Term

    Retrieve the list of Tunefind movies that match a keyword string.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/search/movie?q=matrix"
      -u username:password
    

    Example Response

    {
        "results": [
            {
                "id": "matrix",
                "name": "The Matrix",
                "tunefind_url": "https://www.tunefind.com/movie/matrix",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/matrix"
            },
            {
                "id": "the-matrix-revolutions-2003",
                "name": "The Matrix Revolutions (2003)",
                "tunefind_url": "https://www.tunefind.com/movie/the-matrix-revolutions-2003",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/the-matrix-revolutions-2003"
            },
            {
                "id": "the-matrix-reloaded-2003",
                "name": "The Matrix Reloaded (2003)",
                "tunefind_url": "https://www.tunefind.com/movie/the-matrix-reloaded-2003",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/the-matrix-reloaded-2003"
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    q null The search query keywords.
    limit 1000 (optional) The number of movie objects to return.
    offset 0 (optional) The index of first movie to return. Indexes start from 0.

    Returns

    Returns an associative array with results property that contains an array of simplified movie objects found.

    The Movie Object

    Attribute Type Description
    id string Unique identifier for the movie.
    name string The name of the movie.
    air_date date The date at which the movie was aired.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the movie.
    tunefind_api_url string The Tunefind API endpoint URL for the movie.
    songs an array of song objects The songs that appeared in the movie.
    theme_song a song object The theme song of the movie.
    appearance an appearance object The appearance information of the movie.

    (*) Relational attributes are automatically included in responses where applicable.

    (**) Appearance information is only included when the movie object is part of a song.

    The Movie Object (Simplified)

    Attribute Type Description
    id string Unique identifier for the movie.
    name string The name of the movie.
    air_date date The date at which the movie was aired.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the movie.
    tunefind_api_url string The Tunefind API endpoint URL for the movie.

    Artists

    Retrieve an Artist

    Retrieve Tunefind artist information for an artist identified by their unique id.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/artist/deftones"
      -u username:password
    

    Example Response

    {
        "id": "deftones",
        "name": "Deftones",
        "date_updated": "2019-06-17T06:51:41+00:00",
        "tunefind_url": "https://www.tunefind.com/artist/deftones",
        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/deftones",
        "songs": [
            {
                "id": 1052,
                "name": "Change (In the House of Flies)",
                "album": "Queen of the Damned (Music from the Motion Picture)",
                "date_updated": "2019-05-27T09:17:42+00:00",
                "tunefind_url": "https://www.tunefind.com/song/1052/0//change",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1052",
                "shows": [
                    {
                        "id": "alias",
                        "name": "Alias",
                        "date_updated": "2019-11-13T08:41:04+00:00",
                        "tunefind_url": "https://www.tunefind.com/show/alias",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/alias",
                        "appearance": {
                            "song_id": 1052,
                            "song_name": "Change (In the House of Flies)",
                            "song_album": "Queen of the Damned (Music from the Motion Picture)",
                            "artist_id": "deftones",
                            "artist_name": "Deftones",
                            "date_created": "2005-06-21T21:09:50+00:00",
                            "date_updated": "2017-11-19T06:31:51+00:00",
                            "scene": "Sloane's execution; Syd takes down an entire security detail.",
                            "air_date": "2004-04-18T00:00:00+00:00",
                            "syndication_date": "2009-12-11T18:12:15+00:00",
                            "confidence": "high",
                            "song_order": 1
                        }
                    }
                ],
                "episodes": [
                    {
                        "id": 350,
                        "name": "Hourglass",
                        "tunefind_url": "https://www.tunefind.com/show/alias/season-3/350",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/alias/season-3/350",
                        "date_updated": "2019-11-13T08:41:04+00:00",
                        "air_date": "2004-04-18T00:00:00+00:00",
                        "show_name": "Alias",
                        "show_id": "alias",
                        "season_name": "Season 3",
                        "season_number": 3,
                        "episode_number": 19,
                        "appearance": {
                            "song_id": 1052,
                            "song_name": "Change (In the House of Flies)",
                            "song_album": "Queen of the Damned (Music from the Motion Picture)",
                            "artist_id": "deftones",
                            "artist_name": "Deftones",
                            "date_created": "2005-06-21T21:09:50+00:00",
                            "date_updated": "2017-11-19T06:31:51+00:00",
                            "scene": "Sloane's execution; Syd takes down an entire security detail.",
                            "air_date": "2004-04-18T00:00:00+00:00",
                            "syndication_date": "2009-12-11T18:12:15+00:00",
                            "confidence": "high",
                            "song_order": 1
                        }
                    }
                ],
                "games": [],
                "movies": [],
                "stores": [
                    {
                        "id": "applemusic",
                        "name": "AppleMusic",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/change-in-the-house-of-flies/310535238?i=310535250",
                        "song_id": "310535250",
                        "song_isrc": "USMV20000039",
                        "album_url": "https://music.apple.com/us/album/queen-of-the-damned-music-from-the-motion-picture/310535238",
                        "album_id": "310535238",
                        "artist_url": "https://music.apple.com/us/artist/deftones/1092903",
                        "artist_id": "1092903"
                    },
                    {
                        "id": "itunes",
                        "name": "iTunes",
                        "country": "US",
                        "song_url": "https://music.apple.com/us/album/change-in-the-house-of-flies/310535238?i=310535250",
                        "song_id": "310535250",
                        "album_url": "https://music.apple.com/us/album/change-in-the-house-of-flies/310535238",
                        "album_id": "310535238",
                        "artist_url": "https://music.apple.com/us/artist/deftones/1092903",
                        "artist_id": "1092903"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Deftones+Change+%28In+the+House+of+Flies%29"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "US",
                        "song_url": "https://open.spotify.com/track/51c94ac31swyDQj9B3Lzs3",
                        "song_id": "51c94ac31swyDQj9B3Lzs3",
                        "song_isrc": "USMV20000039",
                        "album_url": "https://open.spotify.com/album/5LEXck3kfixFaA3CqVE7bC",
                        "album_id": "5LEXck3kfixFaA3CqVE7bC",
                        "artist_url": "https://open.spotify.com/artist/6Ghvu1VvMGScGpOUJBAHNH",
                        "artist_id": "6Ghvu1VvMGScGpOUJBAHNH"
                    }
                ]
            },
            {
                "id": 21253,
                "name": "My Own Summer (Shove It)",
                "album": "Music From And Inspired By The Motion Picture The Matrix",
                "date_updated": "2019-06-10T12:16:25+00:00",
                "tunefind_url": "https://www.tunefind.com/song/21253/0//my-own-summer-shove-it",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/21253",
                "shows": [],
                "episodes": [],
                "games": [],
                "movies": [
                    {
                        "id": "matrix",
                        "name": "The Matrix",
                        "tunefind_url": "https://www.tunefind.com/movie/matrix",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/matrix",
                        "date_updated": "2019-10-31T09:51:09+00:00",
                        "air_date": "1999-03-31T00:00:00+00:00",
                        "appearance": {
                            "song_id": 21253,
                            "song_name": "My Own Summer (Shove It)",
                            "song_album": "Music From And Inspired By The Motion Picture The Matrix",
                            "artist_id": "deftones",
                            "artist_name": "Deftones",
                            "date_created": "2010-05-08T05:37:39+00:00",
                            "date_updated": "2017-08-31T19:25:41+00:00",
                            "scene": "",
                            "air_date": "1999-03-31T00:00:00+00:00",
                            "syndication_date": "2014-09-14T18:25:56+00:00",
                            "confidence": "high",
                            "song_order": 13
                        }
                    }
                ],
                "stores": [
                    {
                        "id": "amazon",
                        "name": "Amazon.com",
                        "country": "US",
                        "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.ca",
                        "country": "CA",
                        "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.fr",
                        "country": "FR",
                        "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.de",
                        "country": "DE",
                        "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.co.uk",
                        "country": "UK",
                        "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "amazon",
                        "name": "Amazon.in",
                        "country": "IN",
                        "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Deftones+My+Own+Summer+%28Shove+It%29"
                    },
                    {
                        "id": "spotify",
                        "name": "Spotify",
                        "country": "",
                        "song_url": "https://open.spotify.com/track/6RksDZXySI6A9BQeJDFK2G",
                        "song_id": "6RksDZXySI6A9BQeJDFK2G",
                        "song_isrc": "USMV29700142",
                        "album_url": "https://open.spotify.com/album/5BofYSCt13mhMt4WkIJr7O",
                        "album_id": "5BofYSCt13mhMt4WkIJr7O",
                        "artist_url": "https://open.spotify.com/artist/6Ghvu1VvMGScGpOUJBAHNH",
                        "artist_id": "6Ghvu1VvMGScGpOUJBAHNH"
                    }
                ]
            }
        ]
    }
    

    Request Parameters

    Path Parameter Value
    id The unique id for the artist.

    By default, the id is expected to be a Tunefind id.
    External service id's can also be used by setting the id-type query parameter as required.
    Query Parameter Default Description
    id-type tunefind The type of the artist id. One of tunefind, itunes, spotify or applemusic.

    Returns

    Returns an artist object if a valid id was provided.

    Frequently Asked Questions

    List Artists

    Retrieve the list of all Tunefind artists. Artists are returned sorted by their names.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/artist?limit=5&offset=3200"
      -u username:password
    

    Example Response

    {
        "artists": [
            {
                "id": "barbra-streisand",
                "name": "Barbra Streisand",
                "date_updated": "2018-06-05T10:52:50+00:00",
                "tunefind_url": "https://www.tunefind.com/artist/barbra-streisand",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/barbra-streisand"
            },
            {
                "id": "barcelona",
                "name": "Barcelona",
                "date_updated": "2018-06-05T10:50:04+00:00",
                "tunefind_url": "https://www.tunefind.com/artist/barcelona",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/barcelona"
            },
            {
                "id": "barchet-quartet",
                "name": "Barchet Quartet",
                "date_updated": "2018-06-05T10:42:11+00:00",
                "tunefind_url": "https://www.tunefind.com/artist/barchet-quartet",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/barchet-quartet"
            },
            {
                "id": "barclay-black",
                "name": "Barclay Black",
                "date_updated": "2018-06-05T10:41:19+00:00",
                "tunefind_url": "https://www.tunefind.com/artist/barclay-black",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/barclay-black"
            },
            {
                "id": "bardi-and-noemi",
                "name": "Bardi and Noemi",
                "date_updated": "2018-06-05T10:31:26+00:00",
                "tunefind_url": "https://www.tunefind.com/artist/bardi-and-noemi",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/bardi-and-noemi"
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    itunes-uri null (optional) The Itunes URI of the artist. If set, only returns the artists that have matching Itunes URI's.
    spotify-uri null (optional) The Spotify URI of the artist. If set, only returns the artists that have matching Spotify URI's.
    date_updated null (optional) The minimum update date, in ISO 8601 format (e.g. 2018-06-05T10:31:26+00:00). If set, only returns the artists that were updated at or after this date.
    limit 1000 (optional) The number of artist objects to return.
    offset 0 (optional) The index of first artist to return. Indexes start from 0.

    Returns

    Returns an associative array with artists property that contains an array of simplified artist objects found.

    Search Artists By A Term

    Retrieve the list of Tunefind artists that match a keyword string.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/search/artist?q=abba&limit=10"
      -u username:password
    

    Example Response

    {
        "results": [
            {
                "id": "abba",
                "name": "ABBA",
                "tunefind_url": "https://www.tunefind.com/artist/abba",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/abba"
            },
            {
                "id": "abbas-premjee",
                "name": "Abbas Premjee",
                "tunefind_url": "https://www.tunefind.com/artist/abbas-premjee",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/abbas-premjee"
            },
            {
                "id": "monique-abbadie",
                "name": "Monique Abbadie",
                "tunefind_url": "https://www.tunefind.com/artist/monique-abbadie",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/monique-abbadie"
            },
            {
                "id": "amman-abbasi",
                "name": "Amman Abbasi",
                "tunefind_url": "https://www.tunefind.com/artist/amman-abbasi",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/amman-abbasi"
            },
            {
                "id": "claudio-abbado-vienna-philharmonic-orchestra",
                "name": "Claudio Abbado & Vienna Philharmonic Orchestra",
                "tunefind_url": "https://www.tunefind.com/artist/claudio-abbado-vienna-philharmonic-orchestra",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/claudio-abbado-vienna-philharmonic-orchestra"
            },
            {
                "id": "maurizio-pollini-claudio-abbado-berliner-philharmoniker",
                "name": "Maurizio Pollini, Claudio Abbado & Berliner Philharmoniker",
                "tunefind_url": "https://www.tunefind.com/artist/maurizio-pollini-claudio-abbado-berliner-philharmoniker",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/maurizio-pollini-claudio-abbado-berliner-philharmoniker"
            },
            {
                "id": "orchestra-mozart-claudio-abbado-lucas-macias-navarro",
                "name": "Orchestra Mozart, Claudio Abbado & Lucas Macias Navarro",
                "tunefind_url": "https://www.tunefind.com/artist/orchestra-mozart-claudio-abbado-lucas-macias-navarro",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/orchestra-mozart-claudio-abbado-lucas-macias-navarro"
            },
            {
                "id": "berliner-philharmoniker-claudio-abbado-kay-johannsen-schwedischer-rundfunkchor-maria-wieslander",
                "name": "Berliner Philharmoniker, Claudio Abbado, Kay Johannsen, Schwedischer Rundfunkchor & Maria Wieslander",
                "tunefind_url": "https://www.tunefind.com/artist/berliner-philharmoniker-claudio-abbado-kay-johannsen-schwedischer-rundfunkchor-maria-wieslander",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/berliner-philharmoniker-claudio-abbado-kay-johannsen-schwedischer-rundfunkchor-maria-wieslander"
            },
            {
                "id": "berliner-philharmoniker-claudio-abbado-kay-johannsen-schwedischer-rundfunkchor",
                "name": "Berliner Philharmoniker, Claudio Abbado, Kay Johannsen & Schwedischer Rundfunkchor",
                "tunefind_url": "https://www.tunefind.com/artist/berliner-philharmoniker-claudio-abbado-kay-johannsen-schwedischer-rundfunkchor",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/berliner-philharmoniker-claudio-abbado-kay-johannsen-schwedischer-rundfunkchor"
            },
            {
                "id": "berliner-philharmoniker-claudio-abbado",
                "name": "Berliner Philharmoniker & Claudio Abbado",
                "tunefind_url": "https://www.tunefind.com/artist/berliner-philharmoniker-claudio-abbado",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/berliner-philharmoniker-claudio-abbado"
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    q null The search query keywords.
    limit 1000 (optional) The number of artist objects to return.
    offset 0 (optional) The index of first artist to return. Indexes start from 0.

    Returns

    Returns an associative array with results property that contains an array of simplified artist objects found.

    The Artist Object

    Attribute Type Description
    id string Unique identifier for the artist.
    name string The name of the artist.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the artist.
    tunefind_api_url string The Tunefind API endpoint URL for the artist.
    songs an array of song objects The songs of the artist.

    (*) Relational attributes are automatically included in responses where applicable.

    The Artist Object (Simplified)

    Attribute Type Description
    id string Unique identifier for the artist.
    name string The name of the artist.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the artist.
    tunefind_api_url string The Tunefind API endpoint URL for the artist.

    Songs

    Retrieve a Song

    Retrieve Tunefind song information for a song identified by their unique id.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/song/1052"
      -u username:password
    

    Example Response

    {
        "id": 1052,
        "name": "Change (In the House of Flies)",
        "album": "Queen of the Damned (Music from the Motion Picture)",
        "date_updated": "2019-05-27T09:17:42+00:00",
        "tunefind_url": "https://www.tunefind.com/song/1052/0//change",
        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1052",
        "shows": [
            {
                "id": "alias",
                "name": "Alias",
                "date_updated": "2019-11-13T08:41:04+00:00",
                "tunefind_url": "https://www.tunefind.com/show/alias",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/alias",
                "appearance": {
                    "song_id": 1052,
                    "song_name": "Change (In the House of Flies)",
                    "song_album": "Queen of the Damned (Music from the Motion Picture)",
                    "artist_id": "deftones",
                    "artist_name": "Deftones",
                    "date_created": "2005-06-21T21:09:50+00:00",
                    "date_updated": "2017-11-19T06:31:51+00:00",
                    "scene": "Sloane's execution; Syd takes down an entire security detail.",
                    "air_date": "2004-04-18T00:00:00+00:00",
                    "syndication_date": "2009-12-11T18:12:15+00:00",
                    "confidence": "high",
                    "song_order": 1
                }
            }
        ],
        "episodes": [
            {
                "id": 350,
                "name": "Hourglass",
                "tunefind_url": "https://www.tunefind.com/show/alias/season-3/350",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/alias/season-3/350",
                "date_updated": "2019-11-13T08:41:04+00:00",
                "air_date": "2004-04-18T00:00:00+00:00",
                "show_name": "Alias",
                "show_id": "alias",
                "season_name": "Season 3",
                "season_number": 3,
                "episode_number": 19,
                "appearance": {
                    "song_id": 1052,
                    "song_name": "Change (In the House of Flies)",
                    "song_album": "Queen of the Damned (Music from the Motion Picture)",
                    "artist_id": "deftones",
                    "artist_name": "Deftones",
                    "date_created": "2005-06-21T21:09:50+00:00",
                    "date_updated": "2017-11-19T06:31:51+00:00",
                    "scene": "Sloane's execution; Syd takes down an entire security detail.",
                    "air_date": "2004-04-18T00:00:00+00:00",
                    "syndication_date": "2009-12-11T18:12:15+00:00",
                    "confidence": "high",
                    "song_order": 1
                }
            }
        ],
        "games": [],
        "movies": [],
        "artist": {
            "id": "deftones",
            "name": "Deftones",
            "date_updated": "2019-06-17T06:51:41+00:00",
            "tunefind_url": "https://www.tunefind.com/artist/deftones",
            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/deftones"
        },
        "stores": [
            {
                "id": "applemusic",
                "name": "AppleMusic",
                "country": "US",
                "song_url": "https://music.apple.com/us/album/change-in-the-house-of-flies/310535238?i=310535250",
                "song_id": "310535250",
                "song_isrc": "USMV20000039",
                "album_url": "https://music.apple.com/us/album/queen-of-the-damned-music-from-the-motion-picture/310535238",
                "album_id": "310535238",
                "artist_url": "https://music.apple.com/us/artist/deftones/1092903",
                "artist_id": "1092903"
            },
            {
                "id": "itunes",
                "name": "iTunes",
                "country": "US",
                "song_url": "https://music.apple.com/us/album/change-in-the-house-of-flies/310535238?i=310535250",
                "song_id": "310535250",
                "album_url": "https://music.apple.com/us/album/change-in-the-house-of-flies/310535238",
                "album_id": "310535238",
                "artist_url": "https://music.apple.com/us/artist/deftones/1092903",
                "artist_id": "1092903"
            },
            {
                "id": "amazon",
                "name": "Amazon.com",
                "country": "US",
                "search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
            },
            {
                "id": "amazon",
                "name": "Amazon.ca",
                "country": "CA",
                "search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
            },
            {
                "id": "amazon",
                "name": "Amazon.fr",
                "country": "FR",
                "search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
            },
            {
                "id": "amazon",
                "name": "Amazon.de",
                "country": "DE",
                "search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
            },
            {
                "id": "amazon",
                "name": "Amazon.co.uk",
                "country": "UK",
                "search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Deftones+Change+%28In+the+House+of+Flies%29"
            },
            {
                "id": "amazon",
                "name": "Amazon.in",
                "country": "IN",
                "search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Deftones+Change+%28In+the+House+of+Flies%29"
            },
            {
                "id": "spotify",
                "name": "Spotify",
                "country": "US",
                "song_url": "https://open.spotify.com/track/51c94ac31swyDQj9B3Lzs3",
                "song_id": "51c94ac31swyDQj9B3Lzs3",
                "song_isrc": "USMV20000039",
                "album_url": "https://open.spotify.com/album/5LEXck3kfixFaA3CqVE7bC",
                "album_id": "5LEXck3kfixFaA3CqVE7bC",
                "artist_url": "https://open.spotify.com/artist/6Ghvu1VvMGScGpOUJBAHNH",
                "artist_id": "6Ghvu1VvMGScGpOUJBAHNH"
            }
        ]
    }
    

    Request Parameters

    Path Parameter Value
    id The unique id for the song.

    By default, the id is expected to be a Tunefind id.
    External service id's can also be used by setting the id-type query parameter as required.
    Query Parameter Default Description
    id-type tunefind The type of the song id. One of tunefind, itunes, spotify or applemusic.

    Returns

    Returns a song object if a valid id was provided.

    Frequently Asked Questions

    List Songs

    Retrieve the list of all Tunefind songs. Songs are returned sorted by their names.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/song?limit=5&offset=1000"
      -u username:password
    

    Example Response

    {
        "songs": [
            {
                "id": 87661,
                "name": "Can't Feel My Face",
                "album": "Beauty Behind the Madness",
                "date_updated": "2019-06-07T08:56:55+00:00",
                "tunefind_url": "https://www.tunefind.com/song/87661/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/87661"
            },
            {
                "id": 95158,
                "name": "Can't Feel My Face (The Voice Performance)",
                "album": "The Complete Season 9 Collection (The Voice Performance)",
                "date_updated": "2019-06-07T12:36:28+00:00",
                "tunefind_url": "https://www.tunefind.com/song/95158/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/95158"
            },
            {
                "id": 43232,
                "name": "Can't Find My Shoes",
                "album": "",
                "date_updated": "2019-06-01T09:47:46+00:00",
                "tunefind_url": "https://www.tunefind.com/song/43232/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/43232"
            },
            {
                "id": 26901,
                "name": "Can't Find My Way Home",
                "album": "Season 3 (Music from the Showtime Series Californication)",
                "date_updated": "2019-05-30T07:43:51+00:00",
                "tunefind_url": "https://www.tunefind.com/song/26901/0//cant-find-my-way-home",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/26901"
            },
            {
                "id": 42346,
                "name": "Can't Get Enough",
                "album": "In Your Head",
                "date_updated": "2019-06-01T09:07:15+00:00",
                "tunefind_url": "https://www.tunefind.com/song/42346/0/",
                "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/42346"
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    isrc null (optional) The ISRC of the song. If set, only returns the songs that have matching ISRC's.
    itunes-uri null (optional) The Itunes URI of the song. If set, only returns the songs that have matching Itunes URI's.
    spotify-uri null (optional) The Spotify URI of the song. If set, only returns the songs that have matching Spotify URI's.
    date_updated null (optional) The minimum update date, in ISO 8601 format (e.g. 2018-06-05T10:31:26+00:00). If set, only returns the songs that were updated at or after this date.
    limit 1000 (optional) The number of song objects to return.
    offset 0 (optional) The index of first song to return. Indexes start from 0.

    Returns

    Returns an associative array with songs property that contains an array of simplified song objects found.

    The Song Object

    Attribute Type Description
    id string Unique identifier for the song.
    name string The name of the song.
    album string The album of the song.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the song.
    tunefind_api_url string The Tunefind API endpoint URL for the song.
    artist an artist object The artist that performed the song.
    shows an array of tv show objects The appearances of the song in tv shows.
    episodes an array of episode objects The appearances of the song in tv show episodes.
    movies an array of movie objects The appearances of the song in movies.
    games an array of game objects The appearances of the song in games.
    stores an array of store objects External store informations for the song.
    appearance an appearance object The appearance information of the song.

    (*) Relational attributes are automatically included in responses where applicable.

    (**) Appearance information is only included when the song object is part of a movie, tv show, episode or game.

    The Song Object (Simplified)

    Attribute Type Description
    id string Unique identifier for the song.
    name string The name of the song.
    album string The album of the song.
    date_updated date The date at which the object was updated.
    tunefind_url string The Tunefind URL for the song.
    tunefind_api_url string The Tunefind API endpoint URL for the song.

    The Store Object

    Attribute Type Description
    id string The id of store; one of amazon, applemusic, itunes and spotify.
    name string The name of the store.
    country string The country for which the store is available in.
    song_url string The URL for the song in this store.
    song_id string The id for the song in this store.
    song_isrc string The ISRC for the song in this store (if available).
    album_url string The URL for the song's album in this store.
    album_id string The id for the song's album in this store.
    artist_url string The URL for the song's artist in this store.
    artist_id string The id for the song's artist in this store.
    search_url string The URL to search for the song in this store.

    (*) search_url is provided for the stores at which an external id or URL information is not available.

    Appearances

    List Appearances

    Retrieve the list of Tunefind appearances. Appearances are returned sorted by their air date in a descending order.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/appearance"
      -u username:password
    

    Example Response

    {
        "appearances": [
            {
                "song_id": 126780,
                "song_name": "Feel It Still",
                "song_album": "Woodstock",
                "artist_id": "portugal-the-man",
                "artist_name": "Portugal the Man",
                "date_created": "2019-11-11T05:35:36+00:00",
                "date_updated": "2019-11-11T05:35:36+00:00",
                "scene": "Trailer",
                "air_date": "2019-11-15T00:00:00+00:00",
                "syndication_date": "2019-11-11T05:35:36+00:00",
                "confidence": "high",
                "song_order": 1
            },
            {
                "song_id": 236270,
                "song_name": "Stigmata",
                "song_album": "a modern tragedy, vol. 2 - EP",
                "artist_id": "grandson",
                "artist_name": "grandson",
                "date_created": "2019-11-11T01:02:28+00:00",
                "date_updated": "2019-11-11T01:08:25+00:00",
                "scene": "Prosecutor Angus Napier talks on the talk when he's attacked by the Executioner and killed.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T01:02:28+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 237986,
                "song_name": "Fire It Up",
                "song_album": "",
                "artist_id": "ruelle",
                "artist_name": "Ruelle",
                "date_created": "2019-11-11T02:00:21+00:00",
                "date_updated": "2019-11-11T02:34:13+00:00",
                "scene": "Batwoman goes to a warehouse which stores hydrogen cyanide then questions a security guard about any unusual activity.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T02:00:21+00:00",
                "confidence": "medium",
                "song_order": 2
            },
            {
                "song_id": 147279,
                "song_name": "From the Ashes",
                "song_album": "",
                "artist_id": "valerie-broussard",
                "artist_name": "Valerie Broussard",
                "date_created": "2019-11-11T01:58:25+00:00",
                "date_updated": "2019-11-11T02:35:11+00:00",
                "scene": "Kate finds the strength to forgive her father, Jacob then promises that they'll find Beth; Sophie stops from telling Jacob the truth about Batwoman and Kate once she sees Kate and Jacob together.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T01:58:25+00:00",
                "confidence": "medium",
                "song_order": 3
            },
            {
                "song_id": 146706,
                "song_name": "Ironic",
                "song_album": "1996",
                "artist_id": "alanis-morissette",
                "artist_name": "Alanis Morissette",
                "date_created": "2019-11-11T03:23:19+00:00",
                "date_updated": "2019-11-11T03:24:41+00:00",
                "scene": "(Performed by CAST) Lois' suitors singing together",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T03:23:20+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 168001,
                "song_name": "A Single Minute",
                "song_album": "Indie Dreampop",
                "artist_id": "wolfgang-black",
                "artist_name": "Wolfgang Black",
                "date_created": "2019-11-11T02:28:53+00:00",
                "date_updated": "2019-11-11T03:00:18+00:00",
                "scene": "Andrea broods over her situation with Lena when Russell Rogers chats her up.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T02:28:53+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 168001,
                "song_name": "A Single Minute",
                "song_album": "Indie Dreampop",
                "artist_id": "wolfgang-black",
                "artist_name": "Wolfgang Black",
                "date_created": "2019-11-11T02:28:53+00:00",
                "date_updated": "2019-11-11T03:00:18+00:00",
                "scene": "Andrea broods over her situation with Lena when Russell Rogers chats her up.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T02:28:53+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 237989,
                "song_name": "Symphony No. 7 in A, Op. 92: II. Allegretto",
                "song_album": "Rafael Kubelik - Rare Recordings 1963-1974",
                "artist_id": "bavarian-radio-symphony-orchestra",
                "artist_name": "Bavarian Radio Symphony Orchestra",
                "date_created": "2019-11-11T03:08:00+00:00",
                "date_updated": "2019-11-11T03:10:40+00:00",
                "scene": "Adrian makes Phillips fly one of Crookshanks' clones in the air while making a vow to escape one day.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T03:08:00+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 14200,
                "song_name": "You're My Thrill",
                "song_album": "Watchmen (Music from the Motion Picture)",
                "artist_id": "billie-holiday",
                "artist_name": "Billie Holiday",
                "date_created": "2019-11-11T02:53:49+00:00",
                "date_updated": "2019-11-11T02:53:49+00:00",
                "scene": "Laurie and Angela have a conversation about vigilantism. Petey explains Laurie's origins to Angela.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T02:53:49+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 109954,
                "song_name": "Islands in the Stream",
                "song_album": "Ultimate Dolly Parton",
                "artist_id": "dolly-parton",
                "artist_name": "Dolly Parton",
                "date_created": "2019-11-11T02:04:57+00:00",
                "date_updated": "2019-11-11T02:04:57+00:00",
                "scene": "The opening features the Clarks.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T02:04:57+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 25698,
                "song_name": "Time Is On My Side",
                "song_album": "Live! - Simply the Best",
                "artist_id": "irma-thomas",
                "artist_name": "Irma Thomas",
                "date_created": "2019-11-11T03:31:41+00:00",
                "date_updated": "2019-11-11T03:31:41+00:00",
                "scene": "",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T03:31:41+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 109954,
                "song_name": "Islands in the Stream",
                "song_album": "Ultimate Dolly Parton",
                "artist_id": "dolly-parton",
                "artist_name": "Dolly Parton",
                "date_created": "2019-11-11T02:04:57+00:00",
                "date_updated": "2019-11-11T02:04:57+00:00",
                "scene": "The opening features the Clarks.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T02:04:57+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 237988,
                "song_name": "Do Your Thing",
                "song_album": "",
                "artist_id": "leroy-sibbles",
                "artist_name": "Leroy Sibbles",
                "date_created": "2019-11-11T03:05:20+00:00",
                "date_updated": "2019-11-11T03:10:51+00:00",
                "scene": "Adrian creates another version of Phillips and Crookshanks.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T03:05:20+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 237989,
                "song_name": "Symphony No. 7 in A, Op. 92: II. Allegretto",
                "song_album": "Rafael Kubelik - Rare Recordings 1963-1974",
                "artist_id": "bavarian-radio-symphony-orchestra",
                "artist_name": "Bavarian Radio Symphony Orchestra",
                "date_created": "2019-11-11T03:08:00+00:00",
                "date_updated": "2019-11-11T03:10:40+00:00",
                "scene": "Adrian makes Phillips fly one of Crookshanks' clones in the air while making a vow to escape one day.",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T03:08:00+00:00",
                "confidence": "medium",
                "song_order": 1
            },
            {
                "song_id": 237984,
                "song_name": "Eyes on You",
                "song_album": "Eyes on You - Single",
                "artist_id": "3-one-oh",
                "artist_name": "3 One Oh",
                "date_created": "2019-11-11T00:01:48+00:00",
                "date_updated": "2019-11-11T01:51:47+00:00",
                "scene": "Debbie dressing up sexy once Franny's off with V",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T00:01:48+00:00",
                "confidence": "medium",
                "song_order": 13
            },
            {
                "song_id": 76667,
                "song_name": "School's Out",
                "song_album": "School's Out",
                "artist_id": "alice-cooper",
                "artist_name": "Alice Cooper",
                "date_created": "2019-11-11T00:00:48+00:00",
                "date_updated": "2019-11-11T01:50:11+00:00",
                "scene": "\"Daddy Night\" at the gay strip joint",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T00:00:49+00:00",
                "confidence": "medium",
                "song_order": 11
            },
            {
                "song_id": 93192,
                "song_name": "Reveille",
                "song_album": "Soundtrack America. Patriotic, Inspirational and Sentimental Classics for the Ages.",
                "artist_id": "traditional-bugle-call",
                "artist_name": "Traditional Bugle Call",
                "date_created": "2019-11-11T01:47:47+00:00",
                "date_updated": "2019-11-11T01:48:51+00:00",
                "scene": "Carl's ringtone (Lip calling)",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T01:47:47+00:00",
                "confidence": "medium",
                "song_order": 14
            },
            {
                "song_id": 237985,
                "song_name": "Time to Time",
                "song_album": "Lies & Lightning - EP",
                "artist_id": "truett",
                "artist_name": "TRUETT",
                "date_created": "2019-11-11T00:02:23+00:00",
                "date_updated": "2019-11-11T01:56:24+00:00",
                "scene": "Lip with his baby, family comes in",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T00:02:23+00:00",
                "confidence": "medium",
                "song_order": 15
            },
            {
                "song_id": 139046,
                "song_name": "Low Rider",
                "song_album": "The Hits",
                "artist_id": "war",
                "artist_name": "War",
                "date_created": "2019-11-11T00:01:13+00:00",
                "date_updated": "2019-11-11T01:50:00+00:00",
                "scene": "\"Captain Crunch\" onstage",
                "air_date": "2019-11-10T00:00:00+00:00",
                "syndication_date": "2019-11-11T00:01:13+00:00",
                "confidence": "medium",
                "song_order": 12
            },
            {
                "song_id": 97313,
                "song_name": "Bad Dream",
                "song_album": "Madness",
                "artist_id": "ruelle",
                "artist_name": "Ruelle",
                "date_created": "2019-11-13T21:02:28+00:00",
                "date_updated": "2019-11-13T21:02:28+00:00",
                "scene": "",
                "air_date": "2019-09-10T00:00:00+00:00",
                "syndication_date": "2019-11-13T21:02:28+00:00",
                "confidence": "high",
                "song_order": 1
            }
        ]
    }
    

    Request Parameters

    Query Parameter Default Description
    date_created null (optional) The minimum creation date, in ISO 8601 format (e.g. 2018-06-05T10:31:26+00:00). If set, only returns the appearances that were created at or after this date.

    Returns

    Returns an associative array with appearances property that contains an array of appearance objects found.

    The Appearance Object

    Attribute Type Description
    song_id string Unique identifier for the song in the appearance.
    song_name string The name of the song in the appearance.
    song_album string The album of the song in the appearance.
    artist_id string Unique identifier for the artist in the appearance.
    artist_name string The name of the artist in the appearance.
    date_created date The date at which the object was created.
    date_updated date The date at which the object was updated.
    scene string The scene at which the Song appeared.
    air_date string The appearance date of the movie, tv show, episode or game.
    syndication_date string The syndication date of the movie, tv show, episode or game.
    confidence string A score indicating Tunefind confidence that the song appeared in that movie, tv show, episode or game.
    song_order string The order of appearance in that movie, tv show, episode or game.

    Trending Songs

    Retrieve the list of trending songs on Tunefind.

    HTTP Request

    Example Request

    curl "https://[ENDPOINT].api.tunefind.com/api/v2/trending/song/now"
      -u username:password
    

    Example Response

    {
        "songs": [
            {
                "rank": 1,
                "trend": "up",
                "song": {
                    "id": 236829,
                    "name": "Creep",
                    "album": "The Morning Show: Season 1 (Apple TV+ Original Series Soundtrack)",
                    "date_updated": "2019-11-25T13:26:02+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/236829/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/236829",
                    "artist": {
                        "id": "rozzi",
                        "name": "Rozzi",
                        "date_updated": "2019-11-25T13:26:02+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/rozzi",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/rozzi"
                    },
                    "shows": [
                        {
                            "id": "the-morning-show",
                            "name": "The Morning Show",
                            "date_updated": "2019-11-29T08:56:42+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/the-morning-show",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-morning-show",
                            "appearance": {
                                "song_id": 236829,
                                "song_name": "Creep",
                                "song_album": "The Morning Show: Season 1 (Apple TV+ Original Series Soundtrack)",
                                "artist_id": "rozzi",
                                "artist_name": "Rozzi",
                                "date_created": "2019-11-03T06:10:48+00:00",
                                "date_updated": "2019-11-25T13:26:02+00:00",
                                "scene": "Bradley meets Cory at the restaurant. Also at the end credits of the episode 2.",
                                "air_date": "2019-11-01T00:00:00+00:00",
                                "syndication_date": "2019-11-06T00:28:49+00:00",
                                "confidence": "medium",
                                "song_order": 2
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 92467,
                            "name": "A Seat at the Table",
                            "tunefind_url": "https://www.tunefind.com/show/the-morning-show/season-1/92467",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-morning-show/season-1/92467",
                            "date_updated": "2019-11-29T08:56:42+00:00",
                            "air_date": "2019-11-01T00:00:00+00:00",
                            "show_name": "The Morning Show",
                            "show_id": "the-morning-show",
                            "season_name": "Season 1",
                            "season_number": 1,
                            "episode_number": 2,
                            "appearance": {
                                "song_id": 236829,
                                "song_name": "Creep",
                                "song_album": "The Morning Show: Season 1 (Apple TV+ Original Series Soundtrack)",
                                "artist_id": "rozzi",
                                "artist_name": "Rozzi",
                                "date_created": "2019-11-03T06:10:48+00:00",
                                "date_updated": "2019-11-25T13:26:02+00:00",
                                "scene": "Bradley meets Cory at the restaurant. Also at the end credits of the episode 2.",
                                "air_date": "2019-11-01T00:00:00+00:00",
                                "syndication_date": "2019-11-06T00:28:49+00:00",
                                "confidence": "medium",
                                "song_order": 2
                            }
                        }
                    ],
                    "games": [],
                    "movies": []
                }
            },
            {
                "rank": 2,
                "trend": "new",
                "song": {
                    "id": 237992,
                    "name": "Comin' Thru",
                    "album": "Fish Outta Water",
                    "date_updated": "2019-12-02T05:00:03+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/237992/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/237992",
                    "artist": {
                        "id": "chali-2na",
                        "name": "Chali 2na",
                        "date_updated": "2019-12-02T05:00:03+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/chali-2na",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/chali-2na"
                    },
                    "shows": [
                        {
                            "id": "silicon-valley",
                            "name": "Silicon Valley",
                            "date_updated": "2019-12-02T06:12:36+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/silicon-valley",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/silicon-valley",
                            "appearance": {
                                "song_id": 237992,
                                "song_name": "Comin' Thru",
                                "song_album": "Fish Outta Water",
                                "artist_id": "chali-2na",
                                "artist_name": "Chali 2na",
                                "date_created": "2019-11-11T10:48:55+00:00",
                                "date_updated": "2019-11-11T19:48:07+00:00",
                                "scene": "Monica and Richard take in Gavin’s trashed office. Richard prepares to face Gavin’s employees. End credits.",
                                "air_date": "2019-11-10T00:00:00+00:00",
                                "syndication_date": "2019-11-11T19:48:07+00:00",
                                "confidence": "high",
                                "song_order": 2
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 92825,
                            "name": "Hooli Smokes!",
                            "tunefind_url": "https://www.tunefind.com/show/silicon-valley/season-6/92825",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/silicon-valley/season-6/92825",
                            "date_updated": "2019-12-02T06:12:36+00:00",
                            "air_date": "2019-11-10T00:00:00+00:00",
                            "show_name": "Silicon Valley",
                            "show_id": "silicon-valley",
                            "season_name": "Season 6",
                            "season_number": 6,
                            "episode_number": 3,
                            "appearance": {
                                "song_id": 237992,
                                "song_name": "Comin' Thru",
                                "song_album": "Fish Outta Water",
                                "artist_id": "chali-2na",
                                "artist_name": "Chali 2na",
                                "date_created": "2019-11-11T10:48:55+00:00",
                                "date_updated": "2019-11-11T19:48:07+00:00",
                                "scene": "Monica and Richard take in Gavin’s trashed office. Richard prepares to face Gavin’s employees. End credits.",
                                "air_date": "2019-11-10T00:00:00+00:00",
                                "syndication_date": "2019-11-11T19:48:07+00:00",
                                "confidence": "high",
                                "song_order": 2
                            }
                        }
                    ],
                    "games": [],
                    "movies": []
                }
            },
            {
                "rank": 3,
                "trend": "new",
                "song": {
                    "id": 237989,
                    "name": "Symphony No. 7 in A, Op. 92: II. Allegretto",
                    "album": "Rafael Kubelik - Rare Recordings 1963-1974",
                    "date_updated": "2019-12-01T07:11:00+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/237989/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/237989",
                    "artist": {
                        "id": "bavarian-radio-symphony-orchestra",
                        "name": "Bavarian Radio Symphony Orchestra",
                        "date_updated": "2019-12-01T07:11:00+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/bavarian-radio-symphony-orchestra",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/bavarian-radio-symphony-orchestra"
                    },
                    "shows": [
                        {
                            "id": "watchmen",
                            "name": "Watchmen",
                            "date_updated": "2019-12-02T15:59:47+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/watchmen",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/watchmen",
                            "appearance": {
                                "song_id": 237989,
                                "song_name": "Symphony No. 7 in A, Op. 92: II. Allegretto",
                                "song_album": "Rafael Kubelik - Rare Recordings 1963-1974",
                                "artist_id": "bavarian-radio-symphony-orchestra",
                                "artist_name": "Bavarian Radio Symphony Orchestra",
                                "date_created": "2019-11-11T03:08:00+00:00",
                                "date_updated": "2019-11-11T13:29:40+00:00",
                                "scene": "Adrian makes Phillips fly one of Crookshanks' clones in the air while making a vow to escape one day.",
                                "air_date": "2019-11-10T00:00:00+00:00",
                                "syndication_date": "2019-11-11T03:08:00+00:00",
                                "confidence": "high",
                                "song_order": 5
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 92836,
                            "name": "If You Don't Like My Story, Write Your Own",
                            "tunefind_url": "https://www.tunefind.com/show/watchmen/season-1/92836",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/watchmen/season-1/92836",
                            "date_updated": "2019-12-02T15:59:47+00:00",
                            "air_date": "2019-11-10T00:00:00+00:00",
                            "show_name": "Watchmen",
                            "show_id": "watchmen",
                            "season_name": "Season 1",
                            "season_number": 1,
                            "episode_number": 4,
                            "appearance": {
                                "song_id": 237989,
                                "song_name": "Symphony No. 7 in A, Op. 92: II. Allegretto",
                                "song_album": "Rafael Kubelik - Rare Recordings 1963-1974",
                                "artist_id": "bavarian-radio-symphony-orchestra",
                                "artist_name": "Bavarian Radio Symphony Orchestra",
                                "date_created": "2019-11-11T03:08:00+00:00",
                                "date_updated": "2019-11-11T13:29:40+00:00",
                                "scene": "Adrian makes Phillips fly one of Crookshanks' clones in the air while making a vow to escape one day.",
                                "air_date": "2019-11-10T00:00:00+00:00",
                                "syndication_date": "2019-11-11T03:08:00+00:00",
                                "confidence": "high",
                                "song_order": 5
                            }
                        }
                    ],
                    "games": [],
                    "movies": []
                }
            },
            {
                "rank": 4,
                "trend": "down",
                "song": {
                    "id": 237768,
                    "name": "First Christmas (That I Loved You) [From the Netflix Film Let It Snow]",
                    "album": "First Christmas (That I Loved You) [From the Netflix Film Let It Snow]",
                    "date_updated": "2019-11-29T05:00:04+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/237768/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/237768",
                    "artist": {
                        "id": "shameik-moore",
                        "name": "Shameik Moore",
                        "date_updated": "2019-11-29T05:00:04+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/shameik-moore",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/shameik-moore"
                    },
                    "shows": [],
                    "episodes": [],
                    "games": [],
                    "movies": [
                        {
                            "id": "let-it-snow-2019",
                            "name": "Let It Snow",
                            "tunefind_url": "https://www.tunefind.com/movie/let-it-snow-2019",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/let-it-snow-2019",
                            "date_updated": "2019-11-30T04:50:25+00:00",
                            "air_date": "2019-11-08T00:00:00+00:00",
                            "appearance": {
                                "song_id": 237768,
                                "song_name": "First Christmas (That I Loved You) [From the Netflix Film Let It Snow]",
                                "song_album": "First Christmas (That I Loved You) [From the Netflix Film Let It Snow]",
                                "artist_id": "shameik-moore",
                                "artist_name": "Shameik Moore",
                                "date_created": "2019-11-08T17:06:59+00:00",
                                "date_updated": "2019-11-21T19:47:26+00:00",
                                "scene": "At the beginning with the snow talk. Stuart and Julie kiss in the Waffle Town.",
                                "air_date": "2019-11-08T00:00:00+00:00",
                                "syndication_date": "2019-11-08T23:09:43+00:00",
                                "confidence": "high",
                                "song_order": 2
                            }
                        }
                    ]
                }
            },
            {
                "rank": 5,
                "trend": "up",
                "song": {
                    "id": 236661,
                    "name": "Beating Hearts",
                    "album": "Beating Hearts",
                    "date_updated": "2019-11-22T05:00:10+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/236661/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/236661",
                    "artist": {
                        "id": "paige",
                        "name": "Paige",
                        "date_updated": "2019-12-02T12:00:16+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/paige",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/paige"
                    },
                    "shows": [
                        {
                            "id": "atypical",
                            "name": "Atypical",
                            "date_updated": "2019-11-28T23:33:11+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/atypical",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/atypical",
                            "appearance": {
                                "song_id": 236661,
                                "song_name": "Beating Hearts",
                                "song_album": "Beating Hearts",
                                "artist_id": "paige",
                                "artist_name": "Paige",
                                "date_created": "2019-11-01T20:50:49+00:00",
                                "date_updated": "2019-11-06T04:56:00+00:00",
                                "scene": "Casey and Izzie kiss",
                                "air_date": "2019-11-01T00:00:00+00:00",
                                "syndication_date": "2019-11-06T04:56:00+00:00",
                                "confidence": "high",
                                "song_order": 3
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 92510,
                            "name": "Shrinkage",
                            "tunefind_url": "https://www.tunefind.com/show/atypical/season-3/92510",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/atypical/season-3/92510",
                            "date_updated": "2019-11-28T23:33:11+00:00",
                            "air_date": "2019-11-01T00:00:00+00:00",
                            "show_name": "Atypical",
                            "show_id": "atypical",
                            "season_name": "Season 3",
                            "season_number": 3,
                            "episode_number": 7,
                            "appearance": {
                                "song_id": 236661,
                                "song_name": "Beating Hearts",
                                "song_album": "Beating Hearts",
                                "artist_id": "paige",
                                "artist_name": "Paige",
                                "date_created": "2019-11-01T20:50:49+00:00",
                                "date_updated": "2019-11-06T04:56:00+00:00",
                                "scene": "Casey and Izzie kiss",
                                "air_date": "2019-11-01T00:00:00+00:00",
                                "syndication_date": "2019-11-06T04:56:00+00:00",
                                "confidence": "high",
                                "song_order": 3
                            }
                        }
                    ],
                    "games": [],
                    "movies": []
                }
            },
            {
                "rank": 6,
                "trend": "down",
                "song": {
                    "id": 72914,
                    "name": "Then You Can Tell Me Goodbye",
                    "album": "Bettye Swann",
                    "date_updated": "2019-11-12T07:00:42+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/72914/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/72914",
                    "artist": {
                        "id": "bettye-swann",
                        "name": "Bettye Swann",
                        "date_updated": "2019-11-12T16:16:34+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/bettye-swann",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/bettye-swann"
                    },
                    "shows": [
                        {
                            "id": "transparent",
                            "name": "Transparent",
                            "date_updated": "2019-11-27T18:24:41+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/transparent",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/transparent",
                            "appearance": {
                                "song_id": 72914,
                                "song_name": "Then You Can Tell Me Goodbye",
                                "song_album": "Bettye Swann",
                                "artist_id": "bettye-swann",
                                "artist_name": "Bettye Swann",
                                "date_created": "2014-10-28T23:43:17+00:00",
                                "date_updated": "2017-10-30T18:41:13+00:00",
                                "scene": "Ali & Josh hangout at Ali's apartment when when  Ali makes Josh dance with her; End Credits.",
                                "air_date": "2014-09-26T00:00:00+00:00",
                                "syndication_date": "2015-01-10T15:12:01+00:00",
                                "confidence": "high",
                                "song_order": 2
                            }
                        },
                        {
                            "id": "the-end-of-the-f-king-world",
                            "name": "The End of the Fucking World",
                            "date_updated": "2019-12-02T06:22:25+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/the-end-of-the-f-king-world",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-end-of-the-f-king-world",
                            "appearance": {
                                "song_id": 72914,
                                "song_name": "Then You Can Tell Me Goodbye",
                                "song_album": "Bettye Swann",
                                "artist_id": "bettye-swann",
                                "artist_name": "Bettye Swann",
                                "date_created": "2019-11-05T21:25:47+00:00",
                                "date_updated": "2019-11-05T23:16:44+00:00",
                                "scene": "(0:18) Alyssa & James hold hands. End credits.",
                                "air_date": "2019-11-04T00:00:00+00:00",
                                "syndication_date": "2019-11-05T23:16:44+00:00",
                                "confidence": "high",
                                "song_order": 8
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 20108,
                            "name": "Moppa",
                            "tunefind_url": "https://www.tunefind.com/show/transparent/season-1/20108",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/transparent/season-1/20108",
                            "date_updated": "2019-11-27T18:24:41+00:00",
                            "air_date": "2014-09-26T00:00:00+00:00",
                            "show_name": "Transparent",
                            "show_id": "transparent",
                            "season_name": "Season 1",
                            "season_number": 1,
                            "episode_number": 4,
                            "appearance": {
                                "song_id": 72914,
                                "song_name": "Then You Can Tell Me Goodbye",
                                "song_album": "Bettye Swann",
                                "artist_id": "bettye-swann",
                                "artist_name": "Bettye Swann",
                                "date_created": "2014-10-28T23:43:17+00:00",
                                "date_updated": "2017-10-30T18:41:13+00:00",
                                "scene": "Ali & Josh hangout at Ali's apartment when when  Ali makes Josh dance with her; End Credits.",
                                "air_date": "2014-09-26T00:00:00+00:00",
                                "syndication_date": "2015-01-10T15:12:01+00:00",
                                "confidence": "high",
                                "song_order": 2
                            }
                        },
                        {
                            "id": 92787,
                            "name": "Episode 8",
                            "tunefind_url": "https://www.tunefind.com/show/the-end-of-the-f-king-world/season-2/92787",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-end-of-the-f-king-world/season-2/92787",
                            "date_updated": "2019-12-02T06:22:25+00:00",
                            "air_date": "2019-11-04T00:00:00+00:00",
                            "show_name": "The End of the Fucking World",
                            "show_id": "the-end-of-the-f-king-world",
                            "season_name": "Season 2",
                            "season_number": 2,
                            "episode_number": 8,
                            "appearance": {
                                "song_id": 72914,
                                "song_name": "Then You Can Tell Me Goodbye",
                                "song_album": "Bettye Swann",
                                "artist_id": "bettye-swann",
                                "artist_name": "Bettye Swann",
                                "date_created": "2019-11-05T21:25:47+00:00",
                                "date_updated": "2019-11-05T23:16:44+00:00",
                                "scene": "(0:18) Alyssa & James hold hands. End credits.",
                                "air_date": "2019-11-04T00:00:00+00:00",
                                "syndication_date": "2019-11-05T23:16:44+00:00",
                                "confidence": "high",
                                "song_order": 8
                            }
                        }
                    ],
                    "games": [],
                    "movies": []
                }
            },
            {
                "rank": 7,
                "trend": "down",
                "song": {
                    "id": 236662,
                    "name": "Yoko Ono",
                    "album": "Our First EP",
                    "date_updated": "2019-11-28T23:33:11+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/236662/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/236662",
                    "artist": {
                        "id": "moby-rich",
                        "name": "Moby Rich",
                        "date_updated": "2019-11-28T23:33:11+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/moby-rich",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/moby-rich"
                    },
                    "shows": [
                        {
                            "id": "atypical",
                            "name": "Atypical",
                            "date_updated": "2019-11-28T23:33:11+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/atypical",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/atypical",
                            "appearance": {
                                "song_id": 236662,
                                "song_name": "Yoko Ono",
                                "song_album": "Our First EP",
                                "artist_id": "moby-rich",
                                "artist_name": "Moby Rich",
                                "date_created": "2019-11-01T20:52:47+00:00",
                                "date_updated": "2019-11-08T03:43:59+00:00",
                                "scene": "Casey dancing too close to Izzie, Izzie freaks and pulls away.",
                                "air_date": "2019-11-01T00:00:00+00:00",
                                "syndication_date": "2019-11-06T06:33:38+00:00",
                                "confidence": "high",
                                "song_order": 4
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 92512,
                            "name": "Sam Takes a Walk",
                            "tunefind_url": "https://www.tunefind.com/show/atypical/season-3/92512",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/atypical/season-3/92512",
                            "date_updated": "2019-11-28T23:33:11+00:00",
                            "air_date": "2019-11-01T00:00:00+00:00",
                            "show_name": "Atypical",
                            "show_id": "atypical",
                            "season_name": "Season 3",
                            "season_number": 3,
                            "episode_number": 9,
                            "appearance": {
                                "song_id": 236662,
                                "song_name": "Yoko Ono",
                                "song_album": "Our First EP",
                                "artist_id": "moby-rich",
                                "artist_name": "Moby Rich",
                                "date_created": "2019-11-01T20:52:47+00:00",
                                "date_updated": "2019-11-08T03:43:59+00:00",
                                "scene": "Casey dancing too close to Izzie, Izzie freaks and pulls away.",
                                "air_date": "2019-11-01T00:00:00+00:00",
                                "syndication_date": "2019-11-06T06:33:38+00:00",
                                "confidence": "high",
                                "song_order": 4
                            }
                        }
                    ],
                    "games": [],
                    "movies": []
                }
            },
            {
                "rank": 8,
                "trend": "same",
                "song": {
                    "id": 236833,
                    "name": "The Whole of the Moon",
                    "album": "In a Special Place: The Piano Demos for This Is the Sea",
                    "date_updated": "2019-11-24T05:00:03+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/236833/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/236833",
                    "artist": {
                        "id": "the-waterboys",
                        "name": "The Waterboys",
                        "date_updated": "2019-12-01T17:58:49+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/the-waterboys",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/the-waterboys"
                    },
                    "shows": [],
                    "episodes": [],
                    "games": [],
                    "movies": [
                        {
                            "id": "let-it-snow-2019",
                            "name": "Let It Snow",
                            "tunefind_url": "https://www.tunefind.com/movie/let-it-snow-2019",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/let-it-snow-2019",
                            "date_updated": "2019-11-30T04:50:25+00:00",
                            "air_date": "2019-11-08T00:00:00+00:00",
                            "appearance": {
                                "song_id": 236833,
                                "song_name": "The Whole of the Moon",
                                "song_album": "In a Special Place: The Piano Demos for This Is the Sea",
                                "artist_id": "the-waterboys",
                                "artist_name": "The Waterboys",
                                "date_created": "2019-11-08T15:27:22+00:00",
                                "date_updated": "2019-11-13T23:14:11+00:00",
                                "scene": "Tobin and the Duke sing in the church. Two best friends share their first kiss on the top of the Waffle House.",
                                "air_date": "2019-11-08T00:00:00+00:00",
                                "syndication_date": "2019-11-08T23:12:37+00:00",
                                "confidence": "high",
                                "song_order": 7
                            }
                        }
                    ]
                }
            },
            {
                "rank": 9,
                "trend": "down",
                "song": {
                    "id": 237118,
                    "name": "Mash Potato",
                    "album": "The End of the F***ing World 2 (Original Songs and Score)",
                    "date_updated": "2019-11-27T05:00:05+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/237118/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/237118",
                    "artist": {
                        "id": "graham-coxon",
                        "name": "Graham Coxon",
                        "date_updated": "2019-11-27T05:00:04+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/graham-coxon",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/graham-coxon"
                    },
                    "shows": [
                        {
                            "id": "the-end-of-the-f-king-world",
                            "name": "The End of the Fucking World",
                            "date_updated": "2019-12-02T06:22:25+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/the-end-of-the-f-king-world",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-end-of-the-f-king-world",
                            "appearance": {
                                "song_id": 237118,
                                "song_name": "Mash Potato",
                                "song_album": "The End of the F***ing World 2 (Original Songs and Score)",
                                "artist_id": "graham-coxon",
                                "artist_name": "Graham Coxon",
                                "date_created": "2019-11-05T22:07:03+00:00",
                                "date_updated": "2019-11-05T22:16:23+00:00",
                                "scene": "(0:09) James and Alyssa driving away from the town and towards the cafe.",
                                "air_date": "2019-11-04T00:00:00+00:00",
                                "syndication_date": "2019-11-05T22:07:03+00:00",
                                "confidence": "high",
                                "song_order": 1
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 92782,
                            "name": "Episode 3",
                            "tunefind_url": "https://www.tunefind.com/show/the-end-of-the-f-king-world/season-2/92782",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-end-of-the-f-king-world/season-2/92782",
                            "date_updated": "2019-12-02T06:22:25+00:00",
                            "air_date": "2019-11-04T00:00:00+00:00",
                            "show_name": "The End of the Fucking World",
                            "show_id": "the-end-of-the-f-king-world",
                            "season_name": "Season 2",
                            "season_number": 2,
                            "episode_number": 3,
                            "appearance": {
                                "song_id": 237118,
                                "song_name": "Mash Potato",
                                "song_album": "The End of the F***ing World 2 (Original Songs and Score)",
                                "artist_id": "graham-coxon",
                                "artist_name": "Graham Coxon",
                                "date_created": "2019-11-05T22:07:03+00:00",
                                "date_updated": "2019-11-05T22:16:23+00:00",
                                "scene": "(0:09) James and Alyssa driving away from the town and towards the cafe.",
                                "air_date": "2019-11-04T00:00:00+00:00",
                                "syndication_date": "2019-11-05T22:07:03+00:00",
                                "confidence": "high",
                                "song_order": 1
                            }
                        }
                    ],
                    "games": [],
                    "movies": []
                }
            },
            {
                "rank": 10,
                "trend": "down",
                "song": {
                    "id": 131561,
                    "name": "Don't Take the Money",
                    "album": "Gone Now",
                    "date_updated": "2019-11-17T05:28:56+00:00",
                    "tunefind_url": "https://www.tunefind.com/song/131561/0/",
                    "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/131561",
                    "artist": {
                        "id": "bleachers",
                        "name": "Bleachers",
                        "date_updated": "2019-11-24T05:12:42+00:00",
                        "tunefind_url": "https://www.tunefind.com/artist/bleachers",
                        "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/bleachers"
                    },
                    "shows": [
                        {
                            "id": "the-tonight-show-starring-jimmy-fallon",
                            "name": "The Tonight Show Starring Jimmy Fallon",
                            "date_updated": "2019-12-01T16:16:36+00:00",
                            "tunefind_url": "https://www.tunefind.com/show/the-tonight-show-starring-jimmy-fallon",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-tonight-show-starring-jimmy-fallon",
                            "appearance": {
                                "song_id": 131561,
                                "song_name": "Don't Take the Money",
                                "song_album": "Gone Now",
                                "artist_id": "bleachers",
                                "artist_name": "Bleachers",
                                "date_created": "2017-09-12T22:12:52+00:00",
                                "date_updated": "2017-09-12T22:13:26+00:00",
                                "scene": "The Bleachers perform a LIVE VERSION of this track from their \"Gone Now\" album",
                                "air_date": "2017-06-06T00:00:00+00:00",
                                "syndication_date": "2017-09-12T22:12:52+00:00",
                                "confidence": "medium",
                                "song_order": 1
                            }
                        }
                    ],
                    "episodes": [
                        {
                            "id": 48361,
                            "name": "Tom Cruise, Kate Mara, Bleachers, Mike McCready",
                            "tunefind_url": "https://www.tunefind.com/show/the-tonight-show-starring-jimmy-fallon/season-2017/48361",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-tonight-show-starring-jimmy-fallon/season-2017/48361",
                            "date_updated": "2019-12-01T16:16:36+00:00",
                            "air_date": "2017-06-06T00:00:00+00:00",
                            "show_name": "The Tonight Show Starring Jimmy Fallon",
                            "show_id": "the-tonight-show-starring-jimmy-fallon",
                            "season_name": "Season 2017",
                            "season_number": 2017,
                            "episode_number": 89,
                            "appearance": {
                                "song_id": 131561,
                                "song_name": "Don't Take the Money",
                                "song_album": "Gone Now",
                                "artist_id": "bleachers",
                                "artist_name": "Bleachers",
                                "date_created": "2017-09-12T22:12:52+00:00",
                                "date_updated": "2017-09-12T22:13:26+00:00",
                                "scene": "The Bleachers perform a LIVE VERSION of this track from their \"Gone Now\" album",
                                "air_date": "2017-06-06T00:00:00+00:00",
                                "syndication_date": "2017-09-12T22:12:52+00:00",
                                "confidence": "medium",
                                "song_order": 1
                            }
                        }
                    ],
                    "games": [],
                    "movies": [
                        {
                            "id": "let-it-snow-2019",
                            "name": "Let It Snow",
                            "tunefind_url": "https://www.tunefind.com/movie/let-it-snow-2019",
                            "tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/movie/let-it-snow-2019",
                            "date_updated": "2019-11-30T04:50:25+00:00",
                            "air_date": "2019-11-08T00:00:00+00:00",
                            "appearance": {
                                "song_id": 131561,
                                "song_name": "Don't Take the Money",
                                "song_album": "Gone Now",
                                "artist_id": "bleachers",
                                "artist_name": "Bleachers",
                                "date_created": "2019-10-22T23:23:01+00:00",
                                "date_updated": "2019-10-22T23:23:01+00:00",
                                "scene": "Official Trailer.",
                                "air_date": "2019-11-08T00:00:00+00:00",
                                "syndication_date": "2019-10-22T23:23:01+00:00",
                                "confidence": "high",
                                "song_order": 1
                            }
                        }
                    ]
                }
            }
        ]
    }
    

    Request Parameters

    This endpoint does not expect any request parameters.

    Returns

    Returns an associative array with songs property that contains an array of song rank objects found.

    The Song Rank Object

    Attribute Type Description
    rank string The rank of the trending song.
    trend string The trend of this song, one of "up", "down", "same", "new".
    song a song object The trending song.

    Errors

    In Tunefind API, success and failure are communicated as HTTP response codes:

    Error Code Meaning
    200 Success
    400 Bad Request -- Your request is invalid.
    401 Unauthorized -- Your API key is wrong.
    403 Forbidden
    404 Resource Not Found
    405 Method Not Allowed
    429 Over Rate Limit
    500 Application Error