Content

Retrieve content information by content_id

Devuelve la información completa de un contenido.

GET/api/v4/content/contentId/:id?access_token=

Required Params

Param	Tipo
`access_token`	string

Response example

{
    "content_id": 100000003,
    "content_type": "video",
    "sharing_url": null,
    "name": "Prueba subida",
    "pid": 1,
    "gid": 1,
    "duration": 3000,
    "audio": false,
    "geoblock": null,
    "plays": 0,
    "impressions": 0,
    "preroll": 0,
    "midroll": 0,
    "postroll": 0,
    "referrer": null,
    "created_by": "Admin",
    "created_at": "2026-08-16 15:21:47",
    "transcoder": "Genoa Transcoder",
    "status": "enabled",
    "description": null,
    "live_url": null,
    "comscore": [],
    "tags": [],
    "m3u8": null,
    "qualities": [
        {
            "quality": "240P",
            "thumb": "https://tu-spi/media/thumbs/xxx.jpg",
            "preview": "https://.../xxx_240P.mp4",
            "mp4": "https://.../xxx_240P.mp4",
            "resolution": "320x180"
        }
    ],
    "resolution": "854x480",
    "categories": [1]
}

Diferencias vs v3: plays/impressions/preroll/midroll/postroll son contadores reales que incrementa el player (ver Player → Genoa Pass Data) — arrancan en 0 y crecen con el consumo real, no son placeholders. m3u8 es la URL real del manifiesto HLS que arma el Packager cuando existe — null solo si ese contenido nunca tuvo empaquetado HLS (por ejemplo, contenido subido en modo de prueba). gid se resuelve del group al que esté asignado el publisher (Administration → Groups) — null si el publisher no está en ningún group. content_id ahora es pid + 8 dígitos.

Update content information by content_id

Actualiza los metadatos de un contenido.

PUT/api/v4/content/contentId/:id

Body (JSON)

{
    "access_token": "...",
    "description": "Test API by JSON",
    "name": "Prueba",
    "status": "enabled",
    "tags": [{"name": "test1"}, {"name": "test2"}],
    "comscore": [{"key": "ns_st_st", "value": "TEST API 2"}],
    "geoblock": "IT",
    "sharing_url": "test123"
}

Response example

{
    "content": {
        "comscore": [{"key": "ns_st_st", "value": "TEST API 2"}],
        "description": "Test API by JSON",
        "geoblock": "IT",
        "name": "Prueba",
        "sharing_url": "test123",
        "status": "enabled",
        "tags": [{"name": "test1"}, {"name": "test2"}]
    },
    "message": "Updated info."
}

Igual a v3 — mismo body, misma forma de respuesta.

Update content thumbnail

Sube un nuevo thumbnail para el contenido.

POST/api/v4/content/thumb/contentId/:id

Required Params (multipart/form-data)

Param	Tipo
`access_token`	string
`file`	file (jpeg/png/webp)

Response example

{
    "ContentType": "image/jpeg",
    "Filename": "1-1-905dc6a5b5ee-009542b0.jpg",
    "RealFormat": "jpeg",
    "Resolution": "320x180",
    "Size": 584,
    "Status": "Successfully uploaded"
}

Igual a v3 — misma forma de respuesta, incluida la resolución real del archivo subido.

Search Contents By Pid

Busca contenido por nombre, descripción o tags dentro de un publisher.

GET/api/v4/content/search

Required Params

Param	Tipo
`access_token`	string, required
`pid`	int, required
`query`	string, required
`from`	int, opcional
`limit`	int, opcional, máximo 100, default 50

Response example

[
  {
    "name": "Prueba",
    "description": "Test API by JSON",
    "content_id": 100000003,
    "status": "enabled",
    "gid": 1,
    "group_name": "Artear",
    "publisher_id": 1,
    "publisher_name": "TN",
    "created_at": "2026-08-16T15:21:47Z",
    "created_by": "Admin",
    "content_type": "video",
    "external_id": null,
    "plays": 12,
    "impressions": 40
  }
]

Diferencias vs v3: gid/group_name salen del group real asignado al publisher (Administration → Groups), no de una cuenta fija. plays/impressions son contadores reales, null solo si nunca se reprodujo.

Get Recents Contents By Pid

Últimos contenidos de un publisher, ordenados por fecha de creación.

GET/api/v4/content/recents

Required Params

Param	Tipo
`access_token`	string, required
`pid`	int, required
`from`	int, opcional
`limit`	int, opcional, máximo 100, default 50

Misma forma de respuesta que Search.

Get Most Played Contents By Pid

Contenidos más reproducidos de un publisher.

GET/api/v4/content/most_played

Required Params

Param	Tipo
`access_token`	string, required
`pid`	int, required
`from`	int, opcional
`limit`	int, opcional, máximo 100, default 50

Misma forma de respuesta que Search. Ordenado por plays real (más reproducido primero).

Change Youtube content URL (youtube id)

Asocia un video de YouTube a un content_id.

PUT/api/v4/content/:id/youtube

Body (JSON)

Param	Tipo
`access_token`	string, required
`yt_id`	string, required

Response example

{
  "message": "Updated info."
}

Igual a v3 en la respuesta. Guarda el yt_id y marca el contenido como content_type: youtube — no hay reproductor de YouTube embebido todavía (el player muestra un link), es solo el dato guardado.