Skip to main content
POST
Serving recommendation

Path Parameters

tagid
string<uuid>
required

The ID of the ad unit.

Get from the advertising manager.

Body

application/json

RecoRequest is used for requesting a recommendation.

RecoRequest is used for requesting a recommendation.

app
object | null

App object for the current serving request.

device
object | null

Device object for the current serving request.

Example:

null

filter
any
seed_item_id
string | null
site
object | null

Site object for the current serving request.

user
object | null

User object for the current serving request.

Example:

Response

Successfully served recommendation

items
object[]
required

Recommended items.

version
string
required

Version of the SDK API.

errorcode
string | null

Error code if the request failed.

ext
any

Optional A2 specific extensions.

tracking_token
string | null

Token identifying this recommendation result, echoed back on tracking calls. Absent on error responses.

user
object | null

Echoed User object from the ad request.