Источники
Разделы
Проекты

О Проекте Открытое API

Описание

Это описание охватывает первую (бета) версию API в проекте Гослюди.Ру. Особенности использования API:
- все методы вызываются обращениями GET по определённым для них ссылкам
- форма ответа может быть CSV и JSON и для всех методов задаётся GET параметром format с соответствующими значениями json или csv.

Методы

get_top - получить список записей в топе Гослюдей
Доступен по ссылке: http://www.goslyudi.ru/api/v1/get_top/
Принимает параметр: format который может быть json или csv
Например, при вызове http://www.goslyudi.ru/api/v1/get_top/?format=csv будет список все записей в Топе который можно сохранить и открыть в Excel'е.

Структура колонок следующая:
1: title - заголовок поста
2: url - оригинальная ссылка на пост
3: comments - число комментариев по Яндексу
4. commenters - число комментаторов по Яндексу
5. visits24 - число посетителей по Яндексу
6. links - число ссылок по Яндексу.
7. total_pos - позиция в поста в топе
8. pubDate - дата публикации записи в формате ISO-8601
9. author_slug - код блога гослюдя у нас в системе
10. author_name - имя гослюдя
11. position_name - полное название должности гослюдя
12. goslyudi_url - ссылка на тут пост в гослюдях
13. avatar_url - ссылка на аватарку гослюдя в блоге

get_list - получить список всех зарегистрированных гослюдей
Доступен по ссылке: http://www.goslyudi.ru/api/v1/get_list/
Принимает параметр: format который может быть json или csv
Например, при вызове http://www.goslyudi.ru/api/v1/get_list/?format=csv будет список всех зарегистрированных блоггеров который можно сохранить и открыть в Excel'е.

Структура колонок следующая:
1. slug - код блога гослюдя у нас в системе
2. author_name - имя гослюдя
3. position_name - полное название должности гослюдя
4. blog_name - название блога
5. blog_url - ссылка на оригинальный блог гослюдя
6. date_created - дата добавления в формате ISO-8601
7. goslyudi_url - ссылка на тут пост в гослюдях
8. avatar_url - ссылка на аватарку гослюдя в блоге

get_ratings - получить рейтинг гослюдей
Доступен по ссылке: http://www.goslyudi.ru/api/v1/get_ratings/
Принимает параметр: format который может быть json или csv
Например, при вызове http://www.goslyudi.ru/api/v1/get_ratings/?format=csv будет список всех зарегистрированных блоггеров который можно сохранить и открыть в Excel'е.

Структура колонок следующая:
1: talk_weight - вес говорливости
2: talk_position - позиция в рейтинге по говорливости
3: links_weight - вес упоминаемости
4. links_position - позиция в рейтинге по упоминаемости
5. readers_weight - вес читаемости
6. readers_position - позиция в рейтинге по читаемости
7. full_weight - вес по сводному рейтингу
8. full_position - позиция по сводному рейтингу
8. date_updated - дата формирования рейтинга в формате ISO-8601 9. author_slug - код блога гослюдя у нас в системе
10. author_name - имя гослюдя
11. position_name - полное название должности гослюдя
12. goslyudi_url - ссылка на блог гослюдя в гослюдях.ру
13. avatar_url - ссылка на аватарку гослюдя в блоге

get_regratings - получить рейтинг активности регионов
Доступен по ссылке: http://www.goslyudi.ru/api/v1/get_regratings/
Принимает параметр: format который может быть json или csv
Например, при вызове http://www.goslyudi.ru/api/v1/get_regratings/?format=csv будет список все записей в Топе который можно сохранить и открыть в Excel'е.

Структура колонок следующая:
1: talk_weight - вес говорливости
2: talk_position - позиция в рейтинге по говорливости
3: num_authors - число авторов в регионе
4. date_updated - дата формирования рейтинга в формате ISO-8601
5. region_slug - код региона в системе (краткое англоязычное название, часть ссылки)
6. region_name - название региона
7. goslyudi_url - ссылка на страницу региона в гослюди.ру


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

Открытое API Гослюди.Ру может быть использовано для любых проектов при соблюдении следующего условия. На видном месте веб-страницы или приложения использующего API должен присутствовать текст: "Данные получены с использование API проекта Гослюди.Ру" с активной гиперссылкой на сайт http://www.goslyudi.ru по словам "Гослюди.Ру".

Используемые сервисы

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

Редакция

© Полит.ру, 2010. Все права защищены и охраняются законом.
Поддержка сайта: команда NaitoN.

Нагревательные системы. газовые котлы отопления купить от "Протерм". К празднику. оригинальные подарки на юбилей . Доставка.