BBC Web API (beta) Disclaimer  Terms of Use  About Us  backstage.bbc.co.uk
bbc.schedule.getProgrammes
Get programmes within the schedule.
Arguments
start
  (xxxx-xx-xxTxx:xx:00Z) GMT Start time of window in which to retrieve programmes, defaults to current time and date
end
  (xxxx-xx-xxT23:59:00Z) GMT End time of window in which to retrieve programmes, defaults to 23:59:59 today
channel_id
  Comma-separated list of channels
limit
  (100) Maximum number of programmes to return per channel (e.g. use '2' for 'now and next'), maximum value is 500
detail
  (simple) Level of information in response: simple, schedule (more information)
format
  (simple) Response format (more information)
Explore
bbc.schedule.getProgrammes
Start time window in GMT
End time window in GMT
Channels BBC One  
BBC Two  
BBC Three  
BBC Four  
CBBC  
Cbeebies  
BBC News 24  
Parliament  
Radio One  
Radio Two  
Radio Three  
Radio Four  
Radio Five Live  
Radio Five Live Sports Extra  
6 Music  
BBC Seven  
One Xtra  
Asian Network  
World Service  
Limit
Detail Simple   Schedule  
Format Simple   TV-Anytime  
Example response
Simple response with detail=simple:
<schedule>
  <programme programme_id="crid://bbc.co.uk/272913955" title="Neighbours" />
</schedule>
Simple response with detail=schedule:
<schedule>
  <programme programme_id="crid://bbc.co.uk/272913955" title="Neighbours">
    <synopsis>Dylan learns of Stingray's plight and decides to return to Erinsborough. 
          Bree urges her mother to open up to Kim. Karl discovers Internet dating. [AD,S]</synopsis>
    <channel_id>BBCOne</channel_id>
    <start=>2006-02-01T17:35:00Z</start>
    <duration>00:30:00</duration>
  </programme>
</schedule>
TV-Anytime response:
<TVAMain xmlns='urn:tva:metadata:2005' xmlns:mpeg7='urn:mpeg:mpeg7:schema:2005' 
      xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xml:lang='en'>
  <ProgramDescription>
    <ProgramInformationTable>
      <ProgramInformation programId="crid://bbc.co.uk/272913955">
        <BasicDescription>
          <Title>Neighbours</Title>
          <Synopsis length="short">
            Dylan learns of Stingray's plight and decides to return to Erinsborough. 
            Bree urges her mother to open up to Kim. Karl discovers Internet dating. [AD,S]
          </Synopsis>
          <Keyword type="main">Australia</Keyword>
          <Keyword type="main">community</Keyword>
          <Keyword type="main">family</Keyword>
          <Genre href="urn:tva:metadata:cs:ContentCS:2005:3.4.2.1">
            <Name>Soap Opera</Name>
          </Genre>
          <Genre href="urn:tva:metadata:cs:FormatCS:2005:2.2.1">
            <Name>Fictional portrayal of life</Name>
          </Genre>
          <Genre href="urn:tva:metadata:cs:IntentionCS:2005:1.1">
            <Name>ENTERTAINMENT</Name>
          </Genre>
          <CaptionLanguage closed="true">EN-UK</CaptionLanguage>
          <RelatedMaterial>
            <HowRelated href="urn:tva:metadata:cs:HowRelatedCS:2005:10">
              <Name>For more information</Name>
            </HowRelated>
            <MediaLocator>
              <mpeg7:MediaUri>http://www.bbc.co.uk/neighbours</mpeg7:MediaUri>
            </MediaLocator>
          </RelatedMaterial>
        </BasicDescription>
	      <AVAttributes>
          <AudioAttributes>
            <NumOfChannels>2</NumOfChannels>
          </AudioAttributes>
          <AudioAttributes>
            <NumOfChannels>1</NumOfChannels>
            <AudioLanguage 
                  purpose="urn:tva:metadata:cs:AudioPurposeCS:2004:1">EN-UK</AudioLanguage>
          </AudioAttributes>
          <VideoAttributes>
            <AspectRatio>16:9</AspectRatio>
          </VideoAttributes>
        </AVAttributes>
        <MemberOf xsi:type="MemberOfType" crid="crid://bbc.co.uk/__SERNeighbours"/>
      </ProgramInformation>
    </ProgramInformationTable>
    <ProgramLocationTable>
      <Schedule serviceIDRef="BBCOne">
        <ScheduleEvent>
          <Program crid="crid://bbc.co.uk/272913955"/>
          <ProgramURL>
            dvb://233a.1004.1044;5623@2006-02-01T17:36:35Z/PT00H21M
          </ProgramURL>
          <InstanceMetadataId>imi:bbc.co.uk/272913955</InstanceMetadataId>
          <PublishedStartTime>2006-02-01T17:35:00Z</PublishedStartTime>
          <PublishedDuration>PT00H25M00S</PublishedDuration>
        </ScheduleEvent>
      </Schedule>
    </ProgramLocationTable>
  </ProgramDescription>
</TVAMain>