GET shows

spinitron.com

Summary: Returns scheduled shows optionally filtered by {start} and/or {end} datetimes
Operation ID:
Auth: unknown
Description

**Terminology**: Spinitron defines a *show* as a radio program. A show can have one or more *schedules*, each of which may specify either an *occurence* or a *repetition*, which represents a set of occurences. Thus scheduled shows have occurences that, for example, may be displayed in a calendar. In the response, `items` is an array of objects representing occurences of scheduled shows. You may optionally filter `items` to a datetime *range* by including in the request {start} and/or {end} parameters, both of which must be no more than one hour in the past. An occurence starting at {end} is included in the reponse. `itmes` can include occurences that begin *or* end within the filter range. A show that goes on air before {start} appears in `items` if it ends *after* but not *at* {start}. An occurence starting at or before {end} is included. If the request omits the {start} parameter, the server sets its value to the current time so that the filter range's start is always defined. If the request specifies {end} then the requested range is *bounded*, otherwise it is *unbounded*. For a bounded request, `items` includes *every* occurence of all shows occuring in the range. The only difference between objects in `items` representing a given show will be the `start` field value. For an unbounded request, `items` includes *only one* occurence per show, specifically, the next occurrence after {start} of all shows occuring after {start}. Use an unbounded request to get a straight list all shows. Use a bounded request to get a calendar/agenda of shows expanded into occurrences by thir shedules and repetitions. Objects in `items` are ordered first by `datetime` and then by `id`.

Parameters (6)

count (integer, query, optional, default: 20)

Amount of items to return

Constraints: {'minimum': 1}

end (string, query, optional)

The ending datetime. Maximum 1 hour in past.

expand (array, query, optional)

Allows to select extra fields

fields (array, query, optional)

Allows to select only needed fields

page (integer, query, optional)

Offset, used together with count

Constraints: {'minimum': 1}

start (string, query, optional)

The datetime starting from items must be returned. Maximum 1 hour in past.

No probe data for this endpoint yet.