At its core, SyncTV is an API driven service. The APIs themselves are easy enough for developers to understand, but understanding the ecosystem is a little trickier. We've created the following tutorials to help you get your head around it.

DEPRECATED: This API is deprecated and may be removed from future releases,
use the Account Activities API instead.

This document describes the API for creating, reading, updating and
deleting media_links.

Note:

Each call to the SyncTV V2 API described in this section requires a MD5 hash signature.See the Authorization (User) API for details on generating the MD5 hash signature.

Actions

Url:

[GET] /api/v2/accounts/media_links.[xml|json]

DEPRECATED: This API is deprecated and may be removed from future releases,
use the Account Activities API instead.

Returns a list of the currently authorized account's media links.

Required Arguments:

(Integer)access_id
—

Access id returned from Authorization (User) client_authorize.

(String)signature
—

MD5 hash encoded string of query parameters.

Example Request

The following example returns a list of the currently authorized account's media links.
[GET] https://service_name.synctv.com/api/v2/accounts/media_links.xml?access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d

Request Field:

(Integer)offset
— Used for pagination of response data (Default: 25 items per response) Specifies the offset of the next block of data to receive.

Url:

DEPRECATED: This API is deprecated and may be removed from future releases,
use the Account Activities API instead.

Returns a count of the currently authorized account's media links.

Required Arguments:

(Integer)access_id
—

Access id returned from Authorization (User) client_authorize.

(String)signature
—

MD5 hash encoded string of query parameters.

Example Request

The following example returns a count of the current account's media links.
[GET] https://service_name.synctv.com/api/v2/accounts/media_links/count.xml?access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d

Request Field:

(Integer)offset
— Used for pagination of response data (Default: 25 items per response) Specifies the offset of the next block of data to receive.

Url:

DEPRECATED: This API is deprecated and may be removed from future releases,
use the Account Activities API instead.

Creates a new media link between the currently authorized account and the
specified media object.

Required Arguments:

(Integer)access_id
—

Access id returned from Authorization (User) client_authorize.

(String)signature
—

MD5 hash encoded string of query parameters.

(Integer)media_link[media_id]
—

Unique identifier of the linked to media object.

(Integer)media_link[kind]
—

Kind of media link (1 = Favorite, 2 = Rating).

(Integer)media_link[int_value]
—

(Required only if kind == 2) The rating value associated with this link.

Example Request

The following URL creates a new account media link that links the current account to the media object with an id = 123.
[POST] https://service_name.synctv.com/api/v2/accounts/media_links.xml?media_link[media_id]=123&access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d

Url:

DEPRECATED: This API is deprecated and may be removed from future releases,
use the Account Activities API instead.

Updates the specified media link.

Note:

The kind attribute cannot be updated, but if it is set to 2, the int value must be updated.

Note:

This will return only success or failure, no content.

Required Arguments:

(Integer)access_id
—

Access id returned from Authorization (User) client_authorize.

(String)signature
—

MD5 hash encoded string of query parameters.

Example Request

The following URL updates the specified account media link and links it to the media_id 123 instead.
[PUT] https://service_name.synctv.com/api/v2/accounts/media_links/123.xml?media_link[media_id]=321&access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d

Request Field:

(Integer)media_link[media_id]
— Unique identifier of the linked to media object.