İzlesene.com - Video APİ

api'ye erişim


izlesene xml apı'sine erişim sağlamak için öncelikle bir apı hesabı açmanız gereklidir. yeni apı hesabı yaratmak veya var olan apı hesabınızı görmek için lütfen benim apı'm sayfasına bakınız. ilk defa yeni bir apı hesabı yarattığınızda, size özel bir anahtar veya uygulama kimliği atanacaktır. bu uygulama kimliği benzersiz olarak kurumunuzun uygulamasını belirlemekte ve izlesene video arama dizinine erişim izni vermektedir.

menüye dön

xml sorgusu gönderme


uygulama kimliğinizi elde ettikten sonra, apı'ye erişim ve uygulamanızı geliştirmeye başlamak için hazırsınızdır. bu apı, izlesene video arama dizinine erişim için rest-style bir ara yüz sağlamaktadır. bu yaklaşım ile, sorgular belirli parametrele içeren bir url dizisinden oluşur. bütün sorgunun basit bir url ifadesi içinde yer alıyor olmasından dolayı sorgular tarayıcının adres barından, komut satırından veya belli bir url'ye http get istemi gönderebilen herhangi bir özel programın kodu içerisinden gönderilebilir.

izlesene xml apı için tüm istem url'leri aşağıdaki apı hizmet url'si ile başlar:
http://api.izlesene.com/api_v1.php
bu url ile belirtildiği gibi, izlesene video arama apı'si için ana makine adı ‘api.izlesene.com'dur, ve hizmet adı, izlesene xml apı'nın 1.0 sürümünü temsil eden api_v1'dir.

sonrasında, bu apı hizmet url'sinin sonuna sorgunuzu standart url formatı kullanarak tanımlayan belirli parametreleri ekleyin. özellikle her bir parametre name=value formatında bir isim-değer ikilisinden oluşur. eğer istenen değer boşluk, & işareti veya eşit işareti gibi özel karakterler içermekteyse, bu özel karakterleri kabul edilebilir bir karakter betimlemesine dönüştürmek için standart bir prosedür olan url encoded (url kodlu) olmalıdır. eğer birden fazla parametre belirlemek istiyorsanız, her bir isim-değer ikilisi bir & işareti ile ayrılmalıdır. ana url parametre listesinden (?) soru işareti ile ayrılmalıdır. örnek olarak, '6sdbrz8xw6452rc3 ', ' searchvideos', ve 'araba' değerlerini 'appid', ‘func’ ve 'query' parametrelerine atayan bir sorgu göndermek için aşağıdaki ifadeyi kullanın:
http://api.izlesene.com/api_v1.php?query=araba&appid=6sdbrz8xw6452rc3...
bu sorguyu veya her hangi bir rest-style sorguyu izlesene video arama motoruna göndermek için, sadece tarayıcının adres barına yapıştırın ve return tuşuna basın. benzer olarak, bu rest-style ifade aynı zamanda izlesene xmı apı'sine bir http get istemi gönderen diğer her hangi bir yaklaşım kullanılarak da yollanabilir. örnek olarak, bu işlem komut satırından veya neredeyse her tür programlama dili ile yazılmış olabilen özel bir uygulamanın kodu içerisinden yapılabilir.
izlesene xml apı'sine yollanan her geçerli sorgunun gerekli olan 'appid' ve ‘func’ parametreleri için değerler içermelidir. appid parametresi geçerli bir uygulama kimliği değeri içermelidir. func parametresi desteklenen bir apı işlevinin adını içermelidir. bu parametre apı'ye çalıştırmak istediğiniz işlev ve almak istediğiniz sonuçlar hakkında talimat verir. tüm desteklenen işlevlerin tam bir listesi xml apı referans dokümanlarından bakılabilir. belirli apı yöntemlerine bağlı olarak, rest-style sorgu içerisinde ek seçime bağlı parametreler de belirtilebilir. lütfen tam listeyi ve her bir yöntem için desteklenen parametrelerin tanımlarını görmek için dokümantasyona bakınız.

menüye dön

