Meride API - Facebook video - Read

This page explains how to read the content Facebook video.

GET http://API_DOMAIN/rest/facebookvideo.{format}

Attributes

No parameter

Response

A collection / array of elements

Field	Value	Description
id	string	Object ID
nome	string	Il nome del sito proprietario del video
title	string	Il titolo della condivisione
description	string	La descrizione della condivisione
url_redirect	string	URL al quale l'utente verrà rediretto al click del link della condivisione su Facebook
url_condivisione	string	URL da usare per la pubblicazione del video su Facebook
data_inserimento	string	The create date that follows the format Y-m-d H:i:s `Y(year)` `m(month)` `d(day)` `H(hours)` `i(minutes)` `s(seconds)`
embed	embed	L'oggetto Embed associato
preroll	addart	Il preroll utilizzato nel player Flash per utenti desktop. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
postroll	addart	Il postroll utilizzato nel player Flash per utenti desktop
overlay_initial	addart	L'overlay iniziale utilizzato nel player Flash per utenti desktop
overlay_main	addart	L'overlay principale utilizzato nel player Flash per utenti desktop
html5_preroll	addart	Il preroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
html5_postroll	addart	Il postroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_initial	addart	L'overlay iniziale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_main	addart	L'overlay principale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.

Example of a curl request

curl -i -H "Accept: application/json" -H "access_token: Zuqk4nX6SfiaL20cO6np2i29Xyhn6NCW8T636UZPZ8QA0GDFDRUvZNuNbB08ft" -X GET http://API_DOMAIN/rest/facebookvideo.json

Example of a JSON response

[
    ...
{
   "id":"1",
    "nome":"Site name",
    "titolo":"Condivisione title",
    "descrizione":"Condivisione description",
    "url_redirect":"http:\/\/mysitename.com\/detail.html"
    "url_condivisione":"http:\/\/net-storage.meride.tv\/meride\/embed_facebook_video\/html\/folder1\/1\/1.html",
    "data_inserimento":"2012-09-21 20:26:18",
    "embed":{
        "id":"39",
        "titolo":"Video title",
        "descrizione_breve":"",
        "descrizione":"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod",
        "tags":"",
        "skin":"default",
        "data_creazione":"2012-09-24 09:12:49",
        "width":"540",
        "height":"302",
        "autoplay":"1",
        "skip_preroll":"",
        "skip_time":"",
        "setting_volume" : "-1",
        "code":"<div class=\"meride-video-container\" id=\"meride-video-container\" data-embed=\"39\" data-customer=\"_customerid\" data-nfs=\"_customernfs\" data-width=\"540\" data-height=\"302\" data-autoplay=\"true\"><\/div>\r\n<script src=\"http:\/\/origin-mediawebink.meride.tv\/scripts\/0.1\/embed.js\"><\/script>",
        "video":{
            "id":"107",
            "titolo":"Super Mario",
            "url_flash":"http:\/\/example.com\/z\/mario_demo.smil\/manifest.f4m",
            "url_iphone":"http:\/\/example.com\/i\/mario_demo,200,500,1200,.mp4.csmil\/master.m3u8",
            "descrizione_breve":"Super Mario Bros. System",
            "descrizione":"Lorem ipsum dolor sit amet, consectetur",
            "tags":"Nintendo, Arcade",
            "video_disponibile":"1",
            "data_inserimento":"2012-09-21 18:01:16",
            "preview_image":"http:\/\/example.com\/meride\/video\/images\/folder1\/28\/super_mario.jpg"
        },
        "preroll":{
            "tipo":"dart",
            "id":"2",
            "titolo":"Google dart",
            "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
            "tags":"lorem, ipsum",
            "descrizione":"Lorem ispum dolor sit amet",
            "data_inserimento":"2012-09-21 20:26:18"
        },
        "postroll":null,
        "comscore_account" : {
            "id":"1",
            "titolo":"Comscore title",
            "clientid":"14267511",
            "predefinito":"1",
            "descrizione":null,
            "data_inserimento":"2013-02-06 17:11:03"
        },
        "nielsen_account" : null
    }
    "preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "postroll":null,
    "overlay_initial":{
        "tipo_adv":"dart",
        "id":"59",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising2.xml",
        "descrizione":"",
        "data_inserimento":"2012-12-17 11:38:26",
        "stay_time":"15"
    },
    "overlay_main":null,
    "html5_preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "html5_postroll":null,
    "html5_overlay_initial":null,
    "html5_overlay_main":{
        "tipo_adv":"dart",
        "id":"33",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising3.xml",
        "descrizione":"",
        "data_inserimento":"2012-05-23 18:26:20",
        "fixed":"0",
        "stay_time":"15",
        "delay_time":"20",
        "max_width":"728",
        "max_height":"90"
    },
}
    ...
]

GET http://API_DOMAIN/rest/facebookvideo/{resource-id}.{format}

{resource-id}: the object ID

Attributes

No parameter

Response

