ВебмастерМетрикаВиджетыРекламная сетьДиректПоиск для сайтаAPI
ещё
Найти

API Поиска по блогам:

Войти

Руководство по индексированию блогов, форумов и профилей

Справочник по API

API популярных записей

        		В формате PDF
        ← Ctrl предыдущаяследующая Ctrl →

        Руководство разработчика

        Данный документ содержит описание API статистики записей Яндекс.Поиска по блогам и предназначен для разработчиков, которые хотят создать собственный рейтинг постов блогосферы или другие инструменты для ее мониторинга.

        С помощью API можно получить все данные, которые были использованы в рейтинге популярных записей на сервисе Яндекса «Поиск по блогам». Основная цель создания API - увеличить количество и качество доступных всем рейтингов блогосферы, чтобы каждый пользователь в будущем смог бы найти себе рейтинг по вкусу.

        API отправляет результаты в виде RSS с перечислением записей, около каждой из которых указаны параметры. Список записей отсортирован по времени их написания. Предполагается, что пользователи API, желающие составить рейтинг, сами найдут лучшую формулу на основе предложенных параметров.

        Если у вас нет специальных знаний, необходимых для написания собственного рейтинга, воспользуйтесь одним из готовых рейтингов записей, основанных на API Поиска по блогам.

        Условия использования

        Вы можете использовать API со статистикой записей для любых проектов при условии, что разместите на видном месте рядом с результатами, полученными с использованием API, следующий дисклеймер: «При составлении рейтингов использовались данные, полученные с помощью Яндекс.Поиска по блогам. Яндекс не имеет отношения к методике составления самих рейтингов». Со слов «Яндекс.Поиск по блогам» должна стоять ссылка на http://blogs.yandex.ru, если ссылку поставить невозможно, необходимо указать этот адрес в скобках после названия сервиса.

        Параметры

        API позволяет для каждой записи в блогах узнать её основные параметры (все параметры расчитываются за последние 24 часа, если не указано иное):

        Параметр Описание
        links24 Количество ссылок на запись
        links Общее количество ссылок на запись за всё время её существования
        links24weight Взвешенное количество ссылок на запись (с отфильтрованными накрутками и спамными ссылками)
        comments24 Количество комментариев к записи
        comments Общее количество комментариев к записи за всё время её существования
        commenters24 Количество уникальных русскоязычных комментаторов у записи
        commenters Количество уникальных русскоязычных комментаторов у записи за всё время её существования
        visits24 Примерное количество читателей записи
        Примечание
        Взвешенное количество ссылок – это количество ссылок, из которого специальными алгоритмами отфильтрованы накрученные ссылки, а также занижен вес автоматических.

        Как использовать API

        Предлагается два способа использования API:

        1. Если вы хотите просто получить все данные для записей, на которые есть хотя бы две ссылки за последние 24 часа, запросите их список по следующему адресу:

          http://blogs.yandex.ru/entriesapi/

          На каждой странице результатов находится по 50 записей, страницы можно листать с помощью параметра p[age], например, вторую страницу можно получить так:

          http://blogs.yandex.ru/entriesapi?p=2

        2. Если вы хотите получить все данные для записей, на которые есть хотя бы 2 ссылки за 24 часа, и которые при этом находятся по определённому запросу, используйте дополнительный параметр filterlinks. Например:

          http://blogs.yandex.ru/search.rss?text=счастье&filterlinks=2

          Листать результаты при этом можно так же, как и в предыдущем примере. Параметр filterlinks может принимать любое значение, большее или равное 2.