Rocket Services

britbox · Media

Media No Auth Free & Open entertainment

An Orchestration Layer that takes ISL services and packages them in a more targeted way for front-end applications. This in turn makes client integration easier and reduces the complexity and size of front-end applications. Rocket is also customisable - allowing UI engineers to ‘remix’ the existing back-end services into something that best suits the application they are developing.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET getAppConfig

Get the global configuration for an application. Should be called during app statup. This includes things like device and playback rules, classifications, sitemap and subscriptions. You have the option to select specific configuration objects using the 'include' parameter, or if unspecified, getti

https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/config?ff=example&sub=example&lang=en&device=web_browser&system=example&include=example&segments=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/config?ff=example&sub=example&lang=en&device=web_browser&system=example&include=example&segments=example"

import requests
params = {
    "ff": "example",
    "sub": "example",
    "lang": "en",
    "device": "web_browser",
    "system": "example",
    "include": "example",
    "segments": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/config",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/config');
url.searchParams.set('ff', 'example');
url.searchParams.set('sub', 'example');
url.searchParams.set('lang', 'en');
url.searchParams.set('device', 'web_browser');
url.searchParams.set('system', 'example');
url.searchParams.set('include', 'example');
url.searchParams.set('segments', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/config")
	q := baseURL.Query()
	q.Set("ff", "example")
	q.Set("sub", "example")
	q.Set("lang", "en")
	q.Set("device", "web_browser")
	q.Set("system", "example")
	q.Set("include", "example")
	q.Set("segments", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/config")
uri.query = URI.encode_www_form({
  "ff" => "example",
  "sub" => "example",
  "lang" => "en",
  "device" => "web_browser",
  "system" => "example",
  "include" => "example",
  "segments" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/config?" . http_build_query([
    "ff" => "example",
    "sub" => "example",
    "lang" => "en",
    "device" => "web_browser",
    "system" => "example",
    "include" => "example",
    "segments" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET getLists

Returns an array of item lists with their first page of content resolved.

https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/lists?ff=example&ids=example&sub=example&lang=en&order=desc&device=web_browser&order_by=a-z&segments=example&item_type=movie&page_size=12&max_rating=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/lists?ff=example&ids=example&sub=example&lang=en&order=desc&device=web_browser&order_by=a-z&segments=example&item_type=movie&page_size=12&max_rating=example"

import requests
params = {
    "ff": "example",
    "ids": "example",
    "sub": "example",
    "lang": "en",
    "order": "desc",
    "device": "web_browser",
    "order_by": "a-z",
    "segments": "example",
    "item_type": "movie",
    "page_size": "12",
    "max_rating": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/lists",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/lists');
url.searchParams.set('ff', 'example');
url.searchParams.set('ids', 'example');
url.searchParams.set('sub', 'example');
url.searchParams.set('lang', 'en');
url.searchParams.set('order', 'desc');
url.searchParams.set('device', 'web_browser');
url.searchParams.set('order_by', 'a-z');
url.searchParams.set('segments', 'example');
url.searchParams.set('item_type', 'movie');
url.searchParams.set('page_size', '12');
url.searchParams.set('max_rating', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/lists")
	q := baseURL.Query()
	q.Set("ff", "example")
	q.Set("ids", "example")
	q.Set("sub", "example")
	q.Set("lang", "en")
	q.Set("order", "desc")
	q.Set("device", "web_browser")
	q.Set("order_by", "a-z")
	q.Set("segments", "example")
	q.Set("item_type", "movie")
	q.Set("page_size", "12")
	q.Set("max_rating", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/lists")
uri.query = URI.encode_www_form({
  "ff" => "example",
  "ids" => "example",
  "sub" => "example",
  "lang" => "en",
  "order" => "desc",
  "device" => "web_browser",
  "order_by" => "a-z",
  "segments" => "example",
  "item_type" => "movie",
  "page_size" => "12",
  "max_rating" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/lists?" . http_build_query([
    "ff" => "example",
    "ids" => "example",
    "sub" => "example",
    "lang" => "en",
    "order" => "desc",
    "device" => "web_browser",
    "order_by" => "a-z",
    "segments" => "example",
    "item_type" => "movie",
    "page_size" => "12",
    "max_rating" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET getPage

Returns a page with the specified id. If targeting the search page you must url encode the search term as a parameter using the `q` key. For example if your browser path looks like `/search?q=the` then what you pass to this endpoint would look like `/page?path=/search%3Fq%3Dthe`.

https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/page?ff=example&sub=example&lang=en&path=example&device=web_browser&segments=example&max_rating=example&list_page_size=12&max_list_prefetch=2&text_entry_format=markdown&item_detail_expand=all&list_page_size_large=50&item_detail_select_season=first

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/page?ff=example&sub=example&lang=en&path=example&device=web_browser&segments=example&max_rating=example&list_page_size=12&max_list_prefetch=2&text_entry_format=markdown&item_detail_expand=all&list_page_size_large=50&item_detail_select_season=first"

import requests
params = {
    "ff": "example",
    "sub": "example",
    "lang": "en",
    "path": "example",
    "device": "web_browser",
    "segments": "example",
    "max_rating": "example",
    "list_page_size": "12",
    "max_list_prefetch": "2",
    "text_entry_format": "markdown",
    "item_detail_expand": "all",
    "list_page_size_large": "50",
    "item_detail_select_season": "first"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/page",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/page');
url.searchParams.set('ff', 'example');
url.searchParams.set('sub', 'example');
url.searchParams.set('lang', 'en');
url.searchParams.set('path', 'example');
url.searchParams.set('device', 'web_browser');
url.searchParams.set('segments', 'example');
url.searchParams.set('max_rating', 'example');
url.searchParams.set('list_page_size', '12');
url.searchParams.set('max_list_prefetch', '2');
url.searchParams.set('text_entry_format', 'markdown');
url.searchParams.set('item_detail_expand', 'all');
url.searchParams.set('list_page_size_large', '50');
url.searchParams.set('item_detail_select_season', 'first');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/page")
	q := baseURL.Query()
	q.Set("ff", "example")
	q.Set("sub", "example")
	q.Set("lang", "en")
	q.Set("path", "example")
	q.Set("device", "web_browser")
	q.Set("segments", "example")
	q.Set("max_rating", "example")
	q.Set("list_page_size", "12")
	q.Set("max_list_prefetch", "2")
	q.Set("text_entry_format", "markdown")
	q.Set("item_detail_expand", "all")
	q.Set("list_page_size_large", "50")
	q.Set("item_detail_select_season", "first")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/page")
uri.query = URI.encode_www_form({
  "ff" => "example",
  "sub" => "example",
  "lang" => "en",
  "path" => "example",
  "device" => "web_browser",
  "segments" => "example",
  "max_rating" => "example",
  "list_page_size" => "12",
  "max_list_prefetch" => "2",
  "text_entry_format" => "markdown",
  "item_detail_expand" => "all",
  "list_page_size_large" => "50",
  "item_detail_select_season" => "first"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/britbox.co.uk/3.730.300-ref-1-39-0/page?" . http_build_query([
    "ff" => "example",
    "sub" => "example",
    "lang" => "en",
    "path" => "example",
    "device" => "web_browser",
    "segments" => "example",
    "max_rating" => "example",
    "list_page_size" => "12",
    "max_list_prefetch" => "2",
    "text_entry_format" => "markdown",
    "item_detail_expand" => "all",
    "list_page_size_large" => "50",
    "item_detail_select_season" => "first"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Rocket Services?

Rocket Services is a Media API. Developers commonly use media APIs for:

storing and delivering images, video, and audio
building digital asset management and media libraries
transcoding and optimising media for the web
adding video streaming and playback to your app
automating content tagging and metadata extraction

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Rocket Services is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