Search

Labs.blogfrog.pl

Metoda search umożliwia przeszukiwanie bazy wszystkich wpisów zagregowanych przez blogfroga od początku jego działania (01.01.2006). Przy wyszukiwaniu brane są pod uwagę różne kryteria, takie jak kategoria bloga, właściciel, tagi, opis, tytuł, pełna treść (pobrana z HTML). Możliwe jest praktycznie dowolne zawężanie zbioru wyników.

Wywołanie metody odbywa sie poprzez interfejs REST.  Wyślij żądanie HTTP GET na adres http://blogfrog.pl/index.php/api/search?key=[apikey]&query=[words] z obowiązkowymi parametrami "key" oraz "query" i opcjonalnymi parametrami opisanymi poniżej.

Spis treści

Parametry


Obowiązkowe

  • key

Twój klucz API wygenerowany na stronie [1]

  • query

Zapytanie,do wyszukiwarki - może to być zarówno prosta fraza, jak i skomplikowane zapytanie logiczne.
Możliwe operatory to:

- AND, OR, (, )

- @title fraza do wyszukania - przeszukuj tylko pole "TITLE" pobrane z RSS,

- @description fraza do wyszukania- przeszukuj tylko pole "DESCRIPTION" pobrane z RSS,

- @link fraza do wyszukania - przeszukuj tylko pole "link" pobrane z RSS,

- @blog_url fraza do wyszukania - przeszukuj tylko pole Adres Url bloga,

- @blog_title fraza do wyszukania - przeszukuj tylko pole Tytuł bloga

Wszystkie ww. operatory można ze sobą łączyć. Uwaga: ww. operatory działają w trybie wyszukiwania "ext" (domyślny tryb).

  • format

Wyjściowy format. Dostępne formaty dla wpisów to: rss (zawiera tylko podstawowe dane), xml i json(zawierają rozszerzone dane). Dla wpisów domyślnym formatem jest rss.

 

Opcjonalne

  • start

Ustaw ten atrybut > 0 aby otrzymać start+20 najnowszych wpisów, np. ustaw start na 20+1  a otrzymasz drugą stronę wyników (wyniki 21-40)

  • limit

Ustaw ten artybut na wartość pomiędzy 0 i 300 aby określić ile rekordów chcesz otrzymać

  • category


Podaj liczbę od 1 do 11 (Biznes, Internet, Kultura, Reklama, Media, Polityka, Rozrywka, Sport, Osobiste, Fotoblogi, Dla doroslych) określającą kategorię wpisów którą chcesz przeszukiwać

  • blog_id

Podaj liczbowy identyfikator bloga którego wpisy chcesz przeszukiwać

  • user_id

podaj liczbowy identyfikator użytkownika którego blogi chcesz przeszukiwać

Zwracane wartości

Metoda zwraca błąd HTTP 404 wraz z opisem gdy coś nie tak, w przeciwnym razie zwraca wynik w określonym formacie.


Formaty JSON i XML są bardzo podobne, mają następującą strukturę: 


<?xml version="1.0" encoding="UTF-8"?>
<blogfrog>
<result>
<result_id></result_id>
<result_array type='array' size='0'></result_array>
<result_object type='array' size='25'>
<item>
<blogs_title>TYTUL BLOGA</blogs_title>
<blogs_id>ID BLOGA</blogs_id>
<blogs_url>ADRES URL BLOGA</blogs_url>
<link>LINK WPISU</link>
<date>DATA PUBLIKACJI</date>
<title>TYTUŁ</title>
<description>KRÓTKI OPIS</description>
<noterank>FROGRANK</noterank>
<userrank>OCENA UŻYTKOWNIKÓW</userrank>
<id>ID NOTKI</id>
<themes_id>ID POPULARNEGO TEMATU</themes_id>
<themes_priority>PRIORYTET W TEMACIE</themes_priority>
</item>

</result_object>
</result>
</blogfrog>
Źródło: "http://labs.blogfrog.pl/wiki/Search"