sorgu cevaplarını işleme


izlesene xml apı'si, her geçerli rest-style sorguya cevap olarak bir xml formatlı mesaj geri yollayacaktır. tipik bir xml cevabı gönderilen bir sorguya denk gelen izlesene video arama dizinindeki her video için ayrıntılı metadata içerebilir. her bir cevap mesajının en üst seviye künyesi daima <izleseneresult > künyesidir, ve xml cevabı aşağıdaki temel formata sahip olacaktır:
<izleseneresult xsi:schemalocation="http://api.izlesene.com/api_v1.xsd">
<function>function name</function>
</izleseneresult>
bu örnekten de görebileceğiniz gibi, her bir cevap için belirtilen karakter kodlaması utf-8'dir ve < izleseneresult > künyesi daima < function > isimli bir yavru künye içerecektir. < function > künyesi daima bu xml cevap mesajını yaratmak için çalıştırılmış olan apı yönteminin adını içerecektir. < function > künyesine ek olarak, birçok başka alan da xml cevabı içinde geri yollanabilir. geri gönderilen belirli alanlar kullanılan apı yöntemine bağlı olarak çeşitlilik gösterecektir. her bir yönteme cevap olarak geri gönderilene desteklenen alanların tam listesi ve tanımlarını görmek için lütfen xml apı referans dokümanlarına bakınız.

menüye dön

işleme hataları


iizlesene xml apı'si geçersiz ve doğru olmayan apı aramalarına cevap olarak hata mesajları geri göndermektedir. her bir hata mesajı, <error> adlı tek bir yavru künye içeren standart bir xml cevabı olarak gönderilir. bu <error> künyesi, hatanın sayısal kodunu tanımlayan tek bir simge,kod, içerir. <error> künyesinin içeriği hatanın metinsel tanımını içerir. örnek bir hata cevabı aşağıda verilmiştir:
<?xml version="1.0" encoding="utf-8" ?>
<izleseneresult>
<error code="error number">error description.>
</izleseneresult>
bu örnekten de görebileceğiniz gibi, her bir cevap için belirtilen karakter kodlaması utf-8'dir ve < izleseneresult > künyesi daima < function > isimli bir yavru künye içerecektir. < function > künyesi daima bu xml cevap mesajını yaratmak için çalıştırılmış olan apı yönteminin adını içerecektir. < function > künyesine ek olarak, birçok başka alan da xml cevabı içinde geri yollanabilir. geri gönderilen belirli alanlar kullanılan apı yöntemine bağlı olarak çeşitlilik gösterecektir. her bir yönteme cevap olarak geri gönderilene desteklenen alanların tam listesi ve tanımlarını görmek için lütfen xml apı referans dokümanlarına bakınız.

menüye dön

temel aramalar


en basit arama sorguları bir veya boşluklarla ayrılmış daha fazla anahtar kelimeden oluşur. bu sorgulara cevap olarak, izlesene video arama hizmeti sorgu içerisindeki her bir kelimeye karşılık gelen tüm video kayıtlarını geri gönderecektir. örnek olarak,
“ankara” => “ankara” kelimesi içeren tüm videoları bulur ankara keçisi => “ankara” ve “keçisi” kelimelerini içeren tüm videoları bulur

aramanızı daha belirgin bir hale getirmek için daha fazla arama terimi kullanın. daha az belirgin hale getirmek için de daha az arama terimi kullanın. arama sorgularının büyük harf küçük harf duyarlı olmadığını ve sorgunuz içindeki genel harfler ve sayılar veya aşağıda tanımlandığı gibi özel operatörler dışındaki karakterlerin yok sayılacağını unutmayınız. aynı zamanda izlesene video arama hizmeti sadece tek bir harf veya sayı içeren sorgulara her hangi bir sonuç geri göndermeyecektir. tam bir kelime dizisi için arama yapmak tam bir kelime dizisi içeren bir video bulmak için, kelime dizisini içiren arama sorgusunu çift tırnak içine alın. örnek olarak,
“ankara keçisi” => “ankara keçisi” içeren tüm videoları bulur.