Field	Value	Description
id	string	Object ID
nome	string	Il nome del sito proprietario del video
title	string	Il titolo della condivisione
description	string	La descrizione della condivisione
url_redirect	string	URL al quale l'utente verrà rediretto al click del link della condivisione su Facebook
url_condivisione	string	URL da usare per la pubblicazione del video su Facebook
data_inserimento	string	The create date that follows the format Y-m-d H:i:s `Y(year)` `m(month)` `d(day)` `H(hours)` `i(minutes)` `s(seconds)`
embed	embed	L'oggetto Embed associato
preroll	addart	Il preroll utilizzato nel player Flash per utenti desktop. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
postroll	addart	Il postroll utilizzato nel player Flash per utenti desktop
overlay_initial	addart	L'overlay iniziale utilizzato nel player Flash per utenti desktop
overlay_main	addart	L'overlay principale utilizzato nel player Flash per utenti desktop
html5_preroll	addart	Il preroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
html5_postroll	addart	Il postroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_initial	addart	L'overlay iniziale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_main	addart	L'overlay principale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.

Example of a curl request

curl -i -H "Accept: application/json" -H "access_token: Zuqk4nX6SfiaL20cO6np2i29Xyhn6NCW8T636UZPZ8QA0GDFDRUvZNuNbB08ft" -X GET http://API_DOMAIN/rest/facebookvideo/1.json

Example of a JSON response

[
    ...
{
    "id":"1",
    "nome":"Site name",
    "titolo":"Condivisione title",
    "descrizione":"Condivisione description",
    "url_redirect":"http:\/\/mysitename.com\/detail.html"
    "url_condivisione":"http:\/\/net-storage.meride.tv\/meride\/embed_facebook_video\/html\/folder1\/1\/1.html",
    "data_inserimento":"2012-09-21 20:26:18",
    "embed":{
        "id":"39",
        "titolo":"Video title",
        "descrizione_breve":"",
        "descrizione":"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod",
        "tags":"",
        "skin":"default",
        "data_creazione":"2012-09-24 09:12:49",
        "width":"540",
        "height":"302",
        "autoplay":"1",
        "skip_preroll":"",
        "skip_time":"",
        "setting_volume" : "-1",
        "code":"<div class=\"meride-video-container\" id=\"meride-video-container\" data-embed=\"39\" data-customer=\"_customerid\" data-nfs=\"_customernfs\" data-width=\"540\" data-height=\"302\" data-autoplay=\"true\"><\/div>\r\n<script src=\"http:\/\/origin-mediawebink.meride.tv\/scripts\/0.1\/embed.js\"><\/script>",
        "video":{
            "id":"107",
            "titolo":"Super Mario",
            "url_flash":"http:\/\/example.com\/z\/mario_demo.smil\/manifest.f4m",
            "url_iphone":"http:\/\/example.com\/i\/mario_demo,200,500,1200,.mp4.csmil\/master.m3u8",
            "descrizione_breve":"Super Mario Bros. System",
            "descrizione":"Lorem ipsum dolor sit amet, consectetur",
            "tags":"Nintendo, Arcade",
            "video_disponibile":"1",
            "data_inserimento":"2012-09-21 18:01:16",
            "preview_image":"http:\/\/example.com\/meride\/video\/images\/folder1\/28\/super_mario.jpg"
        },
        "preroll":{
            "tipo":"dart",
            "id":"2",
            "titolo":"Google dart",
            "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
            "tags":"lorem, ipsum",
            "descrizione":"Lorem ispum dolor sit amet",
            "data_inserimento":"2012-09-21 20:26:18"
        },
        "postroll":null,
        "comscore_account" : {
            "id":"1",
            "titolo":"Comscore title",
            "clientid":"14267511",
            "predefinito":"1",
            "descrizione":null,
            "data_inserimento":"2013-02-06 17:11:03"
        },
        "nielsen_account" : null
    }
    "preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "postroll":null,
    "overlay_initial":{
        "tipo_adv":"dart",
        "id":"59",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising2.xml",
        "descrizione":"",
        "data_inserimento":"2012-12-17 11:38:26",
        "stay_time":"15"
    },
    "overlay_main":null,
    "html5_preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "html5_postroll":null,
    "html5_overlay_initial":null,
    "html5_overlay_main":{
        "tipo_adv":"dart",
        "id":"33",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising3.xml",
        "descrizione":"",
        "data_inserimento":"2012-05-23 18:26:20",
        "fixed":"0",
        "stay_time":"15",
        "delay_time":"20",
        "max_width":"728",
        "max_height":"90"
    },
}
    ...
]

GET http://API_DOMAIN/rest/facebookvideo.{format}

Note The option must be specified -G in the call with the curl command so that the search parameters are passed correctly

Attributes

Attribute	Value	Mandatory
search_string	A non-empty string that will be searched for in the title	NO
search_in_description	`1` if you want to also search in the description. `0` otherwise	NO
search_date_min	Format DATETIME `aaaa-mm-gg`. Cerca tutte le condivisioni a partire dalla data specificata	NO
search_date_max	Format DATETIME `aaaa-mm-gg`. Cerca tutte le condivisioni fino alla data specificata	NO
search_embed_id	Embed id. Cerca tutte le condivisioni per l'embed specificato	NO
search_limit	Intero maggiore di 0. Restituisce n condivisioni per la ricerca specificata.	NO
search_offset	Intero maggiore di 0. Restituisce le condivisioni a partire dal numero specificato.	NO

