Разработчикам

Ðàçðàáîò÷èêàì

Описание API

Выгрузка производится в формате CSV с помощью GET-запросов к сайту export.linkpad.ru.

URL для запросов

http://export.linkpad.ru/?key=D3CB821D49C74E17A5B5A5498F912410-81565785923к4C4487D6ACF5сD837219

Формат запроса

http://export.linkpad.ru/
? [key=<API-ключ>]
& [host=<домен>]
& [report_type=<тип отчета>]
& [groupby=<параметр группировки результатов>]
& [top=<количество строк>]
& [page=<номер страницы>]
& [results_per_page=<количество строк на страницу>]

Query-
параметры

key	Ваш ключ API, выдаваемый при подключении подписки.
host	Домен, для которого выводятся данные (например, example.com).
report_type	Тип отчета. Возможные значения: "backlinks" - данные по входящим ссылкам "outboundlinks" - данные по исходящим ссылкам "indexed_pages" - проиндексированные страницы сайта "ip" - сайты на IP домена Если параметр не задан, выводятся данные по входящим ссылкам.
groupby	Параметр, определяющий правило группировки данных по ссылкам. Возможные значения: "anchors" - группировка по анкорам "domains" - группировка по доменам Если параметр не задан, выводятся данные без группировки.
top	Максимальное кол-во строк для выгрузки (например, top=1000 - выгрузить первые 1000 строк)
page	Номер страницы, который может использоваться, например, для постраничной выгрузки больших объемов данных. Параметр [page] не уменьшает количество строк, которое списывается с баланса. При первом вызове строки с параметром [page]=1 c баланса списывается полное количество строк в отчете. При последующих вызовах того же отчета, но с параметром [page] равным 2,3,4 и т.д., списание баланса не производится. Актуальное количество строк в отчете можно узнать в Linkpad.Xml.
results_per_page	Количество строк на 1 страницу – от 1000 до 10000, по умолчанию 5000.

Примеры запросов

Выгрузить внешние ссылки домена example.com

http://export.linkpad.ru/?key=D3CB821D49C74E17A5B5A5498F912410-81565785923к4C4487D6ACF5сD837219&host=example.com

Выгрузить анкоры внешних ссылок домена example.com

http://export.linkpad.ru/?key=D3CB821D49C74E17A5B5A5498F912410-81565785923к4C4487D6ACF5сD837219&host=example.com&groupby=anchors

Выгрузить первые 1000 ссылающихся сайтов на домен example.com

http://export.linkpad.ru/?key=D3CB821D49C74E17A5B5A5498F912410-81565785923к4C4487D6ACF5сD837219&host=example.com&groupby=domains&top=1000

Выгрузить исходящие ссылки домена example.com

http://export.linkpad.ru/?key=D3CB821D49C74E17A5B5A5498F912410-81565785923к4C4487D6ACF5сD837219&host=example.com&report_type=outboundlinks

Выгрузить первую страницу списка сайтов, на которые ссылается example.com

http://export.linkpad.ru/?key=D3CB821D49C74E17A5B5A5498F912410-81565785923к4C4487D6ACF5сD837219&host=example.com&report_type=outboundlinks&groupby=domains&page=1

Формат ответа

Сервер возвращает файл в формате CSV, полностью соотвествующий файлу выгрузки отчета по кнопке "Экспорт" в Поиске Linkpad.