Зарегистрироваться
View Categories

Методы

GET: api/v1/projects/visibility?{ops} #

Возвращает данные по видимости в разрезе проекта или конкурента.

Входные параметры #
ПараметрОписаниеЗначение по умолчаниюОбязательный
project_idid проектанетда
date_fromДата начала диапазона в формате YYYY-MM-DDнетда
date_toДата окончания диапазона в формате YYYY-MM-DDтекущая датанет
serp_engineid поисковой системы, если не указан, данные будут возвращены по всем системамне заданнет
rival_idid конкурента, если не указан, данные будут возвращены по проектуне заданнет
Возвращаемый результат #

В поле data будет возвращен массив объектов следующего вида:

{
    freq_type: number
    check_date: string
    serp_engine_id: number
    visibility: number
}

GET: api/v1/keywords?{ops} #

Возвращает список ключей с позициями и частотностью. В запрос возможно передать диапазон дат, для выгрузки данных за период более 1 дня. Максимально допустимый диапазон 30 дней.

Входные параметры #
ПараметрОписаниеЗначение по умолчаниюОбязательный
project_idid проектанетда
date_fromДата начала диапазона в формате YYYY-MM-DDнетда
date_toДата окончания диапазона в формате YYYY-MM-DDтекущая датанет
serp_engineid поисковой системы, если не указан, данные будут возвращены по всем системамне заданнет
Возвращаемый результат #

В поле data будет возвращен массив объектов следующего вида:

{
    id: number,
    key: string,
    page: number,
    positions: {
        date: string,
        position: number,
        rel_page: string,
        serp_engine: number,
    }[],
    frequency: {
        date: string,
        frequency: number,
        freq_type: number,
        serp_engine: number,
    }[]
}

GET: api/v1/keywords/by-tags?{ops} #

Входные параметры #
Параметр Описание Значение по умолчанию Обязательный
project_id ID проекта нет да
date Конкретная дата в формате YYYY-MM-DD нет да
serp_engine ID поисковой системы нет да
tag_ids Массив ID тегов, если не указан — все теги проекта все теги нет
frequency_type ID типа частотности не задан нет
limit Количество записей для пагинации не задан нет
offset Смещение для пагинации не задан нет
Возвращаемый результат #

В поле data будет возвращен массив объектов следующего вида:

{
    id: number,
    name: string,
    top3: number,
    top10: number,
    top30: number,
    top3_pcnt: number,
    top10_pcnt: number,
    top30_pcnt: number,
    ws_data: [
        {
            ws_type: number,
            ws_value: number,
            alfa_traf: number
        }
    ]
}
Top