ODK API Portal
한국어
  • Overview
  • MediaIO
  • Continue Watching
  • Player Event
  • Deprecated
  • Recent changes
Information
carousel-group
Carousel
category-channels
category-navigation
category
channels
consent
content
Continue Watching
cover
deletion-request
device-data
Favorites
multichannel
Onboarding
parental-control
Amasian Parental PIN
playback
policy
recommendation
    Retrieve popular content recommendationsgetGet more to watch channel itemsgetRetrieve similar content recommendations (More to Watch)get
search
season
series
service-config
Schemas
powered by Zudoku
ODX API v4
ODX API v4

recommendation


Retrieve popular content recommendations

GET
https://odkmedia.io
/odx/api/v4/recommendation/

Retrieves recommendation lists based on popularity for series or content. Caching is applied.

Retrieve popular content recommendations › query Parameters

day
​string

Popularity period (d1/d7/d30/d90, default: d30)

kids
​boolean

Kids profile. When true, only all-ages titles are returned: the resolved age rating (content -> season -> series) must be Vietnam 'P' or unset. Every other rating, 'K' included, is filtered out. Series and seasons are omitted when none of their episodes is all-ages. The Kids-Profile: true header does the same thing.

size
​integer

Number of recommendations to return (default: 60)

type
​string

Recommendation type (series/content)

Retrieve popular content recommendations › Responses

​Recommend[]
Serializer representing recommendation content information.
Recommend
​object · readOnly

Recommendation data containing view and info sections

Example: {"info":{"content_id":123,"content_slug":"example-movie","content_type":"movie","title":"Example Movie"},"view":{"badges":{"bottom_full":"newly-added","bottom_left":null,"bottom_right":null,"top_left":"dub","top_right":null},"image":{"orientation":"landscape","url":"https://cdn.example.com/images/content.jpg"}}}
type
​string · readOnly
GET/odx/api/v4/recommendation/
curl https://odkmedia.io/odx/api/v4/recommendation
Example Responses
[ { "data": { "info": { "content_id": 123, "content_slug": "example-movie", "content_type": "movie", "title": "Example Movie" }, "view": { "badges": { "bottom_full": "newly-added", "bottom_left": null, "bottom_right": null, "top_left": "dub", "top_right": null }, "image": { "orientation": "landscape", "url": "https://cdn.example.com/images/content.jpg" } } }, "type": "type" } ]
json
application/json

Get more to watch channel items

GET
https://odkmedia.io
/odx/api/v4/recommendation/channel/{channel_id}/recommendations/

Retrieve paginated more to watch channel items

Get more to watch channel items › path Parameters

channel_id
​string · required
Example: 207

Get more to watch channel items › query Parameters

ordering
​string

Which field to use when ordering the results.

page
​integer

Page number for pagination

Default: 1
page_size
​integer

Number of items per page

Example: 10
search
​string

A search term.

Get more to watch channel items › Headers

did
​string

Device ID (required when slug is "favorites")

Example: 00000000-0000-4000-8000-000000000000

Get more to watch channel items › Responses

200
PaginatedAmasianItemChannelList
count
​integer
next
​string | null · uri
previous
​string | null · uri
​AmasianItemChannel[]
GET/odx/api/v4/recommendation/channel/{channel_id}/recommendations/
curl https://odkmedia.io/odx/api/v4/recommendation/channel/:channel_id/recommendations
Example Responses
{ "count": 123, "next": "http://api.example.org/accounts/?page=4", "previous": "http://api.example.org/accounts/?page=2", "results": [ { "info": { "category_slug": "category_slug", "channel_id": 0, "channel_slug": "channel_slug" }, "view": { "badges": { "bottom_left": "bottom_left", "bottom_right": "bottom_right", "top_left": "top_left", "top_right": "top_right" }, "channel_info": { "end_time": "2024-08-25T15:00:00Z", "start_time": "2024-08-25T15:00:00Z" }, "image": { "language": "language", "orientation": "orientation", "url": "https://www.example.com/path/to/resource" }, "image_url": "https://www.example.com/path/to/resource", "landing_option": "landing_option", "title": "title" } } ] }
json
application/json

Retrieve similar content recommendations (More to Watch)

GET
https://odkmedia.io
/odx/api/v4/recommendation/vod/{content_identifier}/recommendations/
Code
Retrieves similar content recommendations based on category overlap. ### Path parameter: `content_identifier` | Value format | Type | Resolution | |---|---|---| | `"123"` (numeric) | Integer string | AmasianContent PK | | `"my-content-slug"` (non-numeric) | Slug string | AmasianContent slug | ### Recommendation logic - Episode slug/ID → resolves to parent Series for recommendation - Movie slug/ID → Movie-to-Movie recommendation - Category overlap count (3+, 2, 1) then 30-day popularity rank Returns up to 30 items. Fills remaining slots with popular content of the same type.

Retrieve similar content recommendations (More to Watch) › path Parameters

content_identifier
​string · required

AmasianContent PK (numeric) or AmasianContent slug (non-numeric).

Example: inuyashiki-last-hero-e1

Retrieve similar content recommendations (More to Watch) › query Parameters

kids
​boolean

Kids profile. When true, only all-ages titles are returned: the resolved age rating (content -> season -> series) must be Vietnam 'P' or unset. Every other rating, 'K' included, is filtered out. Series and seasons are omitted when none of their episodes is all-ages. The Kids-Profile: true header does the same thing.

Retrieve similar content recommendations (More to Watch) › Responses

​Recommend[]
Serializer representing recommendation content information.
Recommend
​object · readOnly

Recommendation data containing view and info sections

Example: {"info":{"content_id":123,"content_slug":"example-movie","content_type":"movie","title":"Example Movie"},"view":{"badges":{"bottom_full":"newly-added","bottom_left":null,"bottom_right":null,"top_left":"dub","top_right":null},"image":{"orientation":"landscape","url":"https://cdn.example.com/images/content.jpg"}}}
type
​string · readOnly
GET/odx/api/v4/recommendation/vod/{content_identifier}/recommendations/
curl https://odkmedia.io/odx/api/v4/recommendation/vod/:content_identifier/recommendations
Example Responses
[ { "data": { "info": { "content_id": 123, "content_slug": "example-movie", "content_type": "movie", "title": "Example Movie" }, "view": { "badges": { "bottom_full": "newly-added", "bottom_left": null, "bottom_right": null, "top_left": "dub", "top_right": null }, "image": { "orientation": "landscape", "url": "https://cdn.example.com/images/content.jpg" } } }, "type": "type" } ]
json
application/json

policysearch