BBC Web API (beta) Disclaimer  Terms of Use  About Us  backstage.bbc.co.uk
bbc.programme.search
Get a list of programmes matching some criteria.
Arguments
title
  Title (or part thereof, minimum 3 characters)
start
  (xxxx-xx-xxT00:00:00+00:00) Start time of window in which to retrieve programmes, defaults to now
end
  (xxxx-xx-xx(+1)T00:00:00+00:00) End time of window in which to retrieve programmes, defaults to 23:59:59 today
keyword
  Free-text search term (minimum 3 characters)
limit
  (100) Maximum number of programmes to return. Maximum value is 500
detail
  (simple) Level of information in response: simple, schedule (more information)
sort
  (title) The order in which the programmes are returned. Possible values are:
    title (default) - alphabetical by title
    title-reverse - reverse alphabetical by title
format
  (simple) Response format (more information)
Explore
bbc.programme.search
title
Start time window in GMT
End time window in GMT
Keyword
Cast member
Limit
Detail Simple   Schedule  
Sort by Title   Title (reverse)  
Format Simple   TV-Anytime  
Example response
Simple response with detail=simple:
<result programmes="1" sort="title">
  <programme programme_id="crid://bbc.co.uk/272907390" title="Neighbours" />
</result>
Simple response with detail=schedule:
<result programmes="2" sort="title">
  <programme programme_id="crid://bbc.co.uk/2345" title="Neighbours">
    <synopsis>Fair dinkum.</synopsis>
    <event channel_id="BBCOne">
      <start>2005-11-31T13:40:00Z</start>
      <duration>00:30:00</duration>
    <event>
    <event channel_id="BBCOne">
      <start>2005-11-31T15:35:00Z</start>
      <duration>00:30:00</duration>
    <event>
  </programme>
</result>
TV-Anytime format:
<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>