Response

A collection / array of elements

Field	Value	Description
id	string	Object ID
nome	string	Il nome del sito proprietario del video
title	string	Il titolo della condivisione
description	string	La descrizione della condivisione
url_redirect	string	URL al quale l'utente verrà rediretto al click del link della condivisione su Facebook
url_condivisione	string	URL da usare per la pubblicazione del video su Facebook
data_inserimento	string	The create date that follows the format Y-m-d H:i:s `Y(year)` `m(month)` `d(day)` `H(hours)` `i(minutes)` `s(seconds)`
embed	embed	L'oggetto Embed associato
preroll	addart	Il preroll utilizzato nel player Flash per utenti desktop. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
postroll	addart	Il postroll utilizzato nel player Flash per utenti desktop
overlay_initial	addart	L'overlay iniziale utilizzato nel player Flash per utenti desktop
overlay_main	addart	L'overlay principale utilizzato nel player Flash per utenti desktop
html5_preroll	addart	Il preroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
html5_postroll	addart	Il postroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_initial	addart	L'overlay iniziale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_main	addart	L'overlay principale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.

Example of a curl request

curl -i -G -H "Accept: application/json" -H "access_token: Zuqk4nX6SfiaL20cO6np2i29Xyhn6NCW8T636UZPZ8QA0GDFDRUvZNuNbB08ft" -X GET -d "search_embed_id=39&search_limit=5" http://API_DOMAIN/rest/facebookvideo.json

Note Cerca le ultime 5 condivisioni inserite per l'embed con id 39

Example of a JSON response

[
    ...
{
    "id":"1",
    "nome":"Site name",
    "titolo":"Condivisione title",
    "descrizione":"Condivisione description",
    "url_redirect":"http:\/\/mysitename.com\/detail.html"
    "url_condivisione":"http:\/\/net-storage.meride.tv\/meride\/embed_facebook_video\/html\/folder1\/1\/1.html",
    "data_inserimento":"2012-09-21 20:26:18",
    "embed":{
        "id":"39",
        "titolo":"Video title",
        "descrizione_breve":"",
        "descrizione":"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod",
        "tags":"",
        "skin":"default",
        "data_creazione":"2012-09-24 09:12:49",
        "width":"540",
        "height":"302",
        "autoplay":"1",
        "skip_preroll":"",
        "skip_time":"",
        "setting_volume" : "-1",
        "code":"<div class=\"meride-video-container\" id=\"meride-video-container\" data-embed=\"39\" data-customer=\"_customerid\" data-nfs=\"_customernfs\" data-width=\"540\" data-height=\"302\" data-autoplay=\"true\"><\/div>\r\n<script src=\"http:\/\/origin-mediawebink.meride.tv\/scripts\/0.1\/embed.js\"><\/script>",
        "video":{
            "id":"107",
            "titolo":"Super Mario",
            "url_flash":"http:\/\/example.com\/z\/mario_demo.smil\/manifest.f4m",
            "url_iphone":"http:\/\/example.com\/i\/mario_demo,200,500,1200,.mp4.csmil\/master.m3u8",
            "descrizione_breve":"Super Mario Bros. System",
            "descrizione":"Lorem ipsum dolor sit amet, consectetur",
            "tags":"Nintendo, Arcade",
            "video_disponibile":"1",
            "data_inserimento":"2012-09-21 18:01:16",
            "preview_image":"http:\/\/example.com\/meride\/video\/images\/folder1\/28\/super_mario.jpg"
        },
        "preroll":{
            "tipo":"dart",
            "id":"2",
            "titolo":"Google dart",
            "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
            "tags":"lorem, ipsum",
            "descrizione":"Lorem ispum dolor sit amet",
            "data_inserimento":"2012-09-21 20:26:18"
        },
        "postroll":null,
        "comscore_account" : {
            "id":"1",
            "titolo":"Comscore title",
            "clientid":"14267511",
            "predefinito":"1",
            "descrizione":null,
            "data_inserimento":"2013-02-06 17:11:03"
        },
        "nielsen_account" : null
    }
    "preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "postroll":null,
    "overlay_initial":{
        "tipo_adv":"dart",
        "id":"59",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising2.xml",
        "descrizione":"",
        "data_inserimento":"2012-12-17 11:38:26",
        "stay_time":"15"
    },
    "overlay_main":null,
    "html5_preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "html5_postroll":null,
    "html5_overlay_initial":null,
    "html5_overlay_main":{
        "tipo_adv":"dart",
        "id":"33",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising3.xml",
        "descrizione":"",
        "data_inserimento":"2012-05-23 18:26:20",
        "fixed":"0",
        "stay_time":"15",
        "delay_time":"20",
        "max_width":"728",
        "max_height":"90"
    },
}
    ...
]