tam kelime dizisi aramaları için çift tırnak içinde yer alan hiçbir kelime, harf veya sayının yok sayılmayacağını unutmayınız.
özel operatörler ile arama yapmak izlesene video arama motoru, aramanızı iyileştirmek için kullanılabilecek dört özel operatör desteklemektedir. bunlar aşağıda tanımlanmıştır.

or

or (veya) operatörü, sorgunuz içindeki her hangi iki terim arasında, arama sonuçları içinde ikisinden birinin yer alacağından emin olmak için kullanılabilir. örnek olarak,
“ankara” or “keçi” => “ankara” veya “keçi” kelimelerinden birini içeren tüm videoları bulur.

and

and (ve) operatörü sorgunuz içindeki her hangi iki terim arasında, arama sonuçları içinde her iki terimin de yer alacağından emin olmak için kullanılabilir. örnek olarak,
“ankara” and “keçi” => “ankara” ve “keçi” kelimelerinin beraberce bulunduğu tüm videoları bulur.

_

- operatörü sorgunuz içindeki her hangi bir terimin hemen öncesinde, o terimin arama sonuçlarından bulunmamasını sağlamak için kullanılabilir. örnek olarak,
ankara – keçi => ankara kelimesini içeren fakat keçi kelimesini içermeyen tüm videoları bulur.

menüye dön

sayfalama


yaptığınız aramalarda herhangi bir sayfaya geçmek istiyorsanız aşağıdaki örnekte olduğu gibi yaptığınız sorgunun sonuna pn="gitmek istediğiniz sayfa numarası" yazamanız yeterli olarcaktır.
http://api.izlesene.com/api_v1.php?query=ankara&appid=6SDBRZ8XW6452RC3&pn=2

menüye dön

arama değiştiricileri


izlesene video arama hizmeti, sorguları her bir video kaydındaki bilgilerin belirli parçalarına odaklamak için kullanılabilecek birçok gelişmiş arama değiştiricisini desteklemektedir.
örnek olarak, belirli bir başlığı olan bir video bulmak için, title: değiştiricisi aşağıdaki gibi kullanılabilir:
title: ankara = >video başlığı içinde ankara kelimesini içeren tüm videoları bulur.

daha kompleks sorgu ifadeleri ile arama değiştiricilerini kullanmak için, özel operatörler aşağıdaki gibi kullanılabilir:
title: ankara or title:keçi => video başlığı içinde “ankara” veya “keçi" kelimesini içeren tüm videoları bulur.

category*

category: (kategori) değiştiricisi belirli bir kategoriye ait videoları bulmak için kullanılabilir. izlesene video arama motoru içindeki birçok video, fakat hepsi değil, kategorilere ayrılmıştır. popüler kategoriler arasında ‘arabalar’, 'spor', 'sinema', ve 'müzik' yer alır. var olan kategorilerin bir listesi getvideocategories yöntemi ile elde edilebilir. category: değiştiricisi aşağıdaki gibi kullanılabilir
title: ankara and category:spor =>spor kategorisinde yer alan ve başlığında "ankara" kelimesini içeren tüm videoları bulur.

* "sıcak" ve "korku gerilim" kategorileri izlesene.com API uygulamasına dahil değildir.

tag

tag: (künye) değiştiricisi, belirli künyeler atanmış olan videoları bulmak için kullanılabilir. künyeler, ilgili oldukları videoların bazı yönlerini tanımlayan kelimeler veya kelime dizileridir. künyeler bireysel kullanıcılar, insan editörler veya otomatik algoritmalar tarafından atanabilir.
tag: değiştiricisi aşağıdaki gibi kullanılabilir:
tag : ankara = >künyeleri içinde ankara kelimesini içeren tüm videoları bulur.

username

(kullanıcı ismi) değiştiricisi, belirli bir kullanıcının favori videolarının listesinde yer alan tüm videoları bulmak için kullanılabilir. bu değiştiricinin sadece kendi favoriler listelerinin diğer kullanıcılar tarafından görülebilir olmasını seçen kullanıcılar için sonuç vereceğini unutmayınız.
username: sudoku.=> “sudoku” kullanıcısı tarafında yüklenmiş olan tüm videoları bulur.

