LDSTechForumProjects

Mormon Channel Web Services

Mormonchannelbanner.jpg
Mormon Channel Project Index edit

Introduction

As part of the Mormon Channel products, a web service has been provided that allows applications to query content that is currently available as audio streams on LDS.org. Mormon Channel applications such as the Mormon Channel iPhone Application use these services to dynamically provide users with different streams to navigate and listen to. These web services, for example, can tell the application which magazine articles are available, or which conference reports are available. The purpose of this article is to define the web services that exist for developers to use.

Web service URL

All of the web services are available via http://tech.lds.org/radio. The web services use a RESTful API approach. The APIs are multi-channel, supporting both XML and JSON. You can specify the format by adding to any API query either 'format=xml' for XML results or 'format=json' for JSON results. The default is XML if this parameter is left off. The following REST url's are currently defined.

Also all web services now support the addition of "apiversion" parameter. This parameter, if left off, will default to 1.0. Currently the valid options are "1.0" for legacy or original API, and 2.0 for the most current API. 2.0 adds additional properties and features for the API's specified below.

Web services

lds.radio.languages.query

Command:

lds.radio.languages.query - This command will return a listing of all of the languages that there is content for. However, right now it returns both Spanish and English even through no Spanish content has been entered into the system.

Parameters:

None

Example:

http://tech.lds.org/radio?action=lds.radio.languages.query&apiversion=2.0

XML Results:

<?xml version="1.0" encoding="UTF-8"?>
<languages.results>
   <languages count="2">
      <language ID="1">
         <name>English</name>
      </language>
      <language ID="2">
         <name>Spanish</name>
      </language>
   </languages>
   <apiresults success="TRUE"/>
</languages.results>

JSON Results:

{
  languages.results: {
    languages: {
      language: [
        {
          ID: "1"
          name: "English"
        }
        {
          ID: "2"
          name: "Spanish"
        }
      ]
      count: 2
    }
    apiresults: {
        success: "TRUE"
      }
    }
}

lds.radio.radiochannels.query

Command:

lds.radio.radiochannels.query - This command returns a list of all of the available radio channels. Currently only one channel is made available.

Parameters:

No parameters

Example:

http://tech.lds.org/radio?action=lds.radio.radiochannels.query&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<radiochannels.results>
  <channels count="3">
    <channel ID="5">
      <description>Mormon Channel</description>
      <summary>The Mormon Channel is the media channel of The Church of Jesus Christ of Latter-day Saints. The channel originates from Temple Square in Salt Lake City, Utah, and broadcasts 24 hours a day, seven days a week. Content for the station comes from the vast archives of the Church, along with several new series created specifically for this station. The Mormon Channel also features great programming from various partner organizations.</summary>
      <url>http://mp3radio.lds.org/mormon</url>
      <hls_url></hls_url>
      <port>80</port>
      <has_programming>1</has_programming>
      <picture_small_portrait></picture_small_portrait>
      <picture_small_landscape></picture_small_landscape>
      <picture_med_portrait></picture_med_portrait>
      <picture_med_landscape></picture_med_landscape>
      <picture_large_portrait></picture_large_portrait>
      <picture_large_landscape></picture_large_landscape>
    </channel>
    <channel ID="6">
      <description>Music</description>
      <summary>Come join the Mormon Channel as we provide new content in our Music Service.</summary>
      <url>http://mp3radio.lds.org/music</url>
      <hls_url></hls_url>
      <port>80</port>
      <has_programming>0</has_programming>
      <picture_small_portrait>http://broadcast2.lds.org/XML/LDSRadio/music-stream-320x367.jpg</picture_small_portrait>
      <picture_small_landscape>http://broadcast2.lds.org/XML/LDSRadio/music-stream-480x207.jpg</picture_small_landscape>
      <picture_med_portrait>http://broadcast2.lds.org/XML/LDSRadio/music-stream-640x396.jpg</picture_med_portrait>
      <picture_med_landscape>http://broadcast2.lds.org/XML/LDSRadio/music-stream-960x414.jpg</picture_med_landscape>
      <picture_large_portrait>http://broadcast2.lds.org/XML/LDSRadio/music-stream-768x914.jpg</picture_large_portrait>
      <picture_large_landscape>http://broadcast2.lds.org/XML/LDSRadio/music-stream-1024x668.jpg</picture_large_landscape>
    </channel>
    <channel ID="8">
      <description>Canal Mormón</description>
      <summary></summary>
      <url>http://mp3radio.lds.org/spanish</url>
      <hls_url></hls_url>
      <port>80</port>
      <has_programming>0</has_programming>
      <picture_small_portrait>http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-320x367.jpg</picture_small_portrait>
      <picture_small_landscape>http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-480x207.jpg</picture_small_landscape>
      <picture_med_portrait>http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-640x396.jpg</picture_med_portrait>
      <picture_med_landscape>http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-960x414.jpg</picture_med_landscape>
      <picture_large_portrait>http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-768x914.jpg</picture_large_portrait>
      <picture_large_landscape>http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-1024x668.jpg</picture_large_landscape>
    </channel>
  </channels>
  <apiresults success="TRUE"/>
</radiochannels.results>

JSON Example Results:

{

    "radiochannels.results": {
        "channels": [
            {
                "ID": "5",
                "description": "Mormon Channel",
                "summary": "The Mormon Channel is the media channel of The Church of Jesus Christ of Latter-day Saints. The channel originates from Temple Square in Salt Lake City, Utah, and broadcasts 24 hours a day, seven days a week. Content for the station comes from the vast archives of the Church, along with several new series created specifically for this station. The Mormon Channel also features great programming from various partner organizations.",
                "url": "http://mp3radio.lds.org/mormon",
                "hls_url": "",
                "port": "80",
                "has_programming": 1,
                "picture_small_portrait": "",
                "picture_small_landscape": "",
                "picture_med_portrait": "",
                "picture_med_landscape": "",
                "picture_large_portrait": "",
                "picture_large_landscape": ""
            },
            {
                "ID": "6",
                "description": "Music",
                "summary": "Come join the Mormon Channel as we provide new content in our Music Service.",
                "url": "http://mp3radio.lds.org/music",
                "hls_url": "",
                "port": "80",
                "has_programming": 0,
                "picture_small_portrait": "http://broadcast2.lds.org/XML/LDSRadio/music-stream-320x367.jpg",
                "picture_small_landscape": "http://broadcast2.lds.org/XML/LDSRadio/music-stream-480x207.jpg",
                "picture_med_portrait": "http://broadcast2.lds.org/XML/LDSRadio/music-stream-640x396.jpg",
                "picture_med_landscape": "http://broadcast2.lds.org/XML/LDSRadio/music-stream-960x414.jpg",
                "picture_large_portrait": "http://broadcast2.lds.org/XML/LDSRadio/music-stream-768x914.jpg",
                "picture_large_landscape": "http://broadcast2.lds.org/XML/LDSRadio/music-stream-1024x668.jpg"
            },
            {
                "ID": "8",
                "description": "Canal Mormón",
                "summary": "",
                "url": "http://mp3radio.lds.org/spanish",
                "hls_url": "",
                "port": "80",
                "has_programming": 0,
                "picture_small_portrait": "http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-320x367.jpg",
                "picture_small_landscape": "http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-480x207.jpg",
                "picture_med_portrait": "http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-640x396.jpg",
                "picture_med_landscape": "http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-960x414.jpg",
                "picture_large_portrait": "http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-768x914.jpg",
                "picture_large_landscape": "http://broadcast2.lds.org/XML/LDSRadio/canal-mormon-1024x668.jpg"
            }
        ],
        "count": 3,
        "success": {
            "success": true
        }
    }
}

lds.radio.radiochannels.programming.query

Command:

lds.radio.radiochannels.programming.query - This command returns a list of all of the programming for the mormon channel for a particular date

Parameters:

channelID = the ID of the radio channel you want to get programming for.
date = This parameter is optional. If set (in YYYY-MM-DD format) the programming for a particular date will be retrieved. If left blank, the current date will be used.

Example:

http://tech.lds.org/radio/?action=lds.radio.radiochannels.programming.query&channelID=5&date=2010-01-15&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<radioprogramming.results>
  <programs count="3">
    <program ID="2523">
      <date>2010-01-15</date>
      <time>00:00:10</time>
      <title>News of the Church</title>
      <shortdescription>Thursday News</shortdescription>
      <artist>Mormon Channel</artist>
    </program>
    <program ID="2524">
      <date>2010-01-15</date>
      <time>00:06:53</time>
      <title>Mormon Channel Questions and Answers</title>
      <shortdescription>Episode 8 - Faith</shortdescription>
      <artist>Mormon Channel</artist>
    </program>
    <program ID="2525">
      <date>2010-01-15</date>
      <time>00:37:59</time>
      <title>Kyrie</title>
      <shortdescription>Requiem</shortdescription>
      <artist>Mormon Tabernacle Choir</artist>
    </program>
  </programs>
  <apiresults success="TRUE"/>
</radioprogramming.results>

JSON Example Results:

