BBC Web API (beta) Disclaimer  Terms of Use  About Us  backstage.bbc.co.uk
Programme list response
The detail of simple format response of a bbc.schedule.getProgrammes and bbc.programme.search call is defined by setting the detail argument. The options are:

simple
  (default) Returns programme id and title
schedule
  Returns programme id, title, start time, end time and basic synopsis

This does not affect responses in TV-Anytime format.


detail=simple responses are the same for both methods:
<schedule>
	<programme programme_id="1234" name="EastEnders" />
</schedule>
				
detail=schedule responses are specific to each method. bbc.schedule.getProgrammes responds as follows:
<schedule>
  <programme programme_id="crid://bbc.co.uk/1234" title="EastEnders">
    <synopsis>Mo has a barny daan the Vic.</synopsis>
    <channel_id>BBCOne</channel_id>
    <start=>2005-11-31T20:00:00Z</start>
    <duration>00:30:00</duration>
  </programme>
</schedule>
				
bbc.programme.search includes event tags for each programme as a programme may occur more than once in the search time window:
<result programmes="2" sort="title">
  <programme programme_id="crid://bbc.co.uk/1234" title="EastEnders">
    <synopsis>Mo has a barny daan the Vic.</synopsis>
    <event channel_id="BBCOne">
      <start>2005-11-31T20:00:00Z</start>
      <duration>00:30:00</duration>
    <event>
  </programme>
  <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>