videoid

videoid: (video kimliği) değiştiricisi belirli özgün bir kimli değerine sahip bir videoyu bulmak için kullanılabilir. örnek olarak,
videoid : 16525 => 16525 özgün kimliğine sahip olan videoyu bulur.

similar

(benzer) değiştiricisi, belirtilen kimliğe sahip olan videoya benzer videoları bulmak için kullanılabilir. örnek olarak,
similar:16525 => 16525 özgün kimliğine sahip videoya benzer tüm videoları bulur.

description

description: (tanım) değiştiricisi, belirli bir tanıma sahip bir videoyu aramak için her hangi bir arama sorgusun hemen başına eklenebilir. örnek olarak,
description: ankara = >tanımı içerisinde ankara kelimesini içeren tüm videoları bulur.

menüye dön

arama sıralayıcıları


izlesene video arama hizmeti verilen bir sorgu için geri gönderilen arama sonuçlarının sıralanması için çeşitli yollar sunmaktadır. var sayılan ayarlarda, video arama sonuçları relevancy (alakalılık) adlı izlesene sıralama algoritması uyarında sıralanır. bu algoritma tipik olarak en yeni, en alakalı ve en popüler videolara en yüksek sıraları atayacaktır. eğer sonuçları farklı olarak sıralamak isterseniz, farklı bir sıralama düzeni bir sıralayıcı kullanılarak (örneğin, arama sorgunuz içinde sort:recent) belirtilebilir. arama sorgu ifadesi başına sadece bir sıralayıcı kullanılabilir. eğer birden fazla sıralayıcı bir arama sorgusu içine konulmuş ise, ilki haricindeki hepsi yok sayılacaktır. var olan sıralayıcıların tam bir listesi aşağıda verilmiştir:
sort:relevancy sonuçları alakalılığa göre sıralar; en yüksek alakalılık değerine sahip videolar ilk listelenir. eğer bir sıralayıcı belirtilmemişse, bu var sayılan sıralamadır.

sort:recent sonuçları yeniliğe göre sıralar; en yeni videolar ilk olarak listelenir.

sort:commentcount sonuçları yorum sayısına göre sıralar.

sort:viewcount sonuçları izlenme sayısına göre sıralar

menüye dön

referans dokümantasyonu


izlesene video arama xml apı'si geniş çeşitlilikte video arama ve video tarama uygulamaları için kullanışlı işlevsellik sağlar. bu apı tarafından desteklenen yöntemler iki kategoriye ayrılır, video yöntemleri ve kullanıcı yöntemleri. xml apı'nin video yöntemleri ve özellikle searchvideos (video arama) işlevi, arama motoruna sorguları gönderme ve bir xml formatlı video arama sonuçları geri alma için temel işlevsellik içerir. xml apı tarafından desteklenen video ve kullanıcı yöntemlerinin tam bir listesi aşağıda verilmiştir.

izlesene apı işlevleri :

• searchvideos

• searchvideoswithdetails

• getembedcode

menüye dön

searchvideos


cevap xml'i olarak, özgün video kimlikleri, video başlıkları, videonun izlesene url'leri, videoların kategorileri, videoların küçük resim url'leri, videoların süreleri olan temel video nitelikleri verilecektir. istem parametreleri bu yöntem için url aşağıdaki parametreleri kabul etmektedir:

appid

dizi değeri, gereklidir.
izlesene tarafından uygulamanız için atanmış olan özgün bir kimlik tanımlayıcısı olan uygulama kimliği.

func

dizi değeri, gereklidir.
çalıştırılacak işlevin ismi. bu durumda, bu değişkenin değeri ‘searchvideos’ya ayarlanmalıdır.

query