{
    "radioprogramming.results": {
        "programs": {
            "program": [
                {
                    "ID": "2523",
                    "date": "2010-01-15",
                    "time": "00:00:10",
                    "title": "News of the Church",
                    "shortdescription": "Thursday News",
                    "artist": "Mormon Channel"
                },
                {
                    "ID": "2524",
                    "date": "2010-01-15",
                    "time": "00:06:53",
                    "title": "Mormon Channel Questions and Answers",
                    "shortdescription": "Episode 8 - Faith",
                    "artist": "Mormon Channel"
                },
                {
                    "ID": "2525",
                    "date": "2010-01-15",
                    "time": "00:37:59",
                    "title": "Kyrie",
                    "shortdescription": "Requiem",
                    "artist": "Mormon Tabernacle Choir"
                }
            ],
            "count": 3
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.conferences.query

Command:

lds.radio.conferences.query - This command returns a list of all of the available general, relief society, and young women conference recordings.

Parameters:

languageID - The ID returned from the lds.radio.languages.query call.

Example:

http://tech.lds.org/radio?action=lds.radio.conferences.query&languageID=1&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<conferences.results>
  <conferences count="3">
    <conference ID="19">
      <title>October 2011</title>
      <full_title>181st Semiannual General Conference</full_title>
      <month>10</month>
      <year>2011</year>
      <language>1</language>
      <thumbnail_url>http://tech.lds.org/radio/conferenceimages/15/general-conference-640x396-april-2010.jpg</thumbnail_url>
    </conference>
    <conference ID="17">
      <title>April 2011</title>
      <full_title>181st Annual General Conference</full_title>
      <month>4</month>
      <year>2011</year>
      <language>1</language>
      <thumbnail_url>http://tech.lds.org/radio/conferenceimages/17/general-conference1-640x396.jpg</thumbnail_url>
    </conference>
    <conference ID="16">
      <title>October 2010</title>
      <full_title>180th Semiannual General Conference</full_title>
      <month>10</month>
      <year>2010</year>
      <language>1</language>
      <thumbnail_url>http://tech.lds.org/radio/conferenceimages/16/general-conference-640x396-oct-2010.jpg</thumbnail_url>
    </conference>
    <conference ID="15">
      <title>April 2010</title>
      <full_title>180th Annual General Conference</full_title>
      <month>4</month>
      <year>2010</year>
      <language>1</language>
      <thumbnail_url>http://tech.lds.org/radio/conferenceimages/19/general-conference13-640x396.jpg</thumbnail_url>
    </conference>
  </conferences>
  <apiresults success="TRUE"/>
</conferences.results>

JSON Example Results:

{

    "conference.results": {
        "conferences": {
            "conference": [
                {
                    "ID": "19",
                    "title": "October 2011",
                    "full_title": "181st Semiannual General Conference",
                    "month": "10",
                    "year": "2011",
                    "language": "1",
                    "thumbnail_url": "http://tech.lds.org/radio/conferenceimages/15/general-conference-640x396-april-2010.jpg"
                },
                {
                    "ID": "17",
                    "title": "April 2011",
                    "full_title": "181st Annual General Conference",
                    "month": "4",
                    "year": "2011",
                    "language": "1",
                    "thumbnail_url": "http://tech.lds.org/radio/conferenceimages/17/general-conference1-640x396.jpg"
                },
                {
                    "ID": "16",
                    "title": "October 2010",
                    "full_title": "180th Semiannual General Conference",
                    "month": "10",
                    "year": "2010",
                    "language": "1",
                    "thumbnail_url": "http://tech.lds.org/radio/conferenceimages/16/general-conference-640x396-oct-2010.jpg"
                }
            ],
            "count": 3
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.conferences.sessions.query

Command:

lds.radio.conferences.sessions.query - This command will return a listing of all sessions for a particular conference.

Parameters:

conferenceID - The conference ID returned from the previous 'lds.radio.conferences.query' command.

Example:

http://tech.lds.org/radio?action=lds.radio.conferences.sessions.query&conferenceID=7&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<conferences.sessions.results>
  <sessions count="4">
    <session ID="35">
      <title>Saturday Morning Session</title>
      <short_title>Saturday Morning</short_title>
      <order>0</order>
    </session>
    <session ID="36">
      <title>Saturday Afternoon Session</title>
      <short_title>Saturday Afternoon</short_title>
      <order>1</order>
    </session>
    <session ID="37">
      <title>Sunday Morning Session</title>
      <short_title>Sunday Morning</short_title>
      <order>3</order>
    </session>
    <session ID="38">
      <title>Sunday Afternoon Session</title>
      <short_title>Sunday Afternoon</short_title>
      <order>4</order>
    </session>
  </sessions>
  <apiresults success="TRUE"/>
</conferences.sessions.results>

JSON Example Results:

{
    "conferences.sessions.results": {
        "sessions": {
            "session": [
                {
                    "ID": "35",
                    "title": "Saturday Morning Session",
                    "short_title": "Saturday Morning",
                    "order": "0"
                },
                {
                    "ID": "36",
                    "title": "Saturday Afternoon Session",
                    "short_title": "Saturday Afternoon",
                    "order": "1"
                },
                {
                    "ID": "37",
                    "title": "Sunday Morning Session",
                    "short_title": "Sunday Morning",
                    "order": "3"
                },
                {
                    "ID": "38",
                    "title": "Sunday Afternoon Session",
                    "short_title": "Sunday Afternoon",
                    "order": "4"
                }
            ],
            "count": 4
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.conferences.sessions.talks.query

Command:

lds.radio.conferences.sessions.talks.query - This command will return a listing of all the talks for a particular session of conference.

Parameters:

sessionID - The Session ID returned from the previous 'lds.radio.conferences.sessions.query' command.

Example:

http://tech.lds.org/radio?action=lds.radio.conferences.sessions.talks.query&sessionID=35&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<conferences.sessions.talks.results>
  <conference ID="7">
    <title>October 2005</title>
    <full_title>175th Semiannual General Conference, October 2005</full_title>
    <month>10</month>
    <year>2005</year>
    <language>1</language>
    <thumbnail_url>http://tech.lds.org/radio/conferenceimages/7/general-conference9-640x396.jpg</thumbnail_url>
  </conference>
  <session ID="35">
    <title>Saturday Morning Session</title>
    <short_title>Saturday Morning</short_title>
    <order>0</order>
  </session>
  <talks count="2">
    <talk ID="252">
      <title>Entire Session</title>
      <order>0</order>
      <url>http://broadcast2.lds.org/genconf/2005/oct/1/1_000_oct2005.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=2:252</tinyurl>
      <speaker></speaker>
      <tags></tags>
      <contenttype>2</contenttype>
      <picture_url></picture_url>
      <videos>
        <youtube>
          <url></url>
        </youtube>
        <mp4>
          <url></url>
        </mp4>
        <wmv>
          <url></url>
        </wmv>
      </videos>
    </talk>
    <talk ID="253">
      <title>Opening Remarks</title>
      <order>1</order>
      <url>http://broadcast2.lds.org/genconf/2005/oct/1/1_1_hinckley_000_oct2005.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=2:253</tinyurl>
      <speaker>President Gordon B. Hinckley</speaker>
      <tags></tags>
      <contenttype>2</contenttype>
      <picture_url></picture_url>
      <videos>
        <youtube>
          <url></url>
        </youtube>
        <mp4>
          <url></url>
        </mp4>
        <wmv>
          <url></url>
        </wmv>
      </videos>
    </talk>
  </talks>
  <apiresults success="TRUE"/>
</conferences.sessions.talks.results>

JSON Example Results:

{

    "conferences.sessions.talks.results": {
        "conference": {
            "ID": "7",
            "title": "October 2005",
            "full_title": "175th Semiannual General Conference, October 2005",
            "month": "10",
            "year": "2005",
            "language": "1",
            "thumbnail_url": "http://tech.lds.org/radio/conferenceimages/7/general-conference9-640x396.jpg"
        },
        "session": {
            "ID": "35",
            "title": "Saturday Morning Session",
            "short_title": "Saturday Morning",
            "order": "0"
        },
        "talks": {
            "talk": [
                {
                    "ID": "252",
                    "title": "Entire Session",
                    "order": "0",
                    "url": "http://broadcast2.lds.org/genconf/2005/oct/1/1_000_oct2005.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=2:252",
                    "speaker": "",
                    "tags": null,
                    "contenttype": 2,
                    "picture_url": null,
                    "videos": {
                        "youtube": {
                            "url": null
                        },
                        "mp4": {
                            "url": null
                        },
                        "wmv": {
                            "url": null
                        }
                    }
                },
                {
                    "ID": "253",
                    "title": "Opening Remarks",
                    "order": "1",
                    "url": "http://broadcast2.lds.org/genconf/2005/oct/1/1_1_hinckley_000_oct2005.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=2:253",
                    "speaker": "President Gordon B. Hinckley",
                    "tags": null,
                    "contenttype": 2,
                    "picture_url": null,
                    "videos": {
                        "youtube": {
                            "url": null
                        },
                        "mp4": {
                            "url": null
                        },
                        "wmv": {
                            "url": null
                        }
                    }
                }
            ],
            "count": 2
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.magazines.query

Command:

lds.radio.magazines.query - This command will return a listing of all the different magazines available for a given language.

Parameters:

languageID - The Language ID returned from the previous 'lds.radio.languages.query' command.

Example:

http://tech.lds.org/radio?action=lds.radio.magazines.query&languageID=1&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<magazines.results>
  <magazines count="3">
    <magazine ID="3">
      <title>Ensign</title>
      <description>The Ensign of The Church of Jesus Christ of Latter-day Saints is an English-language magazine for adults.</description>
      <image_url>http://tech.lds.org/radio/magazineimages/3/crop_ensign2.png</image_url>
    </magazine>
    <magazine ID="1">
      <title>Friend</title>
      <description>The Friend is a children’s magazine published by The Church of Jesus Christ of Latter-day Saints.</description>
      <image_url>http://tech.lds.org/radio/magazineimages/1/crop_friend2.png</image_url>
    </magazine>
    <magazine ID="2">
      <title>New Era</title>
      <description>The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.</description>
      <image_url>http://tech.lds.org/radio/magazineimages/2/crop_newera2.png</image_url>
    </magazine>
  </magazines>
  <apiresults success="TRUE"/>
</magazines.results>

JSON Example Results:

{
    "magazines.results": {
        "magazines": {
            "magazine": [
                {
                    "ID": "3",
                    "title": "Ensign",
                    "description": "The Ensign of The Church of Jesus Christ of Latter-day Saints is an English-language magazine for adults.",
                    "image_url": "http://tech.lds.org/radio/magazineimages/3/crop_ensign2.png"
                },
                {
                    "ID": "1",
                    "title": "Friend",
                    "description": "The Friend is a children’s magazine published by The Church of Jesus Christ of Latter-day Saints.",
                    "image_url": "http://tech.lds.org/radio/magazineimages/1/crop_friend2.png"
                },
                {
                    "ID": "2",
                    "title": "New Era",
                    "description": "The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.",
                    "image_url": "http://tech.lds.org/radio/magazineimages/2/crop_newera2.png"
                }
            ],
            "count": 3
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.magazines.issues.query

Command:

lds.radio.magazines.issues.query - This command will return a listing of all the different magazines issues available for a given magazine.

Parameters:

magazineID - The magazine ID returned from the previous 'lds.radio.magazines.query' command.

Example:

http://tech.lds.org/radio?action=lds.radio.magazines.issues.query&magazineID=1&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<magazines.issues.results>
  <issues count="3">
    <issue ID="416">
      <title>Friend, March 2012</title>
      <year>2012</year>
      <month>3</month>
      <pictureURL>http://www.lds.org/bc/content/shared/content/english/images/magazines/friend/2012/friend-2012-mar.jpg</pictureURL>
    </issue>
    <issue ID="413">
      <title>Friend, February 2012</title>
      <year>2012</year>
      <month>2</month>
      <pictureURL>http://www.lds.org/bc/content/shared/content/english/images/magazines/friend/2012/friend-2012-feb.jpg</pictureURL>
    </issue>
    <issue ID="410">
      <title>Friend, January 2012</title>
      <year>2012</year>
      <month>1</month>
      <pictureURL>http://www.lds.org/bc/content/shared/content/english/images/magazines/friend/2012/friend-2012-jan.jpg</pictureURL>
    </issue>
  </issues>
  <apiresults success="TRUE"/>
</magazines.issues.results>

JSON Example Results:

{
    "magazines.issues.results": {
        "issues": {
            "issue": [
                {
                    "ID": "416",
                    "title": "Friend, March 2012",
                    "year": "2012",
                    "month": "3",
                    "pictureURL": "http://www.lds.org/bc/content/shared/content/english/images/magazines/friend/2012/friend-2012-mar.jpg"
                },
                {
                    "ID": "413",
                    "title": "Friend, February 2012",
                    "year": "2012",
                    "month": "2",
                    "pictureURL": "http://www.lds.org/bc/content/shared/content/english/images/magazines/friend/2012/friend-2012-feb.jpg"
                },
                {
                    "ID": "410",
                    "title": "Friend, January 2012",
                    "year": "2012",
                    "month": "1",
                    "pictureURL": "http://www.lds.org/bc/content/shared/content/english/images/magazines/friend/2012/friend-2012-jan.jpg"
                }
            ],
            "count": 3
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.magazines.issues.articles.query

Command:

lds.radio.magazines.issues.articles.query - Use this command to query all articles for a particular magazine issue.

Parameters:

issueID: This is the Issue ID that was returned in the previous lds.radio.magazines.issues.query call.

Example:

http://tech.lds.org/radio?action=lds.radio.magazines.issues.articles.query&issueID=10&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<magazines.issues.articles.results>
  <magazine ID="3">
    <title>Ensign</title>
    <image_url>http://tech.lds.org/radio/magazineimages/3/crop_ensign2.png</image_url>
  </magazine>
  <issue ID="10">
    <title>Ensign, February 2009</title>
    <year>2009</year>
    <month>2</month>
    <pictureURL>http://www.lds.org/gospellibrary/churchmagazines/en09feb_cover_small.jpg</pictureURL>
  </issue>
  <articles count="3">
    <article ID="21120">
      <title>Precious Fruits of the First Vision</title>
      <author>Dieter F. Uchtdorf</author>
      <tags></tags>
      <url>http://broadcast2.lds.org/Handheld/Magazines/2009/ENSN_2009Feb/ENSN_2009_02_02_UchtdorfDF_PreciousFruits_04202_eng_002.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:21120</tinyurl>
      <pictureurl></pictureurl>
      <contenttype>3</contenttype>
    </article>
    <article ID="21121">
      <title>Hearing and Heeding the Messagwe from the Grove</title>
      <author>F. Burton Howard</author>
      <tags></tags>
      <url>http://broadcast2.lds.org/Handheld/Magazines/2009/ENSN_2009Feb/ENSN_2009_02_03_HowardFB_HearingAndHeeding_04202_eng_003.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:21121</tinyurl>
      <pictureurl></pictureurl>
      <contenttype>3</contenttype>
    </article>
    <article ID="21122">
      <title>The Functional Family</title>
      <author>James D. MacArthur</author>
      <tags></tags>
      <url>http://broadcast2.lds.org/Handheld/Magazines/2009/ENSN_2009Feb/ENSN_2009_02_04_MacArthurJD_FunctionalFamily_04202_eng_004.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:21122</tinyurl>
      <pictureurl></pictureurl>
      <contenttype>3</contenttype>
    </article>
  </articles>
  <apiresults success="TRUE"/>
</magazines.issues.articles.results>

JSON Example Results:

{
    "magazines.issues.articles.results": {
        "magazine": {
            "ID": "3",
            "title": "Ensign",
            "image_url": "http://tech.lds.org/radio/magazineimages/3/crop_ensign2.png"
        },
        "issue": {
            "ID": "10",
            "title": "Ensign, February 2009",
            "year": 2009,
            "month": 2,
            "pictureURL": "http://www.lds.org/gospellibrary/churchmagazines/en09feb_cover_small.jpg"
        },
        "articles": {
            "article": [
                {
                    "ID": "21120",
                    "title": "Precious Fruits of the First Vision",
                    "author": "Dieter F. Uchtdorf",
                    "tags": null,
                    "contenttype": 3,
                    "url": "http://broadcast2.lds.org/Handheld/Magazines/2009/ENSN_2009Feb/ENSN_2009_02_02_UchtdorfDF_PreciousFruits_04202_eng_002.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:21120",
                    "pictureurl": null
                },
                {
                    "ID": "21121",
                    "title": "Hearing and Heeding the Messagwe from the Grove",
                    "author": "F. Burton Howard",
                    "tags": null,
                    "contenttype": 3,
                    "url": "http://broadcast2.lds.org/Handheld/Magazines/2009/ENSN_2009Feb/ENSN_2009_02_03_HowardFB_HearingAndHeeding_04202_eng_003.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:21121",
                    "pictureurl": null
                },
                {
                    "ID": "21122",
                    "title": "The Functional Family",
                    "author": "James D. MacArthur",
                    "tags": null,
                    "contenttype": 3,
                    "url": "http://broadcast2.lds.org/Handheld/Magazines/2009/ENSN_2009Feb/ENSN_2009_02_04_MacArthurJD_FunctionalFamily_04202_eng_004.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:21122",
                    "pictureurl": null
                }
            ],
            "count": 3
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.scriptures.query

Command:

lds.radio.scriptures.query - Use this command to query the available scriptures for a particular language.

Parameters:

languageID: This is the Language ID that was returned in the lds.radio.languages.query call.

Example:

http://tech.lds.org/radio?action=lds.radio.scriptures.query&languageID=1&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<scriptures.results>
  <scriptures count="5">
    <scripture ID="5">
      <title>Old Testament</title>
      <description>Translated out of the original tongues: and with the former translations diligently compared and revised, by his Majesty's special command</description>
      <image_url>http://tech.lds.org/radio/scriptureimages/5/scriptures-640x396-old-testament-rane.jpg</image_url>
    </scripture>
    <scripture ID="4">
      <title>New Testament</title>
      <description>Translated out of the original greek: and with the former translations diligently compared and revised, by his Majesty's special command</description>
      <image_url>http://tech.lds.org/radio/scriptureimages/4/scriptures-640x396-new-testament-rane.jpg</image_url>
    </scripture>
    <scripture ID="3">
      <title>Book of Mormon</title>
      <description>An account written by the hand of Mormon upon plates taken from the plates of Nephi</description>
      <image_url>http://tech.lds.org/radio/scriptureimages/3/scriptures-640x396-book-of-mormon-rane.jpg</image_url>
    </scripture>
    <scripture ID="2">
      <title>Doctrine and Covenants</title>
      <description>Containing revelations given to Joseph Smith, the Prophet</description>
      <image_url>http://tech.lds.org/radio/scriptureimages/2/scriptures-640x396-dandc-rane.jpg</image_url>
    </scripture>
    <scripture ID="1">
      <title>Pearl of Great Price</title>
      <description>A selection form the revelations, translations, and narrations of Joseph Smith</description>
      <image_url>http://tech.lds.org/radio/scriptureimages/1/scriptures-640x396-pofgp-rane.jpg</image_url>
    </scripture>
  </scriptures>
  <apiresults success="TRUE"/>
</scriptures.results>

JSON Example Results:

{
    "scriptures.results": {
        "scriptures": {
            "scripture": [
                {
                    "ID": "5",
                    "title": "Old Testament",
                    "description": "Translated out of the original tongues: and with the former translations diligently compared and revised, by his Majesty's special command",
                    "image_url": "http://tech.lds.org/radio/scriptureimages/5/scriptures-640x396-old-testament-rane.jpg"
                },
                {
                    "ID": "4",
                    "title": "New Testament",
                    "description": "Translated out of the original greek: and with the former translations diligently compared and revised, by his Majesty's special command",
                    "image_url": "http://tech.lds.org/radio/scriptureimages/4/scriptures-640x396-new-testament-rane.jpg"
                },
                {
                    "ID": "3",
                    "title": "Book of Mormon",
                    "description": "An account written by the hand of Mormon upon plates taken from the plates of Nephi",
                    "image_url": "http://tech.lds.org/radio/scriptureimages/3/scriptures-640x396-book-of-mormon-rane.jpg"
                },
                {
                    "ID": "2",
                    "title": "Doctrine and Covenants",
                    "description": "Containing revelations given to Joseph Smith, the Prophet",
                    "image_url": "http://tech.lds.org/radio/scriptureimages/2/scriptures-640x396-dandc-rane.jpg"
                },
                {
                    "ID": "1",
                    "title": "Pearl of Great Price",
                    "description": "A selection form the revelations, translations, and narrations of Joseph Smith",
                    "image_url": "http://tech.lds.org/radio/scriptureimages/1/scriptures-640x396-pofgp-rane.jpg"
                }
            ],
            "count": 5
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.scriptures.books.query

Command:

lds.radio.scriptures.books.query - Use this command to query the available scriptures "books" for a particular scripture.

Parameters:

scriptureID: This is the Scripture ID that was returned in the previous lds.radio.scriptures.query call.

Example:

http://tech.lds.org/radio?action=lds.radio.scriptures.books.query&scriptureID=1&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<scriptures.books.results>
  <books count="6">
    <book ID="5">
      <title>Title and Introductory Note</title>
      <description>The Pearl of Great Price is a selection of choice materials touching many significant aspects of the faith and doctrine of The Church of Jesus Christ of Latter-day Saints. These items were produced by the Prophet Joseph Smith and were published in the Church periodicals of his day.</description>
    </book>
    <book ID="6">
      <title>Moses</title>
      <description>An extract from the translation of the Bible as revealed to Joseph Smith the Prophet, June 1830&amp;mdash;February 1831.</description>
    </book>
    <book ID="4">
      <title>Abraham</title>
      <description>A Translation of some ancient Records that have fallen into our hands from the catacombs of Egypt. The writings of Abraham while he was in Egypt, called the Book of Abraham, written by his own hand, upon papyrus. (See History of the Church, 2:235&amp;ndash;36, 348&amp;ndash;51.)</description>
    </book>
    <book ID="3">
      <title>Joseph Smith - Matthew</title>
      <description>An extract from the translation of the Bible as revealed to Joseph Smith the Prophet in 1831: Matthew 23:39 and chapter 24.\n\nJesus foretells the impending destruction of Jerusalem&amp;mdash;He also discourses on the second coming of the Son of Man, and the destruction of the wicked.</description>
    </book>
    <book ID="2">
      <title>Joseph Smith - History</title>
      <description>History of the Church, Volume 1, Chapters 1 through 5</description>
    </book>
    <book ID="1">
      <title>Articles of Faith</title>
      <description>History of the Church, Vol. 4, pp. 535&amp;ndash;41</description>
    </book>
  </books>
  <apiresults success="TRUE"/>
</scriptures.books.results>

JSON Example Results:

{
    "scriptures.books.results": {
        "books": {
            "book": [
                {
                    "ID": "5",
                    "title": "Title and Introductory Note",
                    "description": "The Pearl of Great Price is a selection of choice materials touching many significant aspects of the faith and doctrine of The Church of Jesus Christ of Latter-day Saints. These items were produced by the Prophet Joseph Smith and were published in the Church periodicals of his day."
                },
                {
                    "ID": "6",
                    "title": "Moses",
                    "description": "An extract from the translation of the Bible as revealed to Joseph Smith the Prophet, June 1830&mdash;February 1831."
                },
                {
                    "ID": "4",
                    "title": "Abraham",
                    "description": "A Translation of some ancient Records that have fallen into our hands from the catacombs of Egypt. The writings of Abraham while he was in Egypt, called the Book of Abraham, written by his own hand, upon papyrus. (See History of the Church, 2:235&ndash;36, 348&ndash;51.)"
                },
                {
                    "ID": "3",
                    "title": "Joseph Smith - Matthew",
                    "description": "An extract from the translation of the Bible as revealed to Joseph Smith the Prophet in 1831: Matthew 23:39 and chapter 24.\\n\\nJesus foretells the impending destruction of Jerusalem&mdash;He also discourses on the second coming of the Son of Man, and the destruction of the wicked."
                },
                {
                    "ID": "2",
                    "title": "Joseph Smith - History",
                    "description": "History of the Church, Volume 1, Chapters 1 through 5"
                },
                {
                    "ID": "1",
                    "title": "Articles of Faith",
                    "description": "History of the Church, Vol. 4, pp. 535&ndash;41"
                }
            ],
            "count": 6
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.scriptures.books.chapters.query

Command:

lds.radio.scriptures.books.chapters.query - Use this command to query the available chapters within a specific scripture book.

Parameters:

bookID: This is the Book ID that was returned in the previous lds.radio.scriptures.books.query call.

Example:

http://tech.lds.org/radio?action=lds.radio.scriptures.books.chapters.query&bookID=10&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<scriptures.books.chapters.results>
  <scripture ID="5">
    <title>Old Testament</title>
    <description>Translated out of the original tongues: and with the former translations diligently compared and revised, by his Majesty's special command</description>
    <image_url>http://tech.lds.org/radio/scriptureimages/5/scriptures-640x396-old-testament-rane.jpg</image_url>
  </scripture>
  <book ID="10">
    <title>Zephaniah</title>
    <description>The Book of Zephaniah</description>
  </book>
  <chapters count="3">
    <chapter ID="1723">
      <title>Chapter 1</title>
      <description>The destruction of Judah is symbolic of the Second Coming—It is the day of the Lord’s sacrifice, a day of wrath and trouble.</description>
      <url>http://broadcast2.lds.org/scriptures/OldTestament/OT_907_Zephaniah_1_eng.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=4:1723</tinyurl>
      <contenttype>4</contenttype>
    </chapter>
    <chapter ID="1724">
      <title>Chapter 2</title>
      <description>Seek righteousness; seek meekness—Judgment will come upon the Philistines, the Moabites, the children of Ammon, the Ethiopians, and the Assyrians.</description>
      <url>http://broadcast2.lds.org/scriptures/OldTestament/OT_908_Zephaniah_2_eng.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=4:1724</tinyurl>
      <contenttype>4</contenttype>
    </chapter>
    <chapter ID="1725">
      <title>Chapter 3</title>
      <description>At the Second Coming, all nations will assemble to battle—Men will have a pure language—The Lord will reign in their midst.</description>
      <url>http://broadcast2.lds.org/scriptures/OldTestament/OT_909_Zephaniah_3_eng.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=4:1725</tinyurl>
      <contenttype>4</contenttype>
    </chapter>
  </chapters>
  <apiresults success="TRUE"/>
</scriptures.books.chapters.results>

JSON Example Results:

{
    "scriptures.books.chapters.results": {
        "apiresults": {
            "success": "TRUE"
        },
        "scripture": {
            "ID": "5",
            "title": "Old Testament",
            "description": "Translated out of the original tongues: and with the former translations diligently compared and revised, by his Majesty's special command",
            "image_url": "http://tech.lds.org/radio/scriptureimages/5/scriptures-640x396-old-testament-rane.jpg"
        },
        "book": {
            "ID": "10",
            "title": "Zephaniah",
            "description": "The Book of Zephaniah"
        },
        "chapters": {
            "chapter": [
                {
                    "ID": "1723",
                    "title": "Chapter 1",
                    "description": "The destruction of Judah is symbolic of the Second Coming—It is the day of the Lord’s sacrifice, a day of wrath and trouble.",
                    "url": "http://broadcast2.lds.org/scriptures/OldTestament/OT_907_Zephaniah_1_eng.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=4:1723",
                    "contenttype": 4
                },
                {
                    "ID": "1724",
                    "title": "Chapter 2",
                    "description": "Seek righteousness; seek meekness—Judgment will come upon the Philistines, the Moabites, the children of Ammon, the Ethiopians, and the Assyrians.",
                    "url": "http://broadcast2.lds.org/scriptures/OldTestament/OT_908_Zephaniah_2_eng.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=4:1724",
                    "contenttype": 4
                },
                {
                    "ID": "1725",
                    "title": "Chapter 3",
                    "description": "At the Second Coming, all nations will assemble to battle—Men will have a pure language—The Lord will reign in their midst.",
                    "url": "http://broadcast2.lds.org/scriptures/OldTestament/OT_909_Zephaniah_3_eng.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=4:1725",
                    "contenttype": 4
                }
            ],
            "count": 3
        }
    }
}

lds.radio.videos.format.query - DEPRECATED

Command:

lds.radio.videos.format.query - Use this command to query the available video formats. The ID associated with a video format will then be used in subsequent calls if you want to filter for videos of a particular format.

Parameters: None

Example:

http://tech.lds.org/radio/index.php?action=lds.radio.videos.format.query

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<video.results>
  <formats count="3">
    <format ID="1">
      <description>WMV</description>
    </format>
    <format ID="2">
      <description>MP4</description>
    </format>
    <format ID="3">
      <description>YouTube</description>
    </format>
  </formats>
  <apiresults success="TRUE"/>
</video.results>

JSON Example Results:

{
  "videos.results":{
    "formats":{
      "format":[{
        "ID":1,
        "description":"WMV"
      },
      {
        "ID":2,
        "description":"MP4"
      },
      {
        "ID":3,
        "description":"YouTube"
      }]
    },
    "apiresults":{
      "success":"TRUE"
    }
  }
}

lds.radio.videos.query - DEPRECATED

Command:

lds.radio.videos.query - Use this command to query the available video categories and videos within the specified category. For example, this API will return all subcategories of a category as well as all videos of the specified category.

Parameters:

languageID: This is the Language ID that was returned in the lds.radio.languages.query call.
parentCategoryID (Optional): If you omit this parameter then the "root" level categories will return. If you supply this parameter then only categories who's parent is equal to this ID will be returned.
videoformat (Optional): Pass in the video format IDs (separated by commas and ones returned from the lds.radio.videos.format.query) to return only videos and video counts that match the desired format.

Example:

http://tech.lds.org/radio?action=lds.radio.videos.query&languageID=1

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<videos.results>
  <categories count="2">
    <category ID="19">
      <title>180th Annual General Conference, April 2010</title>
      <description>Proceedings of the March 2010 general Young Women meeting and the April 2010 general conference.</description>
      <language>1</language>
      <parent_category_id>17</parent_category_id>
      <display_order>0</display_order>
      <is_date_important>0</is_date_important>
      <videos_in_category>36</videos_in_category>
      <videos_in_subcategories>2</videos_in_subcategories>
      <is_year_month_important>0</is_year_month_important>
      <rate_videos>0</rate_videos>
    </category>
    <category ID="20">
      <title>179th Semiannual General Conference, October 2009</title>
      <description>Proceedings of the September 2009 general Relief Society meeting and the October 2009 general conference.</description>
      <language>1</language>
      <parent_category_id>17</parent_category_id>
      <display_order>1</display_order>
      <is_date_important>0</is_date_important>
      <videos_in_category>0</videos_in_category>
      <videos_in_subcategories>0</videos_in_subcategories>
      <is_year_month_important>0</is_year_month_important>
      <rate_videos>0</rate_videos>
    </category>
  </categories>
  <videos count="1">
    <video ID="46">
      <category_id>18</category_id>
      <title>Forgiveness: My Burden Was Made Light</title>
      <description>
        Forgiveness and the power of Jesus Christ enable a man to survive losing his 
        wife and several children in a car accident and allow the offending driver to 
        begin rebuilding his own life.</description>
      <author>None</author>
      <tags></tags>
      <duration>487</duration>
      <viewCnt>16805</viewCnt>
      <video_order>0</video_order>
      <video_date>0000-00-00</video_date>
      <video_month>4</video_month>
      <video_year>2010</video_year>
      <picture_url>http://lds.org/conference/images/a2010pulpit_1_1_monso.jpg</picture_url>
      <rate_video>0</rate_video>
      <formats count="3">
        <format ID="1">
          <videoId/>
          <url>http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.wmv</url>
          <tinyurl>https://tech.lds.org/d/?v=1</tinyurl>
          <typeid>1</typeid>
          <type>WMV</type>
          <duration>0</duration>
          <viewCnt>0</viewCnt>
          <rateCnt>0</rateCnt>
          <rateAvg>0</rateAvg>
          <watchPage/>
          <flashPlayer/>
          <rtsps/>
          <thumbs/>
        </format>
        <format ID="2">
          <videoId />
          <url>http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.mp4</url>
          <tinyurl>https://tech.lds.org/d/?v=2</tinyurl>
          <typeid>2</typeid>
          <type>MP4</type>
          <duration>0</duration>
          <viewCnt>162</viewCnt>
          <rateCnt>0</rateCnt>
          <rateAvg>0</rateAvg>
          <watchPage/>
          <flashPlayer/>
          <rtsps/>
          <thumbs/>
        </format>
        <format ID="3">
          <videoId>2tRNKCrws0o</videoId>
          <url>http://www.youtube.com/watch?v=2tRNKCrws0o</url>
          <tinyurl>https://tech.lds.org/d/?v=3</tinyurl>
          <typeid>3</typeid>
          <type>YouTube</type>
          <duration>487</duration>
          <viewCnt>16643</viewCnt>
          <rateCnt>78</rateCnt>
          <rateAvg>4</rateAvg>
          <watchPage>http://www.youtube.com/watch?v=2tRNKCrws0o&feature=youtube_gdata_player</watchPage>
          <flashPlayer>http://www.youtube.com/v/2tRNKCrws0o?f=videos&app=youtube_gdata</flashPlayer>
          <rtsps>
          </rtsps>
          <thumbs>
          </thumbs>
        </format>
    </video>
  </videos>
  <apiresults success="TRUE"/>
</videos.results>

JSON Example Results:

{
  "videos.results":{
    "categories":{
      "category":[{
        "ID":"19",
        "title":"180th Annual General Conference, April 2010",
        "description":"Proceedings of the March 2010 general Young Women meeting and the April 2010 general conference.",
        "language":"1",
        "parent_category_id":"17",
        "display_order":"0",
        "is_date_important":"0",
        "videos_in_category":"36",
        "videos_in_subcategories":"2",
        "is_year_month_important":"0",
        "rate_video" : "0"
      },
      {
        "ID":"20",
        "title":"179th Semiannual General Conference, October 2009",
        "description":"Proceedings of the September 2009 general Relief Society meeting and the October 2009 general conference.",
        "language":"1",
        "parent_category_id":"17",
        "display_order":"1",
        "is_date_important":"0",
        "videos_in_category":"0",
        "videos_in_subcategories":"0",
        "is_year_month_important":"0",
        "rate_video" : "0"
      }],
      "count":2
    },
    "videos":{
      "video":[{
        "ID":"10",
        "category_id":"19",
        "title":"Welcome to Conference",
        "description":"President Thomas S. Monson",
        "author":"President Thomas S. Monson",
        "tags":"",
        "video_order":"0",
        "video_date":"0000-00-00",
        "video_month":"0",
        "video_year":"0",
        "picture_url":"http://www.lds.org/conference/images/a2010pulpit_1_1_monso.jpg"
        formats: [{
          ID: "1",
          videoId: "",
          url: "http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.wmv",
          tinyurl: "https://tech.lds.org/d/?v=1",
          typeid: "1",
          type: "WMV",
          duration: "0",
          viewCnt: "0",
          rageCnt: "0",
          rateAvg: "0",
          watchPage: "",
          flashPlayer: "",
          rtsps: "",
          thumbs: ""
        }
        {
          videoId: ""
          url: "http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.mp4",
          tinyurl: "https://tech.lds.org/d/?v=2",
          typeid: "2",
          type: "MP4",
          duration: "0",
          viewCnt: "162",
          rageCnt: "0",
          rateAvg: "0",
          watchPage: "",
          flashPlayer: "",
          rtsps: "",
          thumbs: ""
        }
        { 
          ID: "3",
          videoId: "2tRNKCrws0o",
          url: http://www.youtube.com/watch?v=2tRNKCrws0o,
          tinyurl: https://tech.lds.org/d/?v=3,
          typeid: "3",
          type: "YouTube",
          duration: "487",
          viewCnt: "16643",
          rageCnt: "78",
          rateAvg: "4",
          watchPage: http://www.youtube.com/watch?v=2tRNKCrws0o&amp;feature=youtube_gdata_player,
          flashPlayer: http://www.youtube.com/v/2tRNKCrws0o?f=videos&amp;app=youtube_gdata,
          rtsps: ""
        }]
      "count":2
    },
    "apiresults":{
      "success":"TRUE"
    }
  }
}

lds.radio.videos.video.query - DEPRECATED

Command:

lds.radio.videos.video.query - Use this command to query the available video url(s).

Parameters:

videoID: This is the Video's ID that was returned in the lds.radio.video.query call.

Example:

http://tech.lds.org/radio/index.php?action=lds.radio.videos.video.query&videoID=10

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<videos.results>
  <video ID="10">
    <category_id>19</category_id>
    <title>Welcome to Conference</title>
    <description>President Thomas S. Monson</description>
    <tags></tags>
    <tinyurll>https://tech.lds.org/d/?v=10:0</tinyurl1>
    <url1>http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.wmv</url1>
    <urltype1>WMV</urltype1>
    <tinyurl2>https://tech.lds.org/d/?v=10:1</tinyurl2>
    <url2>http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.mp4</url2>
    <urltype2>MP4</urltype2>
    <tinyurl3></tinyurl3>
    <url3></url3>
    <urltype3></urltype3>
    <video_order>0</video_order>
    <video_date>0000-00-00</video_date>
    <video_month>0</video_month>
    <video_year>0</video_year>
    <picture_url>http://www.lds.org/conference/images/a2010pulpit_1_1_monso.jpg</picture_url>
  </video>
  <apiresults success="TRUE"/>
</videos.results>

JSON Example Results:

{
  "videos.results":{
    "video":{
      "ID":"10",
      "category_id":"19",
      "title":"Welcome to Conference",
      "description":"President Thomas S. Monson",
      "tags":"",
      "tinyurl1":"https://tech.lds.org/d/?v=10:0",
      "url1":"http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.wmv",
      "urltype1":"WMV",
      "tinyurl2":"https://tech.lds.org/d/?v=10:1",
      "url2":"http://broadcast.lds.org/general-conference/2010-april/2010-04-1010-president-thomas-s-monson-eng.mp4",
      "urltype2":"MP4",
      "tinyurl3":"",
      "url3":"",
      "urltype3":"",
      "video_order":"0",
      "video_date":"0000-00-00",
      "video_month":"0",
      "video_year":"0",
      "picture_url":"http://www.lds.org/conference/images/a2010pulpit_1_1_monso.jpg"
    },
    "apiresults":{
      "success":"TRUE"
    }
  }
}

lds.featuredcontent.query

Command:

lds.featuredcontent.query - Use this command to get a listing of all featured content items within a particular date range. Featured content have expiration dates. For example, a particular featured content may be good for the month of October but expire in November. So a particular important feature of this service is that you can specify a date that you want to get featured content for. See Parameters below for details.

Parameters:

languageID: This is the Language ID that is returned from a previous call to lds.radio.query.languages.
startdate: This is the date that you want to retrieve featured content for. This parameter is optional and if not passed in, the current system date is used. Normally you would either pass in the current date or leave this parameter off. Only featured content that has a date range within the "startdate" parameter will be returned.

Example:'

http://tech.lds.org/radio?action=lds.featuredcontent.query&languageID=1&apiversion=2.0

XML Results:

<?xml version="1.0" encoding="UTF-8"?>
<featuredcontent.results>
  <features count="2">
    <feature ID="31">
      <start_date>2012-02-28</start_date>
      <end_date>2012-03-17</end_date>
      <title>Looking through Windows</title>
      <subtitle></subtitle>
      <description>We should be careful how we judge others, as we may be looking at them through our own "unclean windows."</description>
      <image_url>http://broadcast2.lds.org/radio/featuresimages/mormon-messages-640x396-looking-through-windows.jpg</image_url>
      <hd_image_url></hd_image_url>
      <video_youtube_url>http://www.youtube.com/watch?v=dbFiB7oiQs4</video_youtube_url>
      <video_mp4_url></video_mp4_url>
      <video_wmv_url></video_wmv_url>
      <audio_url></audio_url>
      <live_feed>0</live_feed>
      <contenttype>6</contenttype>
    </feature>
    <feature ID="28">
      <start_date>2012-02-14</start_date>
      <end_date>2012-03-21</end_date>
      <title>God Will Lift Us Up </title>
      <subtitle></subtitle>
      <description>Rather than focus on her medical condition, Brittany has found comfort in serving others and trusting in the Lord.</description>
      <image_url>http://broadcast2.lds.org/radio/featuresimages/mormon-messages-youth-640x396-god-will-lift-us-up.jpg</image_url>
      <hd_image_url></hd_image_url>
      <video_youtube_url>http://www.youtube.com/watch?v=bhXPgZ4-krc</video_youtube_url>
      <video_mp4_url></video_mp4_url>
      <video_wmv_url></video_wmv_url>
      <audio_url></audio_url>
      <live_feed>0</live_feed>
      <contenttype>6</contenttype>
    </feature>
  </features>
  <apiresults success="TRUE"/>
</featuredcontent.results>

JSON Results:

{

    "featuredcontent.results": {
        "features": [
            {
                "ID": "31",
                "start_date": "2012-02-28",
                "end_date": "2012-03-17",
                "title": "Looking through Windows",
                "subtitle": "",
                "description": "We should be careful how we judge others, as we may be looking at them through our own \"unclean windows.\"",
                "image_url": "http://broadcast2.lds.org/radio/featuresimages/mormon-messages-640x396-looking-through-windows.jpg",
                "hd_image_url": "",
                "video_youtube_url": "http://www.youtube.com/watch?v=dbFiB7oiQs4",
                "video_mp4_url": "",
                "video_wmv_url": "",
                "audio_url": "",
                "live_feed":"0",
                "contenttype": 6
            },
            {
                "ID": "28",
                "start_date": "2012-02-14",
                "end_date": "2012-03-21",
                "title": "God Will Lift Us Up ",
                "subtitle": "",
                "description": "Rather than focus on her medical condition, Brittany has found comfort in serving others and trusting in the Lord.",
                "image_url": "http://broadcast2.lds.org/radio/featuresimages/mormon-messages-youth-640x396-god-will-lift-us-up.jpg",
                "hd_image_url": "",
                "video_youtube_url": "http://www.youtube.com/watch?v=bhXPgZ4-krc",
                "video_mp4_url": "",
                "video_wmv_url": "",
                "audio_url": "",
                "live_feed":"0",
                "contenttype": 6
            }
        ],
        "count": 2,
        "success": {
            "success": true
        }
    }
}

lds.radio.programs.query

Command:

lds.radio.programs.query - Use this command to get a listing of all programs known as "series" that are available and the episodes within those series. If you are to think of series as a "TV" show then a particular series would be "The Brady Bunch" and the episodes would be a particular episode of the program. Examples of Series include: Mormon Messages, History of Hymns, Bible Videos, etc. Series can contain both video and audio feeds.

Parameters:

languageID: This is the Language ID that is returned from a previous call to lds.radio.query.languages.
programID - Optional: If you pass in the programID of a program, the episodes of that program will be returned. If you omit this parameter, you get a listing of all programs without any episode data.

Example:'

http://tech.lds.org/radio?action=lds.radio.programs.query&languageID=1&programID=77&apiversion=2.0

XML Results:

<?xml version="1.0" encoding="UTF-8"?>
<programs.results>
  <parent ID="77">
    <api_version>1.0</api_version>
    <language_ID>1</language_ID>
    <parent_ID>0</parent_ID>
    <order_no>0</order_no>
    <title>Bible Videos</title>
    <description>Videos of the birth, life, death, and resurrection of the Lord Jesus Christ will provide you and your family a new and meaningful way to learn about Jesus Christ. The videos are faithful to the biblical account, with scripts based on the King James Version of the Bible. Watch for new videos to be added monthly as we assemble one of the finest collections of Bible videos in the world.</description>
    <picture_URL>http://broadcast.lds.org/XML/LDSRadio/bible-videos-640x396.jpg</picture_URL>
  </parent>
  <programs count="0"/>
  <episodes count="2">
    <episode ID="2021">
      <program_ID>77</program_ID>
      <order_no>1</order_no>
      <title>Bible Videos - Introduction</title>
      <description>The Life of Jesus Christ Bible Videos can help you experience Christ's ministry as never before. See how in this introductory video.</description>
      <tags></tags>
      <url></url>
      <tinyurl>http://tech.lds.org/d/?a=5:2021</tinyurl>
      <youtube_url>http://www.youtube.com/watch?v=dYO8opAUFf0</youtube_url>
      <mp4_url></mp4_url>
      <wmv_url></wmv_url>
      <picture_url>http://broadcast.lds.org/XML/LDSRadio/bv-bible-videos-introduction-640x396.jpg</picture_url>
      <contenttype>5</contenttype>
    </episode>
    <episode ID="2020">
      <program_ID>77</program_ID>
      <order_no>2</order_no>
      <title>A Gift to the World</title>
      <description>For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.</description>
      <tags></tags>
      <url></url>
      <tinyurl>http://tech.lds.org/d/?a=5:2020</tinyurl>
      <youtube_url>http://www.youtube.com/watch?v=6yWcxw6YeF8</youtube_url>
      <mp4_url></mp4_url>
      <wmv_url></wmv_url>
      <picture_url>http://broadcast.lds.org/XML/LDSRadio/gift-to-the-world-640x396.jpg</picture_url>
      <contenttype>5</contenttype>
    </episode>
  </episodes>
  <apiresults success="TRUE"/>
</programs.results>

JSON Results:

{

    "programs.results": {
        "parent": {
            "ID": "77",
            "api_version": "1.0",
            "language_ID": "1",
            "parent_ID": "0",
            "order_no": "0",
            "title": "Bible Videos",
            "description": "Videos of the birth, life, death, and resurrection of the Lord Jesus Christ will provide you and your family a new and meaningful way to learn about Jesus Christ. The videos are faithful to the biblical account, with scripts based on the King James Version of the Bible. Watch for new videos to be added monthly as we assemble one of the finest collections of Bible videos in the world.",
            "picture_URL": "http://broadcast.lds.org/XML/LDSRadio/bible-videos-640x396.jpg"
        },
        "programs": {
            "program": [ ],
            "count": 0
        },
        "episodes": {
            "episode": [
                {
                    "ID": "2021",
                    "program_ID": "77",
                    "order_no": "1",
                    "title": "Bible Videos - Introduction",
                    "description": "The Life of Jesus Christ Bible Videos can help you experience Christ's ministry as never before. See how in this introductory video.",
                    "tags": "",
                    "url": "",
                    "tinyurl": "http://tech.lds.org/d/?a=5:2021",
                    "youtube_url": "http://www.youtube.com/watch?v=dYO8opAUFf0",
                    "mp4_url": "",
                    "wmv_url": "",
                    "picture_url": "http://broadcast.lds.org/XML/LDSRadio/bv-bible-videos-introduction-640x396.jpg",
                    "contenttype": 5
                },
                {
                    "ID": "2020",
                    "program_ID": "77",
                    "order_no": "2",
                    "title": "A Gift to the World",
                    "description": "For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.",
                    "tags": null,
                    "url": "",
                    "tinyurl": "http://tech.lds.org/d/?a=5:2020",
                    "youtube_url": "http://www.youtube.com/watch?v=6yWcxw6YeF8",
                    "mp4_url": "",
                    "wmv_url": "",
                    "picture_url": "http://broadcast.lds.org/XML/LDSRadio/gift-to-the-world-640x396.jpg",
                    "contenttype": 5
                }
            ],
            "count": 2
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.contentribbons.query

Command:

lds.contentribbons.query - Use this command to get a listing of all content ribbons to be used within the program and their order that they should appear. Content ribbons are basically different types of content.

Parameters:

languageID: This is the Language ID that is returned from a previous call to lds.radio.query.languages.
includeCustom: (Optional). If you add this parameter and pass in a 1 (on) then custom ribbons will be included in the query. For backwards compatibility of older versions of Mormon Channel that do not support custom ribbons, this feature is optional and defaults to 0 (off).

Example:'

http://tech.lds.org/radio?action=lds.contentribbons.query&languageID=1&includeCustom=1&apiversion=2.0

XML Results:

<?xml version="1.0" encoding="UTF-8"?>
<contentribbons.results>
  <ribbons count="9">
    <ribbon ID="9">
      <language_id>1</language_id>
      <order_no>0</order_no>
      <content_type>1</content_type>
      <description>Radio</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="10">
      <language_id>1</language_id>
      <order_no>1</order_no>
      <content_type>6</content_type>
      <description>Featured</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="11">
      <language_id>1</language_id>
      <order_no>2</order_no>
      <content_type>-2</content_type>
      <description>Playlists</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="13">
      <language_id>1</language_id>
      <order_no>3</order_no>
      <content_type>5</content_type>
      <description>Series</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="12">
      <language_id>1</language_id>
      <order_no>4</order_no>
      <content_type>2</content_type>
      <description>Conferences</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="15">
      <language_id>1</language_id>
      <order_no>5</order_no>
      <content_type>3</content_type>
      <description>Magazines</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="14">
      <language_id>1</language_id>
      <order_no>6</order_no>
      <content_type>4</content_type>
      <description>Scriptures</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="16">
      <language_id>1</language_id>
      <order_no>7</order_no>
      <content_type>-1</content_type>
      <description>Search</description>
      <visible>1</visible>
      <custom_id />
    </ribbon>
    <ribbon ID="17">
        <language_id>1</language_id>
        <order_no>8</order_no>
        <content_type>10</content_type>
        <description>General Authorities</description>
        <visible>1</visible>
        <custom_id>23</custom_id>
  </ribbons>
  <apiresults success="TRUE"/>
</contentribbons.results>

JSON Results:

{
    "contentribbons.results": {
        "ribbons": [
            {
                "ID": "9",
                "language_id": 1,
                "order_no": 0,
                "content_type": 1,
                "description": "Radio",
                "visible": 1,
                "custom_id": 0
            },
            {
                "ID": "10",
                "language_id": 1,
                "order_no": 1,
                "content_type": 6,
                "description": "Featured",
                "visible": 1
                "custom_id": 0
            },
            {
                "ID": "11",
                "language_id": 1,
                "order_no": 2,
                "content_type": -2,
                "description": "Playlists",
                "visible": 1
                "custom_id": 0
            },
            {
                "ID": "13",
                "language_id": 1,
                "order_no": 3,
                "content_type": 5,
                "description": "Series",
                "visible": 1
                "custom_id": 0
            },
            {
                "ID": "12",
                "language_id": 1,
                "order_no": 4,
                "content_type": 2,
                "description": "Conferences",
                "visible": 1
                "custom_id": 0
            },
            {
                "ID": "15",
                "language_id": 1,
                "order_no": 5,
                "content_type": 3,
                "description": "Magazines",
                "visible": 1
                "custom_id": 0
            },
            {
                "ID": "14",
                "language_id": 1,
                "order_no": 6,
                "content_type": 4,
                "description": "Scriptures",
                "visible": 1
                "custom_id": 0
            },
            {
                "ID": "16",
                "language_id": 1,
                "order_no": 7,
                "content_type": -1,
                "description": "Search",
                "visible": 1
                "custom_id": 0
            },
            {
                "ID": "17",
                "language_id": 1,
                "order_no": 8,
                "content_type": 10,
                "description": "General Authorities",
                "visible": 1
                "custom_id": 23
            }
         ],
        "count": 9,
        "success": {
            "success": true
        }
    }
}

lds.customcontent.query

Command:

lds.customcontent.query - Use this command to get a listing of all custom ribbons to be used within the program and their order that they should appear. Custom ribbons are indicated by a content_type of 10 and can contain both audio and video and are hierarchical.

Parameters:

topicID: This is the custom_id field from the lds.contentribbons.query call above or one of it's children.

Example:'

http://tech.lds.org/radio?action=lds.customcontent.query&topicID=24&apiversion=2.0

XML Results:

<?xml version="1.0" encoding="UTF-8"?>
 <customcontent.results>
	<topic ID="24">
		<language_id>1</language_id>
		<parent_id>23</parent_id>
		<title>President Thomas S. Monson</title>
		<summary/>
		<image_url/>
		<order>0</order>
	</topic>
	<subtopics count="0"/>
	<items count="2">
		<item ID="988">
			<topic_id>24</topic_id>
			<title>President Thomas S. Monson</title>
			<summary>182nd Annual General Conference Saturday Morning Session</summary>
			<image_url/>
			<hd_image_url/>
			<audio_url>http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-1010-president-thomas-s-monson-64k-eng.mp3</audio_url>
			<youtube_url>http://www.youtube.com/watch?v=az9SdYuVTNU</youtube_url>
			<mp4_url>http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-1010-president-thomas-s-monson-1080p-eng.mp4</mp4_url>
			<wmv_url/>
			<order>0</order>
		</item>
		<item ID="989">
			<topic_id>24</topic_id>
			<title>President Thomas S. Monson</title>
			<summary>182nd Annual General Conference Priesthood Session</summary>
			<image_url/>
			<hd_image_url/>
			<audio_url>http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-3060-president-thomas-s-monson-64k-eng.mp3</audio_url>
			<youtube_url>http://www.youtube.com/watch?v=nAmA4fazwcQ</youtube_url>
			<mp4_url>http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-3060-president-thomas-s-monson-1080p-eng.mp4</mp4_url>
			<wmv_url/>
			<order>1</order>
		</item>
	</items>
	<apiresults success="TRUE"/>
</customcontent.results>

JSON Results:

{
"customcontent.results": {
    "topic": {
        "ID": 24,
        "language_id": 1,
        "parent_id": "23",
        "title": "President Thomas S. Monson",
        "summary": "",
        "image_url": "",
        "order": 0
    },
    "subtopics": {
        "subtopic": [ ],
        "count": 0
    },
    "items": {
        "item": [
            {
                "ID": 988,
                "topic_id": 24,
                "title": "President Thomas S. Monson",
                "summary": "182nd Annual General Conference Saturday Morning Session",
                "image_url": null,
                "hd_image_url": null,
                "audio_url": "http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-1010-president-thomas-s-monson-64k-eng.mp3",
                "youtube_url": "http://www.youtube.com/watch?v=az9SdYuVTNU",
                "mp4_url": "http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-1010-president-thomas-s-monson-1080p-eng.mp4",
                "wmv_url": "",
                "order": 0
            },
            {
                "ID": 989,
                "topic_id": 24,
                "title": "President Thomas S. Monson",
                "summary": "182nd Annual General Conference Priesthood Session",
                "image_url": null,
                "hd_image_url": null,
                "audio_url": "http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-3060-president-thomas-s-monson-64k-eng.mp3",
                "youtube_url": "http://www.youtube.com/watch?v=nAmA4fazwcQ",
                "mp4_url": "http://media2.ldscdn.org/assets/general-conference/april-2012-general-conference/2012-04-3060-president-thomas-s-monson-1080p-eng.mp4",
                "wmv_url": "",
                "order": 1
            }
        ],
        "count": 2
    },
    "apiresults": {
    "success": "TRUE"
	}
}

lds.search

Command:

lds.search - Use this command to search magazines and/or conferences talks for key workds. Depending upon the parameters, the user can search for all conference talks with either the speaker or title matching all of the search words provided OR search for all magazine articles with either the author or title matching all of the search words provided OR both.

Parameters:

languageID: This is the Language ID that is returned from a previous call to lds.radio.query.languages.
searchPhrase: This is a list of the words you want to search for. Each word must be separated by a %20 (space). Note: the search looks for any form of the word. For example, if you searched for "temp" it will search for all words like "*temp*" which would include, for example, words such as "attempting", "temperate", "temple", etc.
searchContent: - This parameter is a numerical value that indicates what content to search for. Passing in "1" for this parameter will search all conference talks. Passing in "2" will search all magazine articles. Passing in a "16" will search all program series. Passing in 25 will search for all conferences, magazines, and program series.

Example:

http://tech.lds.org/radio?action=lds.search&languageID=1&searchPhrase=tender%20mercies&searchContent=3&apiversion=2.0

XML Example Results:

<?xml version="1.0" encoding="UTF-8"?>
<search.results>
  <search.phrase>tender mercies</search.phrase>
  <search.content>3</search.content>
  <conference.results count="1">
    <talk ID="310">
      <title>The Tender Mercies of the Lord</title>
      <url>http://broadcast2.lds.org/genconf/2005/apr/5/5_6_bednar_000_apr2005.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=2:310</tinyurl>
      <picture_url></picture_url>
      <speaker>Elder David A. Bednar</speaker>
      <tags></tags>
      <youtube_url></youtube_url>
      <mp4_url></mp4_url>
      <wmv_url></wmv_url>
      <session.id>43</session.id>
      <session.title>Sunday Afternoon Session</session.title>
      <session.short_title>Sunday Afternoon</session.short_title>
      <conference.id>8</conference.id>
      <conference.title>April 2005</conference.title>
      <conference.full_title>175th Annual General Conference, April 2005</conference.full_title>
      <conference.month>4</conference.month>
      <conference.year>2005</conference.year>
      <conference.picture_url>http://tech.lds.org/radio/conferenceimages/8/general-conference12-640x396.jpg</conference.picture_url>
      <contenttype>2</contenttype>
    </talk>
  </conference.results>
  <magazine.results count="6">
    <article ID="28802">
      <title>The Tender Mercies of the Lord</title>
      <author>David A. Bednar</author>
      <tags></tags>
      <url>http://broadcast2.lds.org/new-era/2012-february/2012-02-02-the-tender-mercies-of-the-lord-64k-eng.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:28802</tinyurl>
      <pictureurl></pictureurl>
      <issue.id>414</issue.id>
      <issue.title>New Era, February 2012</issue.title>
      <issue.month>2</issue.month>
      <issue.year>2012</issue.year>
      <issue.pictureurl>http://www.lds.org/bc/content/shared/content/english/images/magazines/new-era/2012/new-era-2012-feb.jpg</issue.pictureurl>
      <magazine.id>2</magazine.id>
      <magazine.title>New Era</magazine.title>
      <magazine.description>The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.</magazine.description>
      <contenttype>3</contenttype>
    </article>
    <article ID="28803">
      <title>Recognizing Tender Mercies</title>
      <author>The Church of Jesus Christ of Latter-day Saints</author>
      <tags></tags>
      <url>http://broadcast2.lds.org/new-era/2012-february/2012-02-03-recognizing-tender-mercies-64k-eng.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:28803</tinyurl>
      <pictureurl></pictureurl>
      <issue.id>414</issue.id>
      <issue.title>New Era, February 2012</issue.title>
      <issue.month>2</issue.month>
      <issue.year>2012</issue.year>
      <issue.pictureurl>http://www.lds.org/bc/content/shared/content/english/images/magazines/new-era/2012/new-era-2012-feb.jpg</issue.pictureurl>
      <magazine.id>2</magazine.id>
      <magazine.title>New Era</magazine.title>
      <magazine.description>The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.</magazine.description>
      <contenttype>3</contenttype>
    </article>
    <article ID="22017">
      <title>In Tune: Tender Mercies of the Lord</title>
      <author>Julia D. and Kevin R. Olson</author>
      <tags></tags>
      <url>http://broadcast2.lds.org/Handheld/Magazines/2009/NE_2009Mar/NE_2009_03_03_OlsonKJ_InTune_04243_eng_003.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:22017</tinyurl>
      <pictureurl></pictureurl>
      <issue.id>7</issue.id>
      <issue.title>New Era, March 2009</issue.title>
      <issue.month>3</issue.month>
      <issue.year>2009</issue.year>
      <issue.pictureurl>http://www.lds.org/gospellibrary/churchmagazines/ne09mar_cover_small.jpg</issue.pictureurl>
      <magazine.id>2</magazine.id>
      <magazine.title>New Era</magazine.title>
      <magazine.description>The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.</magazine.description>
      <contenttype>3</contenttype>
    </article>
    <article ID="22037">
      <title>Song: The Tender Mercies of the Lord (Words and Music)</title>
      <author></author>
      <tags></tags>
      <url>http://broadcast2.lds.org/Handheld/Magazines/2009/NE_2009Mar/NE_2009_03_00__TenderMerciesOfTheLord__eng_.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:22037</tinyurl>
      <pictureurl></pictureurl>
      <issue.id>7</issue.id>
      <issue.title>New Era, March 2009</issue.title>
      <issue.month>3</issue.month>
      <issue.year>2009</issue.year>
      <issue.pictureurl>http://www.lds.org/gospellibrary/churchmagazines/ne09mar_cover_small.jpg</issue.pictureurl>
      <magazine.id>2</magazine.id>
      <magazine.title>New Era</magazine.title>
      <magazine.description>The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.</magazine.description>
      <contenttype>3</contenttype>
    </article>
    <article ID="22038">
      <title>Song: The Tender Mercies of the Lord</title>
      <author></author>
      <tags></tags>
      <url>http://broadcast2.lds.org/Handheld/Magazines/2009/NE_2009Mar/NE_2009_03_00__TenderMerciesOfTheLord_Piano_eng_.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:22038</tinyurl>
      <pictureurl></pictureurl>
      <issue.id>7</issue.id>
      <issue.title>New Era, March 2009</issue.title>
      <issue.month>3</issue.month>
      <issue.year>2009</issue.year>
      <issue.pictureurl>http://www.lds.org/gospellibrary/churchmagazines/ne09mar_cover_small.jpg</issue.pictureurl>
      <magazine.id>2</magazine.id>
      <magazine.title>New Era</magazine.title>
      <magazine.description>The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.</magazine.description>
      <contenttype>3</contenttype>
    </article>
    <article ID="24452">
      <title>Tender Mercies of the Lord</title>
      <author>Janice Kapp Perry</author>
      <tags></tags>
      <url>http://broadcast2.lds.org/Handheld/Magazines/2007/NE_2007Apr/NE_2007_04_04_PerryJK_InTuneTenderMerciesOfTheLord_00644_eng_.mp3</url>
      <tinyurl>http://tech.lds.org/d/?a=3:24452</tinyurl>
      <pictureurl></pictureurl>
      <issue.id>160</issue.id>
      <issue.title>New Era, April 2007</issue.title>
      <issue.month>4</issue.month>
      <issue.year>2007</issue.year>
      <issue.pictureurl>http://www.lds.org/images/Magazines/NewEra/2007/April/ne07apr_cover_small.jpg</issue.pictureurl>
      <magazine.id>2</magazine.id>
      <magazine.title>New Era</magazine.title>
      <magazine.description>The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.</magazine.description>
      <contenttype>3</contenttype>
    </article>
  </magazine.results>
  <apiresults success="TRUE"/>
</search.results>

JSON Example Results:

{
    "search.results": {
        "search.phrase": "tender mercies",
        "search.content": "3",
        "conference.results": {
            "talk": [
                {
                    "ID": "310",
                    "title": "The Tender Mercies of the Lord",
                    "url": "http://broadcast2.lds.org/genconf/2005/apr/5/5_6_bednar_000_apr2005.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=2:310",
                    "picture_url": null,
                    "speaker": "Elder David A. Bednar",
                    "tags": null,
                    "youtube_url": null,
                    "mp4_url": null,
                    "wmv_url": null,
                    "session.id": "43",
                    "session.title": "Sunday Afternoon Session",
                    "session.short_title": "Sunday Afternoon",
                    "conference.id": "8",
                    "conference.title": "April 2005",
                    "conference.full_title": "175th Annual General Conference, April 2005",
                    "conference.month": "4",
                    "conference.year": "2005",
                    "conference.picture_url": "http://tech.lds.org/radio/conferenceimages/8/general-conference12-640x396.jpg",
                    "contenttype": 2
                }
            ],
            "count": 1
        },
        "magazine.results": {
            "article": [
                {
                    "ID": "28802",
                    "title": "The Tender Mercies of the Lord",
                    "author": "David A. Bednar",
                    "tags": "",
                    "url": "http://broadcast2.lds.org/new-era/2012-february/2012-02-02-the-tender-mercies-of-the-lord-64k-eng.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:28802",
                    "pictureurl": "",
                    "issue.id": "414",
                    "issue.title": "New Era, February 2012",
                    "issue.month": "2",
                    "issue.year": "2012",
                    "issue.pictureurl": "http://www.lds.org/bc/content/shared/content/english/images/magazines/new-era/2012/new-era-2012-feb.jpg",
                    "magazine.id": "2",
                    "magazine.title": "New Era",
                    "magazine.description": "The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.",
                    "contenttype": 3
                },
                {
                    "ID": "28803",
                    "title": "Recognizing Tender Mercies",
                    "author": "The Church of Jesus Christ of Latter-day Saints",
                    "tags": "",
                    "url": "http://broadcast2.lds.org/new-era/2012-february/2012-02-03-recognizing-tender-mercies-64k-eng.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:28803",
                    "pictureurl": "",
                    "issue.id": "414",
                    "issue.title": "New Era, February 2012",
                    "issue.month": "2",
                    "issue.year": "2012",
                    "issue.pictureurl": "http://www.lds.org/bc/content/shared/content/english/images/magazines/new-era/2012/new-era-2012-feb.jpg",
                    "magazine.id": "2",
                    "magazine.title": "New Era",
                    "magazine.description": "The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.",
                    "contenttype": 3
                },
                {
                    "ID": "22017",
                    "title": "In Tune: Tender Mercies of the Lord",
                    "author": "Julia D. and Kevin R. Olson",
                    "tags": null,
                    "url": "http://broadcast2.lds.org/Handheld/Magazines/2009/NE_2009Mar/NE_2009_03_03_OlsonKJ_InTune_04243_eng_003.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:22017",
                    "pictureurl": null,
                    "issue.id": "7",
                    "issue.title": "New Era, March 2009",
                    "issue.month": "3",
                    "issue.year": "2009",
                    "issue.pictureurl": "http://www.lds.org/gospellibrary/churchmagazines/ne09mar_cover_small.jpg",
                    "magazine.id": "2",
                    "magazine.title": "New Era",
                    "magazine.description": "The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.",
                    "contenttype": 3
                },
                {
                    "ID": "22037",
                    "title": "Song: The Tender Mercies of the Lord (Words and Music)",
                    "author": null,
                    "tags": null,
                    "url": "http://broadcast2.lds.org/Handheld/Magazines/2009/NE_2009Mar/NE_2009_03_00__TenderMerciesOfTheLord__eng_.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:22037",
                    "pictureurl": null,
                    "issue.id": "7",
                    "issue.title": "New Era, March 2009",
                    "issue.month": "3",
                    "issue.year": "2009",
                    "issue.pictureurl": "http://www.lds.org/gospellibrary/churchmagazines/ne09mar_cover_small.jpg",
                    "magazine.id": "2",
                    "magazine.title": "New Era",
                    "magazine.description": "The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.",
                    "contenttype": 3
                },
                {
                    "ID": "22038",
                    "title": "Song: The Tender Mercies of the Lord",
                    "author": null,
                    "tags": null,
                    "url": "http://broadcast2.lds.org/Handheld/Magazines/2009/NE_2009Mar/NE_2009_03_00__TenderMerciesOfTheLord_Piano_eng_.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:22038",
                    "pictureurl": null,
                    "issue.id": "7",
                    "issue.title": "New Era, March 2009",
                    "issue.month": "3",
                    "issue.year": "2009",
                    "issue.pictureurl": "http://www.lds.org/gospellibrary/churchmagazines/ne09mar_cover_small.jpg",
                    "magazine.id": "2",
                    "magazine.title": "New Era",
                    "magazine.description": "The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.",
                    "contenttype": 3
                },
                {
                    "ID": "24452",
                    "title": "Tender Mercies of the Lord",
                    "author": "Janice Kapp Perry",
                    "tags": null,
                    "url": "http://broadcast2.lds.org/Handheld/Magazines/2007/NE_2007Apr/NE_2007_04_04_PerryJK_InTuneTenderMerciesOfTheLord_00644_eng_.mp3",
                    "tinyurl": "http://tech.lds.org/d/?a=3:24452",
                    "pictureurl": null,
                    "issue.id": "160",
                    "issue.title": "New Era, April 2007",
                    "issue.month": "4",
                    "issue.year": "2007",
                    "issue.pictureurl": "http://www.lds.org/images/Magazines/NewEra/2007/April/ne07apr_cover_small.jpg",
                    "magazine.id": "2",
                    "magazine.title": "New Era",
                    "magazine.description": "The New Era is a magazine for youth of The Church of Jesus Christ of Latter-day Saints.",
                    "contenttype": 3
                }
            ],
            "count": 6
        },
        "apiresults": {
            "success": "TRUE"
        }
    }
}

lds.radio.usage.start

In order to track usage of the content, there are two API's that should be called BEFORE audio content is streamed and when a stream ends. This API is to be called BEFORE the content is streamed.

Command:

lds.radio.usage.start - This command logs that an audio stream is being started by the user and will return a "session" ID that will be used in the subsequent call to lds.radio.usage.stop.

Parameters: This method uses both get and post parameters.

GET
format = {xml | json}. If omitted, xml is returned
POST
contenttype - (REQUIRED) This is the type of audio content. 1-Radio, 2-Conferences, 3-Magazines, 4-Scriptures
contentid - (REQUIRED) This is the identifier of the content returned in the call to the appropriate API. For example, the ID of the magazine article, or conference talk.
timezone - (REQUIRED) This is the alpha/numeric timezone indicator of the user's device.
latitude - (OPTIONAL) The latitude from the client devices GPS.
longitude - (OPTIONAL) the longitude from the client devices GPS.
userid - (OPTIONAL) can be any alpha-numeric but is currently not used
connectiontype - (OPTIONAL) This is either 1 for a wifi connection or 2 for a cellular connection. If omitted, 0 = undefined.


Example:

http://tech.lds.org/radio?action=lds.radio.usage.start?format=xml

XML Example Results:

<usage.results>
  <sessionid>12</sessionid>
  <apiresults success="TRUE"/>
</usage.results>

lds.radio.usage.stop

In order to track usage of the content, there are two API's that should be called BEFORE audio content is streamed and when a stream ends. This API is to be called AFTER the content is streamed or if the user terminates the stream.

Command:

lds.radio.usage.stop - This command logs that an audio stream is being has ended.

Parameters:

GET
sessionid - the session ID pass in from the previous call to start.
Example:
http://tech.lds.org/radio?action=lds.radio.usage.stop?sessionid=232
This page was last modified on 20 April 2012, at 13:03.

Note: Content found in this wiki may not always reflect official Church information. See Terms of Use.