A Miner.hu egyre több lehetőséget kínál a programozók számára a Miner.hu motorjával történő interakcióra. Ezen az oldalon ezeket a lehetőségeket gyűjtjük össze. Szépséget nem, de remélhetőleg hasznos információkat nyújt ez az oldal.

Miner.hu API

FIGYELEM! Az API jelenleg folyamatos fejlesztés alatt áll. Bármikor, minden előzetes egyeztetés nélkül megváltoztathatjuk azt. Kövesd figyelemmel blogunkat!

Az api.miner.hu címen ezen leírás mellett különböző, a keresőmotort, illetve a Miner.hu egyéb funkcióit programból elérhetővé tevő interfészek is találhatóak. A használatukhoz "regisztrálnod" kell magad, egy e-mail címet eljuttatva hozzánk egy kódot fogunk visszajuttatni, melyet az alábbiakban bemutatott módon lehet felhasználni. A Miner.hu lehetőségeinek bővülésével várhatóan az API lehetőségek is bővülni fognak.

Regisztráld magad!

A következőkben a "user@example.com" e-mail címet, és az "12345678" kódot fogjuk használni a példák során. Ezek helyére a velünk leegyeztetett e-mail cím/kód párost kell helyettesíteni, értelemszerűen.

Egy kód segítségével egy nap 100 lekérdezést tudsz felénk elküldeni. Amennyiben ennél többre van szükséged, ezen módosítani tudunk, ehhez vedd fel velünk a kapcsolatot. Tömeges használat esetén fenntartjuk a jogot, hogy díjat számoljunk fel a szolgáltatás használatáért. A felhasználási ötleteket díjazzuk, érdekes megoldások esetén törekszünk a díjmentességre!

Miner Trends

A folyamatosan változó, a blogszféra éppen aktuális legfrissebb témaköreit összegyűjtő Miner Trends TOP 20 listáját a következő címen lehet elérni:

http://api.miner.hu/trends_blog.php?user=user%40example.com&code=12345678

A visszaadott érték alapértelmezetten egy a PHP serialize függvényén átesett egyszerű tömb. Feldolgozása nagyon egyszerű: 

<?
$trends = unserialize(
  file_get_contents(
    "http://api.miner.hu/trends_blog.php?user=...&code=..."
  )
);
echo "<ul>";
foreach ($trends as $key) {
  echo "<li>$key</li>";
}
echo "</ul>";
?>

A program futási eredménye megtekinthető itt: api_trends.php.

Az adatok elérhetőek XML és JSON formátumban is, a &type=xml, illetve &type=json paramétereket hozzáadva az URL-hez. XML formátum esetén tehát:

http://api.miner.hu/trends_blog.php?user=user%40example.com&code=12345678&type=xml

Miner keresés

A Miner alapfunkcióját jelentő keresést is elérhetővé tesszük az API-n keresztül. A keresési feltételt, az egy oldalon kért találatok számát, és a kért oldal sorszámát kell megadni a következő módon:

http://api.miner.hu/search_blog.php?user=user%40example.com&code=12345678&query=kifejez%E9s&itemsperpage=5&page=0

A "query" paraméter a keresendő kifejezést (értelemszerűen urlencode-olva), az "itemsperpage" paraméter az egy oldalra eső találatok számát, a "page" pedig a lekérendő oldal számát tartalmazza (0 az első oldal). Egyedül a "query" paraméter megadása kötelező (a user és code paramétereken felül).

A visszaadott válasz alapértelmezetten egy a PHP serialize függvényén átesett összetett tömb lesz. A tartalmát jelen pillanatban nem részleteznénk, a következő PHP kód egyszerű lekérdezést biztosít: 

<?
$results = unserialize(
  file_get_contents(
    "http://api.miner.hu/search_blog.php?user=...&code=...&query=miner.hu"
  )
);
echo "<pre>";
var_dump($results);
echo "</pre>";
?>

A program futási eredménye megtekinthető itt: api_search.php.

Az adatok elérhetőek XML és JSON formátumban is, a &type=xml, illetve &type=json paramétereket hozzáadva az URL-hez. XML formátum esetén tehát:

http://api.miner.hu/search_blog.php?user=user%40example.com&code=12345678&type=xml&query=kifejez%E9s&itemsperpage=5&page=0

Miner LINK keresés

A Miner által követett bejegyzésekben számos link is található. Ezek keresését szintén lehetővé tesszük az API-n keresztül. A keresési feltételt, vagyis az URL elejét, az egy oldalon kért találatok számát, és a kért oldal sorszámát kell megadni a következő módon:

http://api.miner.hu/search_blog_links.php?user=user%40example.com&code=12345678&query=example.com/page&itemsperpage=5&page=0

A "query" paraméter az URL elejét kell, hogy tartalmazza. A "http://", "www." sztringeket levágjuk az elejéről, hogy minél jobb találatokat tudjunk adni. Az "itemsperpage" paraméter az egy oldalra eső találatok számát, a "page" pedig a lekérendő oldal számát tartalmazza (0 az első oldal). Egyedül a "query" paraméter megadása kötelező (a user és code paramétereken felül).

A visszaadott válasz alapértelmezetten egy a PHP serialize függvényén átesett összetett tömb lesz. A tartalmát gyakorlatilag ugyanaz, mint az alap keresés esetében. A következő PHP kód egyszerű lekérdezést biztosít: 

<?
$results = unserialize(
  file_get_contents(
    "http://api.miner.hu/search_blog_links.php?user=...&code=...&query=miner.hu"
  )
);
echo "<pre>";
var_dump($results);
echo "</pre>";
?>

A program futási eredménye megtekinthető itt: api_search_links.php.

Az adatok elérhetőek XML és JSON formátumban is, a &type=xml, illetve &type=json paramétereket hozzáadva az URL-hez. XML formátum esetén tehát:

http://api.miner.hu/search_blog_links.php?user=user%40example.com&code=12345678&type=xml&query=exampmle.com/page&itemsperpage=5&page=0