dizi değeri. seçime bağlı. var sayılan değer ' '.
izlesene video arama motoruna gönderilecek olan sorgu dizisi. bu dizi, arama terimlerinizi içerir ve aynı zamanda boolean operatörleri, değiştiriciler, filtreler ve sıralayıcıları içerebilir. desteklenen işlevselliğin tam bir listesi için arama sorgusu sözdizimi hakkındaki dokümanlara bakınız. eğer hiçbir sorgu dizisi veya boş bir sorgu dizisi verilir ise, bu yöntem vrank (video sıralama) değerlerine göre en iyi videoları geri gönderecektir.

rpp

1 ila 40 arasında tam sayı. seçime bağlı. var sayılan değer 10.
arama motorunun isteminize cevap olarak geri göndermeye çalışması gereken sonuç sayısı. 

pn

sıfırdan az olmayan tam sayı. seçime bağlı. var sayılan değer 0.
isteminize cevap olarak geri gönderilmesi gereken denk gelen sonuçların tüm seti içindeki sonuçların sayfa sayısı.

sort

dizi değeri. kullanabileceğiniz sıralama parametreleri;  videoid,vrank,commentcount,viewcount,popularity.

reverse

0 veya 1'e eşit tam sayı.
sıralamanın ters olup olmamasını belirtir.


cevap alanları bu yöntem için xml cevabı aşağıdaki alanları içerebilir:

<izleseneresult >

xml cevabı için en üst-seviye alan.
ana künye: < izleseneresult >

<function>

cevabı almak için kullanılan apı işlevinin adını içeren bir dizi. bu durumda, bu alan ‘searchvideos’ dizisini geri gönderecektir. 
ana künye: < izleseneresult >

<query>

bu cevap ile ilgili gönderilen orijinal sorguyu içeren bir dizi.
ana künye:< izleseneresult >

< resultcount >

bu video için var olan toplam video sayısını temsil eden bir tam sayı.
ana künye:< izleseneresult >

<title>

bu sonuçtaki video başlığını içeren bir dizi. her bir geri gönderilen video daima bir başlık içerecektir.
ana künye:< izleseneresult >

< firstresult >

denk gelen videoların tüm seti içindeki toplam video sayısının temsil eden bir tam sayı.
ana künye:< izleseneresult >

<rssurl>

gönderilen sorguya cevap olarak geri gönderilen video seti için bir rss beslemesi geri gönderecek olan url'yi içeren bir dizi.
ana künye:< izleseneresult >

<videos>

geri gönderilen videoların seti içinde yer alan bütün video kayıtları için kapsayıcı.
ana künye:< videos >

<video>

tüm bireysel video kayıtları için var olan metadata alanları için kapsayıcı.
ana künye:< video >

<id>

video kaydı için benzersiz bir tanımlayıcı olarak kullanılan bir tam sayı. her bir geri gönderilen videonun daima geçerli bir kimlik değeri olacaktır.
ana künye:< video >

<title>

bu sonuç içindeki videonun başlığını içeren bir dizi. her bir geri gönderilen video daima bir başlık içerecektir.
ana künye:< video >

<videourl>

bir tarayıcı penceresinde yüklendiğinde videoyu oynayacak olan url'yi içeren bir dizi. bu url'yi bir tarayıcıya yüklemek iki olası sonuç yaratacaktır. bir web sayfası içinde gömülü olan bir oynatıcıda oynayan bir video için bu url'yi yüklemek gömülü video oynatıcısını içeren web sayfasını açacaktır. ayrı bir medya oynatıcısında oynayan bir video için bu url'yi yüklemek önce videoya bağlantı veren web sayfasını (aynı zamdan "referrer page (yönlendirici sayfası)" olarak anılan) açacak ve sonrasında videoyu oynatacak olan ayrı medya oynatıcısını çalıştıracaktır. her bir geri gönderilen videonun daima geçerli bir videourl değeri olacaktır.
ana künye:<video>

<category>

bu sonuç içindeki videonun kategorisini içeren bir dizi.
ana künye:<video>

<thumbnailurl>

