Coub Metadata API

Action subjects data endpoint provides following metadata:

  • channels that liked a coub;
  • channels that recoubed a coub;
  • channel that a channel follows;
  • channels that follow a channel.

Channels that liked a coub

Resource endpoint:

GET /api/v2/action_subjects_data/coub_likes_list

Request parameters:

  • id (integer) — the id of the required coub.
  • page (integer) — the number of the page containing results (by default is set to 1).

Request example:

GET /api/v2/action_subjects_data/coub_likes_list?id=52415&page=1

Response format:

The Coub server responses to a request with a JSON, contains following fields:

  • page (integer) — the number of the required page;
  • total_pages (integer) — the number of all pages;
  • channels (array) — the array of channel small JSONs.

Response example

{
   "page":"1",
   "total_pages":"4",
   "channels":[channel small JSONs]
}

Channels that recoubed a coub

Resource endpoint:

GET /api/v2/action_subjects_data/recoubs_list

Request parameters:

  • id (integer) — the id of the required coub;
  • page (integer) — the number of the page containing results (by default is set to 1).

Request example:

GET /api/v2/action_subjects_data/recoubs_list?id=52415&ids[]=1094523&page=1

Response format:

The Coub server responses to a request with a JSON, contains following fields:

  • page (integer) — the number of the required page;
  • total_pages (integer) — the number of all pages;
  • channels (array) — the array of channel small JSONs.

Response example

{
   "page":"1",
   "total_pages":"4",
   "channels":[channel small JSONs]
}

Channels that a channel follows

Resource endpoint:

GET /api/v2/action_subjects_data/followings_list

Request parameters:

  • id (integer) — the id of the required coub.
  • page (integer) — the number of the page containing results (by default is set to 1).

Request example:

GET /api/v2/action_subjects_data/followings_list?id=52415&page=2

Response format:

The Coub server responses to a request with a JSON, contains following fields:

  • page (integer) — the number of the required page;
  • total_pages (integer) — the number of all pages;
  • channels (array) — the array of channel small JSONs.

Response example

{
   "page":"2",
   "total_pages":"2",
   "channels":[channel small JSONs]
}

Channels that follow a channel.

Resource endpoint:

GET /api/v2/action_subjects_data/followers_list

Request parameters:

  • id (integer) — the id of the required coub;
  • ids[] (array) — the array of required channels, optional parameter;
  • page (integer) — the number of the page containing results (by default is set to 1).

Request example:

GET /api/v2/action_subjects_data/followers_list?id=52415&page=2

Response format:

The Coub server responses to a request with a JSON that contains following fields:

  • page (integer) — the number of the required page;
  • total_pages (integer) — the number of all pages;
  • channels (array) — array of channel small JSONs.

Response example

{
   "page":"2",
   "total_pages":"2",
   "channels":[channel small JSONs]
}