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 2018.
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
- Dates are represented in ISO 8601 format.
- All dates are in UTC.
- Country codes are represented in ISO 3166 format.
- Numeric days of the week start with Monday as 0 and end with Sunday as 6.
- Confidence codes are "high" and "medium". We don't show low confidence data in the API, though this data may be visible on Tunefind.com.
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
Is it possible to fetch a tv show using TMDb id?
This is possible using the
id-typequery parameter. Here is an example request:GET https://[ENDPOINT].api.tunefind.com/api/v2/show/{tmdb-id}?id-type=tmdb
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 Tunefind id for the TV Show. |
| season-number | The season number. |
Returns
Returns a season object if a valid id was provided.
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/54078"
-u username:password
Example Response
{
"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,
"songs": [
{
"id": 135177,
"name": "Sweet Apple",
"date_updated": "2017-12-04T06:32:05+00:00",
"tunefind_url": "https://www.tunefind.com/song/135177/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/135177",
"artist": {
"id": "chase-frank",
"name": "Chase Frank",
"date_updated": "2017-12-04T06:32:05+00:00",
"tunefind_url": "https://www.tunefind.com/artist/chase-frank",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/chase-frank"
},
"stores": [
{
"id": "amazon",
"name": "Amazon.com",
"country": "US",
"search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Chase+Frank+Sweet+Apple"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Chase+Frank+Sweet+Apple"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Chase+Frank+Sweet+Apple"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Chase+Frank+Sweet+Apple"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Chase+Frank+Sweet+Apple"
},
{
"id": "amazon",
"name": "Amazon.in",
"country": "IN",
"search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Chase+Frank+Sweet+Apple"
}
],
"appearance": {
"date_updated": "2017-12-04T06:32:05+00:00",
"scene": "(Montage) Charlotte wakes up, gets ready for her day and tries to pep talk herself into having confidence for work despite her not remembering her recent actons for the last few months.",
"air_date": "2017-10-30T00:00:00+00:00",
"syndication_date": "2017-10-31T00:43:58+00:00",
"confidence": "high",
"song_order": 2
}
},
{
"id": 135176,
"name": "Dark Love (feat. Danny Pratt)",
"date_updated": "2018-06-05T21:59:28+00:00",
"tunefind_url": "https://www.tunefind.com/song/135176/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/135176",
"artist": {
"id": "miami-horror",
"name": "Miami Horror",
"date_updated": "2018-05-26T17:48:59+00:00",
"tunefind_url": "https://www.tunefind.com/artist/miami-horror",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/miami-horror"
},
"stores": [
{
"id": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/dark-love-feat-danny-pratt/1212907176?i=1212907988",
"song_id": "1212907988",
"album_url": "https://itunes.apple.com/us/album/dark-love-feat-danny-pratt/1212907176",
"album_id": "1212907176",
"artist_url": "https://itunes.apple.com/us/artist/miami-horror/292306267",
"artist_id": "292306267"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/dark-love-feat-danny-pratt/1212907176?i=1212907988",
"song_id": "1212907988",
"album_url": "https://itunes.apple.com/us/album/dark-love-feat-danny-pratt/1212907176",
"album_id": "1212907176",
"artist_url": "https://itunes.apple.com/us/artist/miami-horror/292306267",
"artist_id": "292306267"
},
{
"id": "amazon",
"name": "Amazon.com",
"country": "US",
"search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Miami+Horror+Dark+Love+%28feat.+Danny+Pratt%29"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Miami+Horror+Dark+Love+%28feat.+Danny+Pratt%29"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Miami+Horror+Dark+Love+%28feat.+Danny+Pratt%29"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Miami+Horror+Dark+Love+%28feat.+Danny+Pratt%29"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Miami+Horror+Dark+Love+%28feat.+Danny+Pratt%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=Miami+Horror+Dark+Love+%28feat.+Danny+Pratt%29"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/7vRCgMvkmCsiDBC3rcFV2A",
"song_id": "7vRCgMvkmCsiDBC3rcFV2A",
"album_url": "https://open.spotify.com/album/4VypeJSvXVfBe7kMLihD3p",
"album_id": "4VypeJSvXVfBe7kMLihD3p",
"artist_url": "https://open.spotify.com/artist/0Z5pcmXDCKTrFWLnDChC37",
"artist_id": "0Z5pcmXDCKTrFWLnDChC37"
}
],
"appearance": {
"date_updated": "2017-12-04T06:32:04+00:00",
"scene": "At Permance Pudding Plus, Lalo, a security guard wolfes down some pudding when Simon arrives to start the next batch.",
"air_date": "2017-10-30T00:00:00+00:00",
"syndication_date": "2017-10-31T00:42:28+00:00",
"confidence": "high",
"song_order": 1
}
},
{
"id": 135179,
"name": "Heavy",
"date_updated": "2018-06-05T21:59:28+00:00",
"tunefind_url": "https://www.tunefind.com/song/135179/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/135179",
"artist": {
"id": "powers",
"name": "POWERS",
"date_updated": "2018-05-26T17:48:59+00:00",
"tunefind_url": "https://www.tunefind.com/artist/powers",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/powers"
},
"stores": [
{
"id": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/heavy/1207041261?i=1207041264",
"song_id": "1207041264",
"album_url": "https://itunes.apple.com/us/album/heavy/1207041261",
"album_id": "1207041261",
"artist_url": "https://itunes.apple.com/us/artist/powers/1016785140",
"artist_id": "1016785140"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/heavy/1207041261?i=1207041264",
"song_id": "1207041264",
"album_url": "https://itunes.apple.com/us/album/heavy/1207041261",
"album_id": "1207041261",
"artist_url": "https://itunes.apple.com/us/artist/powers/1016785140",
"artist_id": "1016785140"
},
{
"id": "amazon",
"name": "Amazon.com",
"country": "US",
"search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=POWERS+Heavy"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=POWERS+Heavy"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=POWERS+Heavy"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=POWERS+Heavy"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=POWERS+Heavy"
},
{
"id": "amazon",
"name": "Amazon.in",
"country": "IN",
"search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=POWERS+Heavy"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/0OBIHrjv88N4SEtf2INos5",
"song_id": "0OBIHrjv88N4SEtf2INos5",
"album_url": "https://open.spotify.com/album/3VGh9KUcS8f348pAwwPiev",
"album_id": "3VGh9KUcS8f348pAwwPiev",
"artist_url": "https://open.spotify.com/artist/0PGB0xsAyDqHHlvNQcgq5S",
"artist_id": "0PGB0xsAyDqHHlvNQcgq5S"
}
],
"appearance": {
"date_updated": "2017-12-04T06:32:05+00:00",
"scene": "The sexy pudding photo shoot continues on until Chloe introduces herself to Grace.",
"air_date": "2017-10-30T00:00:00+00:00",
"syndication_date": "2017-10-31T00:46:03+00:00",
"confidence": "high",
"song_order": 4
}
},
{
"id": 135184,
"name": "Are You Happy",
"date_updated": "2018-06-05T21:59:28+00:00",
"tunefind_url": "https://www.tunefind.com/song/135184/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/135184",
"artist": {
"id": "stacey",
"name": "STACEY",
"date_updated": "2018-05-26T17:49:00+00:00",
"tunefind_url": "https://www.tunefind.com/artist/stacey",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/stacey"
},
"stores": [
{
"id": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/are-you-happy/1274092389?i=1274092442",
"song_id": "1274092442",
"album_url": "https://itunes.apple.com/us/album/are-you-happy/1274092389",
"album_id": "1274092389",
"artist_url": "https://itunes.apple.com/us/artist/stacey/996636184",
"artist_id": "996636184"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/are-you-happy/1274092389?i=1274092442",
"song_id": "1274092442",
"album_url": "https://itunes.apple.com/us/album/are-you-happy/1274092389",
"album_id": "1274092389",
"artist_url": "https://itunes.apple.com/us/artist/stacey/996636184",
"artist_id": "996636184"
},
{
"id": "amazon",
"name": "Amazon.com",
"country": "US",
"search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=STACEY+Are+You+Happy"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=STACEY+Are+You+Happy"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=STACEY+Are+You+Happy"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=STACEY+Are+You+Happy"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=STACEY+Are+You+Happy"
},
{
"id": "amazon",
"name": "Amazon.in",
"country": "IN",
"search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=STACEY+Are+You+Happy"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/4v88HNoLG29YTX2LQH0g8V",
"song_id": "4v88HNoLG29YTX2LQH0g8V",
"album_url": "https://open.spotify.com/album/0rIJu3O3Pbhg6ZVTAXTjuZ",
"album_id": "0rIJu3O3Pbhg6ZVTAXTjuZ",
"artist_url": "https://open.spotify.com/artist/1rfYzEJpmnmhVM1V6LUHTQ",
"artist_id": "1rfYzEJpmnmhVM1V6LUHTQ"
}
],
"appearance": {
"date_updated": "2017-12-04T06:32:05+00:00",
"scene": "Charlotte inquires to Lucifer about what she was like during her missing time from her memory.",
"air_date": "2017-10-30T00:00:00+00:00",
"syndication_date": "2017-10-31T01:28:53+00:00",
"confidence": "high",
"song_order": 6
}
},
{
"id": 135183,
"name": "Devil In Your Eyes",
"date_updated": "2017-12-04T06:32:05+00:00",
"tunefind_url": "https://www.tunefind.com/song/135183/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/135183",
"artist": {
"id": "valerie-broussard",
"name": "Valerie Broussard",
"date_updated": "2018-05-26T16:08:49+00:00",
"tunefind_url": "https://www.tunefind.com/artist/valerie-broussard",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/valerie-broussard"
},
"stores": [
{
"id": "amazon",
"name": "Amazon.com",
"country": "US",
"search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Valerie+Broussard+Devil+In+Your+Eyes"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Valerie+Broussard+Devil+In+Your+Eyes"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Valerie+Broussard+Devil+In+Your+Eyes"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Valerie+Broussard+Devil+In+Your+Eyes"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Valerie+Broussard+Devil+In+Your+Eyes"
},
{
"id": "amazon",
"name": "Amazon.in",
"country": "IN",
"search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Valerie+Broussard+Devil+In+Your+Eyes"
}
],
"appearance": {
"date_updated": "2017-12-04T06:32:05+00:00",
"scene": "Lucifer arrives back to his apartment to find Charlotte waiting for him, she then walks up to him and kisses him.",
"air_date": "2017-10-30T00:00:00+00:00",
"syndication_date": "2017-10-31T01:28:38+00:00",
"confidence": "high",
"song_order": 5
}
},
{
"id": 135178,
"name": "I'm Dangerous",
"date_updated": "2018-06-05T21:59:28+00:00",
"tunefind_url": "https://www.tunefind.com/song/135178/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/135178",
"artist": {
"id": "zachary-kibbee",
"name": "Zachary Kibbee",
"date_updated": "2018-05-26T17:48:59+00:00",
"tunefind_url": "https://www.tunefind.com/artist/zachary-kibbee",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/zachary-kibbee"
},
"stores": [
{
"id": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/im-dangerous/1295672671?i=1295672677",
"song_id": "1295672677",
"album_url": "https://itunes.apple.com/us/album/im-dangerous/1295672671",
"album_id": "1295672671",
"artist_url": "https://itunes.apple.com/us/artist/zachary-kibbee/925373379",
"artist_id": "925373379"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/im-dangerous/1295672671?i=1295672677",
"song_id": "1295672677",
"album_url": "https://itunes.apple.com/us/album/im-dangerous/1295672671",
"album_id": "1295672671",
"artist_url": "https://itunes.apple.com/us/artist/zachary-kibbee/925373379",
"artist_id": "925373379"
},
{
"id": "amazon",
"name": "Amazon.com",
"country": "US",
"search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Zachary+Kibbee+I%27m+Dangerous"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Zachary+Kibbee+I%27m+Dangerous"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Zachary+Kibbee+I%27m+Dangerous"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Zachary+Kibbee+I%27m+Dangerous"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Zachary+Kibbee+I%27m+Dangerous"
},
{
"id": "amazon",
"name": "Amazon.in",
"country": "IN",
"search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Zachary+Kibbee+I%27m+Dangerous"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/2RpoxGcwxhIunoSrs0qDck",
"song_id": "2RpoxGcwxhIunoSrs0qDck",
"album_url": "https://open.spotify.com/album/1FLBa89c6Vmd3TUgbOZxIs",
"album_id": "1FLBa89c6Vmd3TUgbOZxIs",
"artist_url": "https://open.spotify.com/artist/3QYTmCDKIFaBgDCfwlZjdU",
"artist_id": "3QYTmCDKIFaBgDCfwlZjdU"
}
],
"appearance": {
"date_updated": "2017-12-04T06:32:05+00:00",
"scene": "Lucifer and Chloe follow the angel to the set and arrive where they are filming a sexy pudding commercial. The set looks like heaven, angels sitting on clouds eating pudding.",
"air_date": "2017-10-30T00:00:00+00:00",
"syndication_date": "2017-10-31T00:45:03+00:00",
"confidence": "high",
"song_order": 3
}
}
]
}
Request Parameters
| Path Parameter | Value |
|---|---|
| id | The unique Tunefind id for the TV Show. |
| season-number | The season number. |
| episode-id | The unique Tunefind episode id for the episode. |
Returns
Returns an episode object if a valid id was provided.
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": "2018-03-07T18:58:42+00:00",
"air_date": "1999-03-31T00:00:00+00:00",
"songs": [
{
"id": 21253,
"name": "My Own Summer (Shove It)",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T17:07:56+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://itunes.apple.com/us/album/my-own-summer-shove-it/331681244?i=331681477",
"song_id": "331681477",
"album_url": "https://itunes.apple.com/us/album/my-own-summer-shove-it/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/deftones/1092903",
"artist_id": "1092903"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/my-own-summer-shove-it/331681244?i=331681477",
"song_id": "331681477",
"album_url": "https://itunes.apple.com/us/album/my-own-summer-shove-it/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.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+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": "US",
"song_url": "https://open.spotify.com/track/1158ckiB5S4cpsdYHDB9IF",
"song_id": "1158ckiB5S4cpsdYHDB9IF",
"album_url": "https://open.spotify.com/album/7o4UsmV37Sg5It2Eb7vHzu",
"album_id": "7o4UsmV37Sg5It2Eb7vHzu",
"artist_url": "https://open.spotify.com/artist/6Ghvu1VvMGScGpOUJBAHNH",
"artist_id": "6Ghvu1VvMGScGpOUJBAHNH"
}
],
"appearance": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-06-02T12:32:27+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://itunes.apple.com/us/album/minor-swing/282878229?i=282878233",
"song_id": "282878233",
"album_url": "https://itunes.apple.com/us/album/minor-swing/282878229",
"album_id": "282878229",
"artist_url": "https://itunes.apple.com/us/artist/django-reinhardt/104576",
"artist_id": "104576"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/minor-swing/282878229?i=282878233",
"song_id": "282878233",
"album_url": "https://itunes.apple.com/us/album/minor-swing/282878229",
"album_id": "282878229",
"artist_url": "https://itunes.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",
"album_url": "https://open.spotify.com/album/6n4MbIocFJ9oHFszyhN1uF",
"album_id": "6n4MbIocFJ9oHFszyhN1uF",
"artist_url": "https://open.spotify.com/artist/5Z1XZyEFY0dewG8faEIiEx",
"artist_id": "5Z1XZyEFY0dewG8faEIiEx"
}
],
"appearance": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T17:14:09+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://itunes.apple.com/us/album/im-beginning-to-see-the-light/937358751?i=937358838",
"song_id": "937358838",
"album_url": "https://itunes.apple.com/us/album/im-beginning-to-see-the-light/937358751",
"album_id": "937358751",
"artist_url": "https://itunes.apple.com/us/artist/duke-ellington/39525",
"artist_id": "39525"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/im-beginning-to-see-the-light/937358751?i=937358838",
"song_id": "937358838",
"album_url": "https://itunes.apple.com/us/album/im-beginning-to-see-the-light/937358751",
"album_id": "937358751",
"artist_url": "https://itunes.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",
"album_url": "https://open.spotify.com/album/5HRYqb7mp810fhgWiUL0uo",
"album_id": "5HRYqb7mp810fhgWiUL0uo",
"artist_url": "https://open.spotify.com/artist/4F7Q5NV6h5TSwCainz8S5A",
"artist_id": "4F7Q5NV6h5TSwCainz8S5A"
}
],
"appearance": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T13:13:16+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://itunes.apple.com/us/album/ultrasonic-sound/331681244?i=331681613",
"song_id": "331681613",
"album_url": "https://itunes.apple.com/us/album/ultrasonic-sound/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/hive/6562522",
"artist_id": "6562522"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/ultrasonic-sound/331681244?i=331681613",
"song_id": "331681613",
"album_url": "https://itunes.apple.com/us/album/ultrasonic-sound/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.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": {
"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)",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T14:42:11+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": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/leave-you-far-behind-lunatics-roller-coaster-mix/331681244?i=331681372",
"song_id": "331681372",
"album_url": "https://itunes.apple.com/us/album/leave-you-far-behind-lunatics-roller-coaster-mix/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/lunatic-calm/3483053",
"artist_id": "3483053"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/leave-you-far-behind-lunatics-roller-coaster-mix/331681244?i=331681372",
"song_id": "331681372",
"album_url": "https://itunes.apple.com/us/album/leave-you-far-behind-lunatics-roller-coaster-mix/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/lunatic-calm/3483053",
"artist_id": "3483053"
},
{
"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": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-06-04T06:46:10+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://itunes.apple.com/us/album/rock-is-dead/24164137?i=24164221",
"song_id": "24164221",
"album_url": "https://itunes.apple.com/us/album/rock-is-dead/24164137",
"album_id": "24164137",
"artist_url": "https://itunes.apple.com/us/artist/marilyn-manson/251375",
"artist_id": "251375"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/rock-is-dead/24164137?i=24164221",
"song_id": "24164221",
"album_url": "https://itunes.apple.com/us/album/rock-is-dead/24164137",
"album_id": "24164137",
"artist_url": "https://itunes.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": "US",
"song_url": "https://open.spotify.com/track/4ukiv6Rp5N4tQZSBT9JRLo",
"song_id": "4ukiv6Rp5N4tQZSBT9JRLo",
"album_url": "https://open.spotify.com/album/69ACUmut0hbGOSonmU4kNS",
"album_id": "69ACUmut0hbGOSonmU4kNS",
"artist_url": "https://open.spotify.com/artist/2VYQTNDsvvKN9wmU5W7xpj",
"artist_id": "2VYQTNDsvvKN9wmU5W7xpj"
}
],
"appearance": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-06-11T06:32:26+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": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/dissolved-girl/724466069?i=724466943",
"song_id": "724466943",
"album_url": "https://itunes.apple.com/us/album/dissolved-girl/724466069",
"album_id": "724466069",
"artist_url": "https://itunes.apple.com/us/artist/massive-attack/526404",
"artist_id": "526404"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/dissolved-girl/724466069?i=724466943",
"song_id": "724466943",
"album_url": "https://itunes.apple.com/us/album/dissolved-girl/724466069",
"album_id": "724466069",
"artist_url": "https://itunes.apple.com/us/artist/massive-attack/526404",
"artist_id": "526404"
},
{
"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"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/0oeEqyEAavgPfFxDYvjAP6",
"song_id": "0oeEqyEAavgPfFxDYvjAP6",
"album_url": "https://open.spotify.com/album/49MNmJhZQewjt06rpwp6QR",
"album_id": "49MNmJhZQewjt06rpwp6QR",
"artist_url": "https://open.spotify.com/artist/6FXMGgJwohJLUSr5nVlf9X",
"artist_id": "6FXMGgJwohJLUSr5nVlf9X"
}
],
"appearance": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T13:59:35+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://itunes.apple.com/us/album/prime-audio-soup/61336158?i=61336107",
"song_id": "61336107",
"album_url": "https://itunes.apple.com/us/album/prime-audio-soup/61336158",
"album_id": "61336158",
"artist_url": "https://itunes.apple.com/us/artist/meat-beat-manifesto/4321346",
"artist_id": "4321346"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/prime-audio-soup/61336158?i=61336107",
"song_id": "61336107",
"album_url": "https://itunes.apple.com/us/album/prime-audio-soup/61336158",
"album_id": "61336158",
"artist_url": "https://itunes.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",
"album_url": "https://open.spotify.com/album/42qgi5UAy4WyKgVAe14Xjs",
"album_id": "42qgi5UAy4WyKgVAe14Xjs",
"artist_url": "https://open.spotify.com/artist/3AO9jmM1JTooPNcu9tTyZx",
"artist_id": "3AO9jmM1JTooPNcu9tTyZx"
}
],
"appearance": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-06-02T12:38:03+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://itunes.apple.com/us/album/bad-blood/331681244?i=331681339",
"song_id": "331681339",
"album_url": "https://itunes.apple.com/us/album/bad-blood/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/ministry/609022",
"artist_id": "609022"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/bad-blood/331681244?i=331681339",
"song_id": "331681339",
"album_url": "https://itunes.apple.com/us/album/bad-blood/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.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": {
"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",
"date_updated": "2018-06-05T21:59: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": "2018-06-07T18:41:51+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://itunes.apple.com/us/album/look-to-your-orb-for-the-warning/331681244?i=331681647",
"song_id": "331681647",
"album_url": "https://itunes.apple.com/us/album/look-to-your-orb-for-the-warning/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/monster-magnet/263368",
"artist_id": "263368"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/look-to-your-orb-for-the-warning/331681244?i=331681647",
"song_id": "331681647",
"album_url": "https://itunes.apple.com/us/album/look-to-your-orb-for-the-warning/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.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"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/0hXpC8CI25VOT8qNV1nr8l",
"song_id": "0hXpC8CI25VOT8qNV1nr8l",
"album_url": "https://open.spotify.com/album/6vmAaaRJHTD6z47hItmOux",
"album_id": "6vmAaaRJHTD6z47hItmOux",
"artist_url": "https://open.spotify.com/artist/4hvwEwrCmGj22uURGVET7Q",
"artist_id": "4hvwEwrCmGj22uURGVET7Q"
}
],
"appearance": {
"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": 1261,
"name": "Mindfields",
"date_updated": "2018-06-05T21:59:28+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": "prodigy",
"name": "Prodigy",
"date_updated": "2018-05-26T17:31:59+00:00",
"tunefind_url": "https://www.tunefind.com/artist/prodigy",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/prodigy"
},
"stores": [
{
"id": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/mindfields/643886158?i=643886637",
"song_id": "643886637",
"album_url": "https://itunes.apple.com/us/album/mindfields/643886158",
"album_id": "643886158",
"artist_url": "https://itunes.apple.com/us/artist/the-prodigy/1093102",
"artist_id": "1093102"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/mindfields/643886158?i=643886637",
"song_id": "643886637",
"album_url": "https://itunes.apple.com/us/album/mindfields/643886158",
"album_id": "643886158",
"artist_url": "https://itunes.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=Prodigy+Mindfields"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Prodigy+Mindfields"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Prodigy+Mindfields"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Prodigy+Mindfields"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=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=Prodigy+Mindfields"
}
],
"appearance": {
"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
}
},
{
"id": 1265,
"name": "Spybreak",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T17:52:33+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://itunes.apple.com/us/album/spybreak/643886158?i=643886620",
"song_id": "643886620",
"album_url": "https://itunes.apple.com/us/album/spybreak/643886158",
"album_id": "643886158",
"artist_url": "https://itunes.apple.com/us/artist/propellerheads/3444766",
"artist_id": "3444766"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/spybreak/643886158?i=643886620",
"song_id": "643886620",
"album_url": "https://itunes.apple.com/us/album/spybreak/643886158",
"album_id": "643886158",
"artist_url": "https://itunes.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",
"album_url": "https://open.spotify.com/album/2ndfvfMJM3dJ8LffTpsCi5",
"album_id": "2ndfvfMJM3dJ8LffTpsCi5",
"artist_url": "https://open.spotify.com/artist/3Z7thZHrtFvqp8OpPffPKp",
"artist_id": "3Z7thZHrtFvqp8OpPffPKp"
}
],
"appearance": {
"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)",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T17:52:33+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://itunes.apple.com/us/album/spybreak-short-one/332118688?i=332118933",
"song_id": "332118933",
"album_url": "https://itunes.apple.com/us/album/spybreak-short-one/332118688",
"album_id": "332118688",
"artist_url": "https://itunes.apple.com/us/artist/propellerheads/3444766",
"artist_id": "3444766"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/spybreak-short-one/332118688?i=332118933",
"song_id": "332118933",
"album_url": "https://itunes.apple.com/us/album/spybreak-short-one/332118688",
"album_id": "332118688",
"artist_url": "https://itunes.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+%28Short+One%29"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Propellerheads+Spybreak+%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+%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+%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+%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+%28Short+One%29"
}
],
"appearance": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-05-26T16:01:23+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://itunes.apple.com/us/album/wake-up/191450810?i=191451241",
"song_id": "191451241",
"album_url": "https://itunes.apple.com/us/album/wake-up/191450810",
"album_id": "191450810",
"artist_url": "https://itunes.apple.com/us/artist/rage-against-the-machine/899409",
"artist_id": "899409"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/wake-up/191450810?i=191451241",
"song_id": "191451241",
"album_url": "https://itunes.apple.com/us/album/wake-up/191450810",
"album_id": "191450810",
"artist_url": "https://itunes.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": {
"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",
"date_updated": "2018-06-05T21:59:28+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": "2018-06-04T06:48:58+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://itunes.apple.com/us/album/du-hast/331681244?i=331681724",
"song_id": "331681724",
"album_url": "https://itunes.apple.com/us/album/du-hast/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/rammstein/408932",
"artist_id": "408932"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/du-hast/331681244?i=331681724",
"song_id": "331681724",
"album_url": "https://itunes.apple.com/us/album/du-hast/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.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"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/1dS1SUD3vr0McKwez9MqAY",
"song_id": "1dS1SUD3vr0McKwez9MqAY",
"album_url": "https://open.spotify.com/album/0GTrr2N5dR11RqBlewYgBi",
"album_id": "0GTrr2N5dR11RqBlewYgBi",
"artist_url": "https://open.spotify.com/artist/6wWVKhxIU2cEi0K81v7HvP",
"artist_id": "6wWVKhxIU2cEi0K81v7HvP"
}
],
"appearance": {
"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": 1263,
"name": "Clubbed to Death",
"date_updated": "2018-06-05T21:59:28+00:00",
"tunefind_url": "https://www.tunefind.com/song/1263/0//clubbed-to-death",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1263",
"artist": {
"id": "rob-dougan",
"name": "Rob Dougan",
"date_updated": "2018-06-07T04:31:52+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://itunes.apple.com/us/album/clubbed-to-death/1857322?i=1857320",
"song_id": "1857320",
"album_url": "https://itunes.apple.com/us/album/clubbed-to-death/1857322",
"album_id": "1857322",
"artist_url": "https://itunes.apple.com/us/artist/rob-dougan/1781918",
"artist_id": "1781918"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/clubbed-to-death/1857322?i=1857320",
"song_id": "1857320",
"album_url": "https://itunes.apple.com/us/album/clubbed-to-death/1857322",
"album_id": "1857322",
"artist_url": "https://itunes.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": "US",
"song_url": "https://open.spotify.com/track/5NQV7pkfMaliF3lVVBMjRz",
"song_id": "5NQV7pkfMaliF3lVVBMjRz",
"album_url": "https://open.spotify.com/album/3WZXkAIibSMX30Em68e5gT",
"album_id": "3WZXkAIibSMX30Em68e5gT",
"artist_url": "https://open.spotify.com/artist/22xRIphSN7IkPVbErICu7s",
"artist_id": "22xRIphSN7IkPVbErICu7s"
}
],
"appearance": {
"date_updated": "2017-08-31T19:25:41+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": 1259,
"name": "Dragula",
"date_updated": "2018-06-05T21:59:28+00:00",
"tunefind_url": "https://www.tunefind.com/song/1259/0//dragula",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1259",
"artist": {
"id": "rob-zombie",
"name": "Rob Zombie",
"date_updated": "2018-06-09T18:32:35+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://itunes.apple.com/us/album/dragula/1106797493?i=1106797549",
"song_id": "1106797549",
"album_url": "https://itunes.apple.com/us/album/dragula/1106797493",
"album_id": "1106797493",
"artist_url": "https://itunes.apple.com/us/artist/rob-zombie/110374",
"artist_id": "110374"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/dragula/1106797493?i=1106797549",
"song_id": "1106797549",
"album_url": "https://itunes.apple.com/us/album/dragula/1106797493",
"album_id": "1106797493",
"artist_url": "https://itunes.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": "US",
"song_url": "https://open.spotify.com/track/4JaJuGSfhcA7kavdgS3yn6",
"song_id": "4JaJuGSfhcA7kavdgS3yn6",
"album_url": "https://open.spotify.com/album/0wY51EfU28wZszAM6kR3Ia",
"album_id": "0wY51EfU28wZszAM6kR3Ia",
"artist_url": "https://open.spotify.com/artist/3HVdAiMNjYrQIKlOGxoGh5",
"artist_id": "3HVdAiMNjYrQIKlOGxoGh5"
}
],
"appearance": {
"date_updated": "2017-08-31T19:25:41+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
}
}
],
"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
Is it possible to fetch a movie using TMDb id?
This is possible using the
id-typequery parameter. Here is an example request:GET https://[ENDPOINT].api.tunefind.com/api/v2/movie/{tmdb-id}?id-type=tmdb
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/talk-talk"
-u username:password
Example Response
{
"id": "talk-talk",
"name": "Talk Talk",
"date_updated": "2018-06-05T10:47:45+00:00",
"tunefind_url": "https://www.tunefind.com/artist/talk-talk",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/artist/talk-talk",
"songs": [
{
"id": 1148,
"name": "It's My Life",
"date_updated": "2018-06-05T10:23:09+00:00",
"tunefind_url": "https://www.tunefind.com/song/1148/0//its-my-life",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/1148",
"shows": [
{
"id": "cold-case",
"name": "Cold Case",
"date_updated": "2018-06-04T06:39:30+00:00",
"tunefind_url": "https://www.tunefind.com/show/cold-case",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/cold-case",
"appearance": {
"date_updated": "2017-11-12T06:32:03+00:00",
"scene": "Livermore and Crowley talk about Navrax fraud",
"air_date": "2004-04-18T00:00:00+00:00",
"syndication_date": "2007-07-25T15:41:44+00:00",
"confidence": "high",
"song_order": 4
}
},
{
"id": "the-carrie-diaries",
"name": "The Carrie Diaries",
"date_updated": "2018-06-04T06:46:04+00:00",
"tunefind_url": "https://www.tunefind.com/show/the-carrie-diaries",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-carrie-diaries",
"appearance": {
"date_updated": "2017-09-12T06:41:18+00:00",
"scene": "when carrie chose to take the job at interview magazine / End of the episode",
"air_date": "2013-02-25T00:00:00+00:00",
"syndication_date": "2013-02-26T14:26:28+00:00",
"confidence": "high",
"song_order": 1
}
}
],
"episodes": [
{
"id": 373,
"name": "Greed",
"tunefind_url": "https://www.tunefind.com/show/cold-case/season-1/373",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/cold-case/season-1/373",
"date_updated": "2018-06-04T06:39:30+00:00",
"air_date": "2004-04-18T00:00:00+00:00",
"show_name": "Cold Case",
"show_id": "cold-case",
"season_name": "Season 1",
"season_number": 1,
"episode_number": 20,
"appearance": {
"date_updated": "2017-11-12T06:32:03+00:00",
"scene": "Livermore and Crowley talk about Navrax fraud",
"air_date": "2004-04-18T00:00:00+00:00",
"syndication_date": "2007-07-25T15:41:44+00:00",
"confidence": "high",
"song_order": 4
}
},
{
"id": 13856,
"name": "Caught",
"tunefind_url": "https://www.tunefind.com/show/the-carrie-diaries/season-1/13856",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/show/the-carrie-diaries/season-1/13856",
"date_updated": "2018-06-04T06:46:04+00:00",
"air_date": "2013-02-25T00:00:00+00:00",
"show_name": "The Carrie Diaries",
"show_id": "the-carrie-diaries",
"season_name": "Season 1",
"season_number": 1,
"episode_number": 7,
"appearance": {
"date_updated": "2017-09-12T06:41:18+00:00",
"scene": "when carrie chose to take the job at interview magazine / End of the episode",
"air_date": "2013-02-25T00:00:00+00:00",
"syndication_date": "2013-02-26T14:26:28+00:00",
"confidence": "high",
"song_order": 1
}
}
],
"games": [],
"movies": [],
"stores": [
{
"id": "applemusic",
"name": "AppleMusic",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/its-my-life/696670362?i=696670364",
"song_id": "696670364",
"album_url": "https://itunes.apple.com/us/album/its-my-life/696670362",
"album_id": "696670362",
"artist_url": "https://itunes.apple.com/us/artist/talk-talk/85321",
"artist_id": "85321"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/its-my-life/696670362?i=696670364",
"song_id": "696670364",
"album_url": "https://itunes.apple.com/us/album/its-my-life/696670362",
"album_id": "696670362",
"artist_url": "https://itunes.apple.com/us/artist/talk-talk/85321",
"artist_id": "85321"
},
{
"id": "amazon",
"name": "Amazon.com",
"country": "US",
"search_url": "http://www.amazon.com/s?ie=UTF8&index=digital-music&keywords=Talk+Talk+It%27s+My+Life"
},
{
"id": "amazon",
"name": "Amazon.ca",
"country": "CA",
"search_url": "http://www.amazon.ca/s?ie=UTF8&index=music&keywords=Talk+Talk+It%27s+My+Life"
},
{
"id": "amazon",
"name": "Amazon.fr",
"country": "FR",
"search_url": "http://www.amazon.fr/s?ie=UTF8&index=digital-music&keywords=Talk+Talk+It%27s+My+Life"
},
{
"id": "amazon",
"name": "Amazon.de",
"country": "DE",
"search_url": "http://www.amazon.de/s?ie=UTF8&index=digital-music&keywords=Talk+Talk+It%27s+My+Life"
},
{
"id": "amazon",
"name": "Amazon.co.uk",
"country": "UK",
"search_url": "http://www.amazon.co.uk/s?ie=UTF8&index=digital-music&keywords=Talk+Talk+It%27s+My+Life"
},
{
"id": "amazon",
"name": "Amazon.in",
"country": "IN",
"search_url": "https://www.amazon.in/s/ref=nb_sb_noss?url=search-alias%3Dpopular&field-keywords=Talk+Talk+It%27s+My+Life"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/6m7fhJkK6TbuGDFhBNpgyn",
"song_id": "6m7fhJkK6TbuGDFhBNpgyn",
"album_url": "https://open.spotify.com/album/2sVePugUVnYAPEyIlGP6Hx",
"album_id": "2sVePugUVnYAPEyIlGP6Hx",
"artist_url": "https://open.spotify.com/artist/7Fo8TAyGJr4VmhE68QamMf",
"artist_id": "7Fo8TAyGJr4VmhE68QamMf"
}
]
}
]
}
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
Is it possible to fetch an artist using Spotify, Itunes or Apple Music id's?
This is possible using the
id-typequery parameter. Here is an example request:GET https://[ENDPOINT].api.tunefind.com/api/v2/artist/{itunes-id}?id-type=itunes
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/21256"
-u username:password
Example Response
{
"id": 21256,
"name": "Du Hast",
"date_updated": "2018-06-05T10:27:40+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",
"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": "2018-03-07T18:58:42+00:00",
"air_date": "1999-03-31T00:00:00+00:00",
"appearance": {
"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
}
}
],
"artist": {
"id": "rammstein",
"name": "Rammstein",
"date_updated": "2018-06-05T10:40:56+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://itunes.apple.com/us/album/du-hast/331681244?i=331681724",
"song_id": "331681724",
"album_url": "https://itunes.apple.com/us/album/du-hast/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.apple.com/us/artist/rammstein/408932",
"artist_id": "408932"
},
{
"id": "itunes",
"name": "iTunes",
"country": "US",
"song_url": "https://itunes.apple.com/us/album/du-hast/331681244?i=331681724",
"song_id": "331681724",
"album_url": "https://itunes.apple.com/us/album/du-hast/331681244",
"album_id": "331681244",
"artist_url": "https://itunes.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"
},
{
"id": "spotify",
"name": "Spotify",
"country": "US",
"song_url": "https://open.spotify.com/track/1dS1SUD3vr0McKwez9MqAY",
"song_id": "1dS1SUD3vr0McKwez9MqAY",
"album_url": "https://open.spotify.com/album/0GTrr2N5dR11RqBlewYgBi",
"album_id": "0GTrr2N5dR11RqBlewYgBi",
"artist_url": "https://open.spotify.com/artist/6wWVKhxIU2cEi0K81v7HvP",
"artist_id": "6wWVKhxIU2cEi0K81v7HvP"
}
]
}
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
Is it possible to fetch a song using Spotify, Itunes or Apple Music id's?
This is possible using the
id-typequery parameter. Here is an example request:GET https://[ENDPOINT].api.tunefind.com/api/v2/song/{ITUNES-id}?id-type=itunes
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=11000"
-u username:password
Example Response
{
"songs": [
{
"id": 140604,
"name": "Beautiful Loser",
"date_updated": "2018-06-05T10:51:14+00:00",
"tunefind_url": "https://www.tunefind.com/song/140604/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/140604"
},
{
"id": 62353,
"name": "Beautiful Loser (Live)",
"date_updated": "2018-06-05T10:35:52+00:00",
"tunefind_url": "https://www.tunefind.com/song/62353/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/62353"
},
{
"id": 33619,
"name": "Beautiful Love",
"date_updated": "2018-06-05T10:30:10+00:00",
"tunefind_url": "https://www.tunefind.com/song/33619/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/33619"
},
{
"id": 100174,
"name": "Beautiful Loved & Blessed",
"date_updated": "2018-06-05T10:43:24+00:00",
"tunefind_url": "https://www.tunefind.com/song/100174/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/100174"
},
{
"id": 78115,
"name": "Beautiful Machine",
"date_updated": "2018-06-05T10:38:59+00:00",
"tunefind_url": "https://www.tunefind.com/song/78115/0/",
"tunefind_api_url": "https://[ENDPOINT].api.tunefind.com/api/v2/song/78115"
}
]
}
Request Parameters
| Query Parameter | Default | Description |
|---|---|---|
| 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. |
| 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. |
| 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. |
| 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": 41836,
"song_name": "Wicked Game",
"artist_id": "chris-isaak",
"artist_name": "Chris Isaak",
"date_created": "2018-06-04T06:40:35+00:00",
"date_updated": "2018-06-05T03:18:08+00:00",
"scene": "Beginning; Kate is out to dinner with Chuck, drooling over the chef.",
"air_date": "2018-06-03T00:00:00+00:00",
"syndication_date": "2018-06-05T03:18:08+00:00",
"confidence": "high",
"song_order": 1
},
{
"song_id": 125068,
"song_name": "My World",
"artist_id": "jimmie-gray",
"artist_name": "Jimmie Gray",
"date_created": "2018-06-18T01:46:21+00:00",
"date_updated": "2018-06-18T01:46:21+00:00",
"scene": "Bajie and Lily smoke together until things turn sour.",
"air_date": "2018-06-03T00:00:00+00:00",
"syndication_date": "2018-06-18T01:46:21+00:00",
"confidence": "medium",
"song_order": 1
},
{
"song_id": 150673,
"song_name": "Symphony No. 7 in A, Op. 92: II. Allegretto",
"artist_id": "gewandhausorchester-leipzig-kurt-masur",
"artist_name": "Gewandhausorchester Leipzig & Kurt Masur",
"date_created": "2018-06-04T01:51:26+00:00",
"date_updated": "2018-06-04T10:51:36+00:00",
"scene": "As the control room is over run, Ford speaks to Bernard of the fire, that destroyed the library in Alexandria.",
"air_date": "2018-06-03T00:00:00+00:00",
"syndication_date": "2018-06-04T01:51:26+00:00",
"confidence": "medium",
"song_order": 2
},
{
"song_id": 112291,
"song_name": "Sweetwater",
"artist_id": "ramin-djawadi",
"artist_name": "Ramin Djawadi",
"date_created": "2018-06-04T01:16:36+00:00",
"date_updated": "2018-06-04T21:10:26+00:00",
"scene": "Ford shows Bernard around inside The Cradle",
"air_date": "2018-06-03T00:00:00+00:00",
"syndication_date": "2018-06-04T01:16:37+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. |
| 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. |
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 |