Website logo

Search the Blu-ray catalogue

Searches the Trade Me Blu-ray catalogue for movie titles.

URL: https://api.trademe.co.nz/v1/bluray/find.{file_format}
HTTP Method: GET
Requires Authentication? No
Permission Required: Public
Supported Formats: XML, JSON
Rate Limited? No

URL parameters

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Query String parameters

search String (optional)

The partial title to search for.

Returns

<MovieTitles>

A list containing movies which match the title parameter.

TotalCount Integer

The total number of results in the collection. Can be larger than the number of returned results.

Page Integer

The index of the current page of results (starts at 1).

PageSize Integer

The number of results in the current page.

List Collection of <MovieTitle> or null

A list of the results in the current page.

Name String or null

The name of the movie title.

Id Integer

The catalogue ID for this title.

MovieYear Integer

The year the movie was released.

ReleaseDate DateTime

The release date of the film.

Example XML Response (switch to JSON)

<MovieTitles xmlns="http://api.trademe.co.nz/v1">
  <TotalCount>123</TotalCount>
  <Page>123</Page>
  <PageSize>123</PageSize>
  <List>
    <MovieTitle>
      <Name>ABC</Name>
      <Id>123</Id>
      <MovieYear>123</MovieYear>
      <ReleaseDate>2018-01-01T00:00:00Z</ReleaseDate>
    </MovieTitle>
    <MovieTitle>
      <Name>ABC</Name>
      <Id>123</Id>
      <MovieYear>123</MovieYear>
      <ReleaseDate>2018-01-01T00:00:00Z</ReleaseDate>
    </MovieTitle>
  </List>
</MovieTitles>

Example JSON Response (switch to XML)

{
  "TotalCount": 123,
  "Page": 123,
  "PageSize": 123,
  "List": [
    {
      "Name": "ABC",
      "Id": 123,
      "MovieYear": 123,
      "ReleaseDate": "\/Date(1514764800)\/"
    },
    {
      "Name": "ABC",
      "Id": 123,
      "MovieYear": 123,
      "ReleaseDate": "\/Date(1514764800)\/"
    }
  ]
}