В чем разница между query и superquery?

$sql = $db->query(); - чистый запрос в мускуль, полученные данные нужно будет перебирать циклом

while( $row = $db->get_row( $sql ) ){ //перебираем все полученные строки
 //код для обработки строки, где $row - массив с данными из таблицы
}

$sql = $db->super_query(); - сокращенный вариант от вышеуказанного кода для удобства использования. Код аналогичен:

$db->query("запрос ... LIMIT 0,1"); //получаем только одну строку
$row = $db->get_row(); //получаем данные одной строки в виде массива

$sql = $db->super_query("Запрос",true); - аналогичен $db->query(). только просто $db->query возвращает объект mysql запроса, а тут в $sql будет массив из строк (каждая строка так же массив).

Последний вариант рекомендуется использовать только если данных в таблице не много и/или в дальнейшем эти данные нужны именно в виде массива.