Category Resources

GET /categories/availability

Returns the terms in the availability category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

+ Example:

Request
GET /categories/availability HTTP/1.1
Host: openapi.lovefilm.com
Response
200 OK
Content-Type: application/xml;charset=UTF-8
 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<category_scheme>
<category_items>
<term>available</term>
<term>unavailable</term>
<term>quarantined</term>
</category_items>
</category_scheme>

GET /categories/estimated_wait

Returns the terms in the estimated wait category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

+ Example:

Request
GET /categories/estimated_wait HTTP/1.1
Host: openapi.lovefilm.com
Response
200 OK
Content-Type: application/xml;charset=UTF-8
 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<category_scheme>
<category_items>
<term>short</term>
<term>long</term>
<term>normal</term>
</category_items>
</category_scheme>

GET /categories/languages/main

Returns the terms in the languages/main category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/languages/hearing_impaired

Returns the terms in the languages/hearing_impaired category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/languages/dubbed

Returns the terms in the languages/dubbed category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/certificates/bbfc

Returns the terms in the certificates/bbfc category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/certificates/pegi

Returns the terms in the certificates/pegi category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/genres

Returns the terms in the genres category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/genres/games

Returns the terms in the genres category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/genres/video

Returns the terms in the genres category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/catalog

Returns the terms in the catalog category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/format

Returns the terms in the format category.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/roles

Returns the supported roles for catalog contributors.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/purchases

Returns the supported purchase types for catalog items.

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

GET /categories/collections/lists

Returns the named list of collections.

GET /categories/recommendation_source

Returns the reasons a product may have been recommended to a user.

  • ratings - Based on other titles the user has rated
  • selection - Based on other titles the user has rented
  • editorial - Editorially selected for the user
  • watch_rental_list_item_now - Digital version of a title in the user's rental list that is currently available to watch instantly online

Attributes in Response
AttributeTypeDescription
category_itemslistlist of terms in the category

version 4 as of 3 years ago by Portal Maintainer

3 Comments

  1. Dan Diplo – 3 years ago

    Would it be possible to filter category formats by video or game, in the same way that genres are filtered? i.e. add a couple of extra methods:

    GET /categories/format/video

    GET /categories/format/games

    That way you can easily limit a video search to video formats and a game search to game formats.

  2. Mark Morgan – 3 years ago

    Heya Dan,

    A good idea, I'll add that to the todo list.

    However, you can get much of the same result, by adding a refine=genre to the catalog call that you're making (ie, /catalog/games?refine=genre ). That'll tell you all of the possible genres for any of the items under it. If just looking for the list, you'll likely want to add an 'items_per_page=0' parameter to it, which will return no items (and return quicker, as a result), but will still give the same refine result.

    Mark.

  3. Mark Morgan – 3 years ago

    Er, s/genre/format/ in the above, and it'll answer the question asked. :)

    Mark.

Please sign in to post a comment.