v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB

Top Assets

Get top assets for a user

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

Retrieves a ranked list of top asset scores associated with a specific user, based on impressions data.

get/api/v1/impressions/topassets/user/{gcid}

Path parameters

gcidinteger required

The unique identifier (GCID) of the user whose top assets should be retrieved

Headers

x-request-idstring uuid required

Example:2afd4d96-e293-4e80-a490-cab47615aac9

A unique request identifier.

x-api-keystring password required

Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required

Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Response

Successfully retrieved top asset scores for the user

idinteger

The unique identifier of the asset

scorenumber float

The impressions-based score of the asset for the given user

targetTypeinteger

The type of the target entity the score is associated with

Example response

[
  {
    "id": 1001,
    "score": 0.87,
    "targetType": 1
  }
]