blipi
api
Interfejs programistyczny serwisów BLIPI.pl – wersja 2.0
Jak uzyskać dostęp do API?
Metody dotyczące trendów i statystyk dostępne są dla wszystkich. Aby mieć dostęp do naszego API wyszukiwania, wymagany jest klucz. Jeśli chcesz go otrzymać, wyślij email na adres info@blipi.pl z nazwą i krótkim opisem aplikacji, która będzie API używać. Możesz też kontaktować się za pomocą konta na Blipie – pisz do ^blipi
Jak komunikować się z API?
Dostępne są następujące metody, w miejsce słowa [apikey] należy wstawić swój klucz do API – posiadaczy klucza prosimy o podawanie go we wszystkich zapytaniach, zamiast słowa get:
Statystyki blipowicza.
Poniższy przykład pokazuje jak otrzymać statystyki użytkownika f055:
api.blipi.pl/get/stats/f055
zwraca JSON:
{"user":"/users/f055",
"trackedby":206,
"trackedbychange":"+1",
"tracking":362,
"trackingchange":0,
"citations":72,
"mentions":15,
"rank":80,
"rankchange":"+1"}
W przypadku użytkowników komercyjnych kont, wartość rank zawsze wynosi 0, a parametr rankchange się nie pojawia.
Ranking Top100.
Poniższy przykład pokazuje jak otrzymać listę 10. lub 100. najpopularniejszych blipowiczów:
api.blipi.pl/get/top
api.blipi.pl/get/top100
zwraca JSON:
[{"trackedby":"747","user":"/users/gadzinowski",rank:6},
{"trackedby":"871","user":"/users/mediafun",rank:3},
{"trackedby":"715","user":"/users/reuptake",rank:7},
{"trackedby":"595","user":"/users/hazan",rank:9},
{"trackedby":"1033","user":"/users/njet",rank:2},...]
Popularne strony i tagi
Poniższy przykład pokazuje jak otrzymać listę najpopularniejszych stron i tagów w danej chwili, oraz popularne tagi z danego dnia:
api.blipi.pl/get/popular
zwraca JSON:
{"tags":{
"now":["foto","iphone","slucham","muzyka","blipdnia","słucham","wyraz"],
"today":["magdusia","photoshop","moda","zima","fotografia","kino","firefox"]},
"links":{
"now":[
{"domain":"pleaserobme.com","url":"http://re.blipi.pl/5jdki","title":"Please Rob Me"},
{"domain":"maszignora.pl","url":"http://re.blipi.pl/5ckvv","title":"www.MaszIgnora.pl"},
{"domain":"i.imgur.com","url":"http://re.blipi.pl/5mu8c","title":"i.imgur.com"}
]}
}
Wyszukiwarka. (wymaga klucza)
Poniższy przykład pokazuje jak znaleźć 10 ostatnich blipnięć zawierających frazę blipi:
api.blipi.pl/[apikey]/search/blipi
zwraca JSON:
[{rank:6,"blipid":"17625633","user":"/users/garnier","content":"Jak #Warszawa wspomina sobotni pokaz pod Pałacem Kultury? Chcemy zobaczyć Wasze zdjęcia rozświetlonego Pałacu! http://rdir.pl/127rx Czeka 100 zestawów Garnier!"},
{rank:3,"blipid":"17637955","user":"/users/agatakozak","content":"Garnier gratuluje laureatom #pokapismo i zaprasza do wzięcia udziału w #konkurs.ie #pokapalac.Do wygrania 100 zestawów kosmetyków Garnier! http://rdir.pl/127rx"},
{rank:7,"blipid":"17622372","user":"/users/ilovetorun","content":"Dzięki ^blipi już znam swoje statystyki na Blipie http://rdir.pl/j9sw"},
{rank:9,"blipid":"17602764","user":"/users/blipi","content":"Na #top100 najpopularniejsi dziś są ^archeowiesci (+51), ^polskiportalamigowy (+8), ^zbigniewholdys (+8). Więcej na #blipi.pl http://rdir.pl/hw8t"},...]