Search blogs

Labs.blogfrog.pl

Metoda search_blogs umożliwia przeszukiwanie bazy wszystkich blogów zagregowanych przez blogfroga. Przy wyszukiwaniu brane są pod uwagę różne kryteria, takie jak kategoria bloga, właściciel, tagi, opis, tytuł. Możliwe jest praktycznie dowolne zawężanie zbioru wyników.

Wywołanie metody odbywa sie poprzez interfejs REST.  Wyślij żądanie HTTP GET na adreshttp://blogfrog.pl/index.php/api/search_blogs?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,
- @url fraza do wyszukania - przeszukuj tylko pole Adres Url bloga,

- @tags fraza do wyszukania - przeszukuj tylko pole Tagi

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 blogów to: xml i json. Dla blogów domyślnym formatem jest xml

 

Opcjonalne

  • start

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

  • limit

Ustaw ten atrybut na wartość > 0 i mniejszą od 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ę blogów którą chcesz przeszukiwać

  • user_id

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

  • mode

Tryb wyszukiwania:
- ext (domyślny)
- możliwe są wszystkie operatory wymienione powyżej,
- phrase - wyszukiwane zapytanie jest traktowane jako fraza, jeśli podane jest więcej wyrazów używany jest operator AND,
- bool - możliwe są operatory (,),AND,OR - jeśli podane jest więcej wyrazów używany jest operator OR.


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='2'>
<item>
<tags>TAGI PRZYPISANE DO BLOGA</tags>
<url>URL BLOGA</url>
<title>TYTUŁ BLOGA</title>
<feed_url>ADRES RSS</feed_url>
<blog_note>FROGRANK</blog_note>
<last_entry>DATA OSTATNIEGO WPISU</last_entry>
<date_added>DATA DODANIA BLOGA DO SERWISU</date_added>
<id>ID BLOGA</id>
<description>OPIS BLOGA</description>
<categories_id>ID KATEGORII</categories_id>
<blog_rank_reference>OCENA REDAKCJI</blog_rank_reference>
<position>POZYCJA NA LIŚCIE TOP</position>
</item>
</result_object>
<current_row>0</current_row>
<num_rows>ILOSC ZWROCONYCH WIERSZY</num_rows>
</result>
<time>CZAS WYKONANIA</time>
<count>CALKOWITA ILOSC ZNALEZIONYCH REKORDOW</count>
<query>ZAPYTANIE</query>
</blogfrog>
Źródło: "http://labs.blogfrog.pl/wiki/Search_blogs"