bu sonuç içindeki video ile ilgili küçük resim için url'yi içeren bir dizi. tüm küçük resimlerin tutarlı bir yüksekliği veya genişliği olmayacak olsa da, bu küçük resim tipik olarak 160x120 piksel boyutuna sahip olacaktır.
ana künye:<video>

<duration>

video klibinin süresini saniye olarak temsil eden bir tam sayı.


menüye dön

searchvideoswithdetails


cevap xml'i içinde, ayrıntılı video nitelikleri verilecektir. istem parametreleri: bu yöntem için url aşağıdaki parametreleri kabul etmektedir:

appid

dizi değeri, gerekli.
izlesene tarafından uygulamanız için atanmış olan özgün bir kimlik tanımlayıcısı olan uygulama kimliği.

func

dizi değeri, gerekli.
çalıştırılacak işlevin ismi. bu durumda, bu değişkenin değeri ‘searchvideos’ya ayarlanmalıdır.

query

dizi değeri. seçime bağlı. var sayılan değer  ' '.
izlesene video arama motoruna gönderilecek olan sorgu dizisi. bu dizi, arama terimlerinizi içerir ve aynı zamanda boolean operatörleri, değiştiriciler, filtreler ve sıralayıcıları içerebilir. desteklenen işlevselliğin tam bir listesi için arama sorgusu sözdizimi hakkındaki dokümanlara bakınız. eğer hiçbir sorgu dizisi veya boş bir sorgu dizisi verilir ise, bu yöntem vrank (video sıralama) değerlerine göre en iyi videoları geri gönderecektir.

rpp

1 ila 40 arasında tam sayı. seçime bağlı. var sayılan değer 10.
arama motorunun isteminize cevap olarak geri göndermeye çalışması gereken sonuç sayısı. 

pn

sıfırdan az olmayan tam sayı. seçime bağlı. var sayılan değer 0.
isteminize cevap olarak geri gönderilmesi gereken denk gelen sonuçların tüm seti içindeki sonuçların sayfa sayısı.

sort

dizi değeri. kullanabileceğiniz sıralama parametreleri;  videoid,vrank,commentcount,viewcount,popularity.

reverse

0 veya 1'e eşit tam sayı. sıralamanın ters olup olmamasını belirtir.

cevap alanları bu yöntem için xml cevabı aşağıdaki alanları içerebilir:

<izleseneresult >

xml cevabı için en üst-seviye alan.
ana künye: < izleseneresult >

<function>

cevabı almak için kullanılan apı işlevinin adını içeren bir dizi. bu durumda, bu alan ‘searchvideos’ dizisini geri gönderecektir. 
ana künye: < izleseneresult >

<query>

bu cevap ile ilgili gönderilen orijinal sorguyu içeren bir dizi.
ana künye:< izleseneresult >

< resultcount >

bu video için var olan toplam video sayısını temsil eden bir tam sayı.
ana künye:< izleseneresult >

<title>

bu sonuçtaki video başlığını içeren bir dizi. her bir geri gönderilen video daima bir başlık içerecektir.
ana künye:< izleseneresult >

< firstresult >

denk gelen videoların tüm seti içindeki toplam video sayısının temsil eden bir tam sayı.
ana künye:< izleseneresult >

<rssurl>

gönderilen sorguya cevap olarak geri gönderilen video seti için bir rss beslemesi geri gönderecek olan url'yi içeren bir dizi.
ana künye:< izleseneresult >

<videos>

geri gönderilen videoların seti içinde yer alan bütün video kayıtları için kapsayıcı.
ana künye:< videos >

<video>

tüm bireysel video kayıtları için var olan metadata alanları için kapsayıcı.
ana künye:< video >

<id>

video kaydı için benzersiz bir tanımlayıcı olarak kullanılan bir tam sayı. her bir geri gönderilen videonun daima geçerli bir kimlik değeri olacaktır.
ana künye:< video >

<title>

bu sonuç içindeki videonun başlığını içeren bir dizi. her bir geri gönderilen video daima bir başlık içerecektir.
ana künye:< video >

<videourl>

bir tarayıcı penceresinde yüklendiğinde videoyu oynayacak olan url'yi içeren bir dizi. bu url'yi bir tarayıcıya yüklemek iki olası sonuç yaratacaktır. bir web sayfası içinde gömülü olan bir oynatıcıda oynayan bir video için bu url'yi yüklemek gömülü video oynatıcısını içeren web sayfasını açacaktır. ayrı bir medya oynatıcısında oynayan bir video için bu url'yi yüklemek önce videoya bağlantı veren web sayfasını (aynı zamdan "referrer page (yönlendirici sayfası)" olarak anılan) açacak ve sonrasında videoyu oynatacak olan ayrı medya oynatıcısını çalıştıracaktır. her bir geri gönderilen videonun daima geçerli bir videourl değeri olacaktır.
ana künye:<video>

<category>

bu sonuç içindeki videonun kategorisini içeren bir dizi.
ana künye:<video>

<thumbnailurl>

bu sonuç içindeki video ile ilgili küçük resim için url'yi içeren bir dizi. tüm küçük resimlerin tutarlı bir yüksekliği veya genişliği olmayacak olsa da, bu küçük resim tipik olarak 160x120 piksel boyutuna sahip olacaktır.
ana künye:<video>

<duration>

video klibinin süresini saniye olarak temsil eden bir tam sayı.

<adddate>

ana künye:<video>
video yüklenme tarihini içeren bir dizi.

<relavancy>

ana künye:<video>
arama terimi ile videonun alakalılığı temsil eden 0 ila 1 arasında bir değişken.

<description>

ana künye:<video>
bu sonuç içindeki videonun metin tanımının içeren bir dizi. verildiği yerlerde, bu tanımın uzunluğu genellikle bir ila üç cümledir.

<username>

ana künye:<video>
video yükleyenin izlesene.com'daki kullanıcı ismini içeren bir dizi.

<useravatar>

ana künye:<video>
video yükleyenin izlesene.com'daki avatarının url'sini içeren bir dizi.

<tags>

ana künye:<video>
bu sonuçlar içindeki videoyu tanımlamak için kullanılan künyelerin virgülle sınırsız listesini içeren bir dizi. örnek olarak, bu dizi 'araba,kaza,yarış' gibi olabilir.

<viewcount>

ana künye:<video>
videonun izlesene.com'daki izlenme sayısını temsil eden bir tam sayı.

<commentcount>

ana künye:<video>
videonun izlesene.com'daki yorum sayısını temsil eden bir tam sayı.

<userrating>

ana künye:<video>
videonun izlesene.com kullanıcıları tarafından verilen ortalama notunu temsil eden 0 ila 10 arasında bir değişken.

<userratingcount>

ana künye:<video>
bu video için kaç tane izlesene.com kullanıcısının oy kullandığını temsil eden bir tam sayı.

<embedcode>

ana künye:<video>
her hangi bir web sitesinde gömülü olabilecek html künyesini içeren bir dizi.


menüye dön

getembedcode


cevap xml'i içinde, temel video nitelikleri verilecek ve bunlara ek olarak gömülü kod da verilecektir. istem parametreleri: bu yöntem için url aşağıdaki parametreleri kabul etmektedir:

appid

dizi değeri, gerekli.
izlesene tarafından uygulamanız için atanmış olan özgün bir kimlik tanımlayıcısı olan uygulama kimliği.

func

dizi değeri, gerekli.
çalıştırılacak işlevin ismi. bu durumda, bu değişkenin değeri ‘searchvideos’ya ayarlanmalıdır.

query

dizi değeri. seçime bağlı. var sayılan değer  ' '.
izlesene video arama motoruna gönderilecek olan sorgu dizisi. bu dizi, arama terimlerinizi içerir ve aynı zamanda boolean operatörleri, değiştiriciler, filtreler ve sıralayıcıları içerebilir. desteklenen işlevselliğin tam bir listesi için arama sorgusu sözdizimi hakkındaki dokümanlara bakınız. eğer hiçbir sorgu dizisi veya boş bir sorgu dizisi verilir ise, bu yöntem vrank (video sıralama) değerlerine göre en iyi videoları geri gönderecektir.

rpp

1 ila 40 arasında tam sayı. seçime bağlı. var sayılan değer 10.
arama motorunun isteminize cevap olarak geri göndermeye çalışması gereken sonuç sayısı. 

pn

sıfırdan az olmayan tam sayı. seçime bağlı. var sayılan değer 0.
isteminize cevap olarak geri gönderilmesi gereken denk gelen sonuçların tüm seti içindeki sonuçların sayfa sayısı.

sort

dizi değeri. kullanabileceğiniz sıralama parametreleri;  videoid,vrank,commentcount,viewcount,popularity.

reverse

0 veya 1'e eşit tam sayı. sıralamanın ters olup olmamasını belirtir.

cevap alanları bu yöntem için xml cevabı aşağıdaki alanları içerebilir:

<izleseneresult >

xml cevabı için en üst-seviye alan.
ana künye: < izleseneresult >

<function>

cevabı almak için kullanılan apı işlevinin adını içeren bir dizi. bu durumda, bu alan ‘searchvideos’ dizisini geri gönderecektir. 
ana künye: < izleseneresult >

<query>

bu cevap ile ilgili gönderilen orijinal sorguyu içeren bir dizi.
ana künye:< izleseneresult >

< resultcount >

bu video için var olan toplam video sayısını temsil eden bir tam sayı.
ana künye:< izleseneresult >

<title>

bu sonuçtaki video başlığını içeren bir dizi. her bir geri gönderilen video daima bir başlık içerecektir.
ana künye:< izleseneresult >

< firstresult >

denk gelen videoların tüm seti içindeki toplam video sayısının temsil eden bir tam sayı.
ana künye:< izleseneresult >

<rssurl>

gönderilen sorguya cevap olarak geri gönderilen video seti için bir rss beslemesi geri gönderecek olan url'yi içeren bir dizi.
ana künye:< izleseneresult >

<videos>

geri gönderilen videoların seti içinde yer alan bütün video kayıtları için kapsayıcı.
ana künye:< videos >

<video>

tüm bireysel video kayıtları için var olan metadata alanları için kapsayıcı.
ana künye:< video >

<id>

video kaydı için benzersiz bir tanımlayıcı olarak kullanılan bir tam sayı. her bir geri gönderilen videonun daima geçerli bir kimlik değeri olacaktır.
ana künye:< video >

<title>

bu sonuç içindeki videonun başlığını içeren bir dizi. her bir geri gönderilen video daima bir başlık içerecektir.
ana künye:< video >

<videourl>

bir tarayıcı penceresinde yüklendiğinde videoyu oynayacak olan url'yi içeren bir dizi. bu url'yi bir tarayıcıya yüklemek iki olası sonuç yaratacaktır. bir web sayfası içinde gömülü olan bir oynatıcıda oynayan bir video için bu url'yi yüklemek gömülü video oynatıcısını içeren web sayfasını açacaktır. ayrı bir medya oynatıcısında oynayan bir video için bu url'yi yüklemek önce videoya bağlantı veren web sayfasını (aynı zamdan "referrer page (yönlendirici sayfası)" olarak anılan) açacak ve sonrasında videoyu oynatacak olan ayrı medya oynatıcısını çalıştıracaktır. her bir geri gönderilen videonun daima geçerli bir videourl değeri olacaktır.
ana künye:<video>

<category>

bu sonuç içindeki videonun kategorisini içeren bir dizi.
ana künye:<video>

<thumbnailurl>

bu sonuç içindeki video ile ilgili küçük resim için url'yi içeren bir dizi. tüm küçük resimlerin tutarlı bir yüksekliği veya genişliği olmayacak olsa da, bu küçük resim tipik olarak 160x120 piksel boyutuna sahip olacaktır.
ana künye:<video>

<duration>

video klibinin süresini saniye olarak temsil eden bir tam sayı.
ana künye:<video>

<embedcode>

her hangi bir web sitesinde gömülü olabilecek html künyesini içeren bir dizi.
ana künye:<video>

menüye dön