SEMrush API

Бесплатный аудит вашего сайта
Incorrect email or url. Try again.
We're now auditing your website.
Your Site Audit report will be sent to your email within an hour.
You can audit another site

SEMrush API

Projects API позволяет пользователям создавать и редактировать проекты, а также управлять проектами, которые используют инструменты аудита сайта и отслеживания позиций (The Site Audit и Position Tracking).

Используя Projects API, вы можете отслеживать своих конкурентов в Интернете, рейтинг ключевых слов, обнаруживать местных конкурентов, исправлять проблемы на странице веб-сайтов и многое другое.

Request Format / Формат запроса

Все запросы API используют такие методы HTTP, как POST, PUT, GET или DELETE с параметрами JSON, и должны содержать ваш ключ API.

Projects / Проекты

List all existing projects / ВЫВОД ВСЕХ ТЕКУЩИХ ПРОЕКТОВ
project_list
Стоимость: 100 API юнитов за запрос (100 API units per request)

Этот запрос позволяет вам получить список всех проектов, включая их ID, имя проекта и имя домена, а также инструменты, которые были активированы для каждого проекта.

Конечная точка (Endpoint)

Endpoint

https://api.semrush.com/

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/management/v1/projects?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name 

Value 

Description 

Описание 

key* 

 

An identification key assigned to a user after subscribing to Semrush that is available via Profile page 

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля. 

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result 

Code 

Success 

HTTP 200 

Error 

HTTP 400 

Пример ответа (Response example)

{
"url": "mysite.com",
"tools":[],
"project_id": 643526670283248,
"project_name": "myproject"
}

Параметры ответа (Response parameters)

Fields 

Description 

Описание 

project_id 

Project ID 

ID проекта 

project_name 

The name of a project 

Название проекта 

url 

The domain of a project 

Домен проекта 

tools 

List of project tools activated by a user 

Список инструментов, активированных пользователем 

GET INFORMATION ABOUT AN EXISTING PROJECT / ПОЛУЧИТЬ ИНФОРМАЦИЮ О ТЕКУЩЕМ ПРОЕКТЕ
project_get
Стоимость: 100 API юнитов за запрос (100 API units per request)

Этот запрос позволяет вам получить информацию о проекте, включая его ID, имя и доменное имя, а также инструменты, которые были активированы для этого проекта.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/management/v1/projects/{id}?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"tools":[],
"project_id": 643526670283248,
"project_name": "myproject"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

CREATE A NEW PROJECT / СОЗДАНИЕ НОВОГО ПРОЕКТА
project_create
Стоимость: 100 API юнитов за запрос (100 API units per request)

Этот запрос позволяет вам создать новый проект, который включает в себя название проекта и выбор домена.

Запрашиваемый URL (Requested URL)[POST]

https://api.semrush.com/management/v1/projects?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

project_name*

Name of a user's project. Forbidden characters are ~`!#%'^&*=[]\/{}|":<>?

Имя пользовательского проекта. Запрещенные символы ~`!#%'^&*=[]\/{}|":<>?

url*

The domain of the project

Доменное имя / URL проекта

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

{
"project_name":"myproject",
"url":"mysite.com"
}

Ответ (Response)

Result

Code

Success

HTTP 200

Error

HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"tools":[],
"project_id": 643526670283248,
"project_name": "myproject"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

UPDATE AN EXISTING PROJECT / ОБНОВЛЕНИЕ ТЕКУЩЕГО ПРОЕКТА
project_update
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрос позволяет вам обновить или изменить название проекта.

Запрашиваемый URL (Requested URL)[PUT]

https://api.semrush.com/management/v1/projects?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

project_id*

Project ID

ID проекта

project_name

Name of a user's project. Forbidden characters are ~`!#%'^&*=[]\/{}|":<>?

Имя пользовательского проекта. Запрещенные символы ~`!#%'^&*=[]\/{}|":<>?

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

{
"project_id":643526670283248, "project_name":"my old project"
}

Ответ (Response)

Result

Code

Success

HTTP 200

Error

HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"tools":[],
"project_id": 643526670283248,
"project_name": "my old project"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

DELETE AN EXISTING PROJECT / УДАЛЕНИЕ ТЕКУЩЕГО ПРОЕКТА
project_delete
Стоимость: 100 API юнитов за запрос (100 API units per request)

Этот запрос позволяет удалить проект, включая все его инструменты вашей кампании.

Запрашиваемый URL (Requested URL)[DELETE]

https://api.semrush.com/management/v1/projects/{id}?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Запрашиваемые параметры (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result

Code

Success

HTTP 200

Error

HTTP 400

Add keywords to an existing project / ДОБАВИТЬ КЛЮЧЕВЫЕ СЛОВА В ПРОЕКТ
project_add_keywords
Стоимость: 100 API units per keyword added

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

Запрашиваемый URL (Requested URL)[PUT]

https://api.semrush.com/management/v1/projects/{id}/keywords?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

keywords

Keywords

Ключевые слова

tags

Tags for a keyword

Теги для ключевых слов

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

{
"keywords":[{"keyword":"seo", "tags":["seo"]},{"keyword":"seotool", "tags":["seo"]}]
}

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",

"keywords":[
{
"keyword": "search tool",
"tags":["search"],
"timestamp": 1391517755
},
{
"keyword": "search engine",
"tags":["search"],
"timestamp": 1391517755
},
{
"keyword": "seo",
"tags":["seo"],
"timestamp": 1491517755
},
{
"keyword": "seotool",
"tags":["seo"],
"timestamp": 1491517755
}
],
"competitors":["google.com","ebay.com","bing.com"],
"tools":[],
"project_id": 643526670283248,
"project_name": "my old project"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

Remove keywords from an existing project / УДАЛЕНИЕ КЛЮЧЕВЫХ СЛОВ ИЗ ТЕКУЩЕГО ПРОЕКТА
project_delete_keywords
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрос позволяет удалить отслеживаемые ключевые слова из текущего проекта.

Запрашиваемый URL (Requested URL)[DELETE]

https://api.semrush.com/management/v1/projects/{id}/keywords?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

keywords

Keywords

Ключевые слова

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

{
"keywords":[{"keyword":"seo"},{"keyword":"seotool"}]
}

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"tools":[],
"project_id": 643526670283248,
"project_name": "my old project"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

Add competitors to an existing project / ДОБАВЛЕНИЕ КОНКУРЕНТОВ В ТЕКУЩИЙ ПРОЕКТ
project_add_competitors
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрашиваемый URL (Requested URL)[PUT]

https://api.semrush.com/management/v1/projects/{id}/competitors?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

competitors

List of project competitors

Список конкурентов по проекту

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

{
"competitors":["yahoo.com"]
}

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"keywords":[
{
"keyword": "search tool",
"tags":["search"],
"timestamp": 1391517755
},
{
"keyword": "search engine",
"tags":["search"],
"timestamp": 1391517755
}
],
"competitors":["google.com","ebay.com","bing.com","yahoo.com"],
"tools":[],
"project_id": 643526670283248,
"project_name": "myproject"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

Remove competitors from an existing project / УДАЛИТЬ ВСЕХ КОНКУРЕНТОВ ИЗ ТЕКУЩЕГО ПРОЕКТА
project_delete_competitors
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрашиваемый URL (Requested URL)[DELETE]

https://api.semrush.com/management/v1/projects/{id}/competitors?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

competitors

List of project competitors

Список конкурентов по проекту

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

{
"competitors":["bing.com","yahoo.com"]
}

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"tools":[],
"project_id": 643526670283248,
"project_name": "myproject"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

Group keywords with tags in an existing project / ГРУППИРОВКА КЛЮЧЕВЫХ СЛОВ ПО ТЕГАМ
project_add_tags
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрос позволяет вам добавлять до 5 тегов для отслеживаемых ключевых слов

Запрашиваемый URL (Requested URL)[PUT]

https://api.semrush.com/management/v1/projects/{id}/tags?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

keywords

Keywords

Ключевые слова

tags

Tags for a keyword

Теги для ключевых слов

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

[{"tag":"seo", "keywords":["search tool", "search engine"]}]

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"keywords":[
{
"keyword": "search tool",
"tags":["search","seo"],
"timestamp": 1391517755
},
{
"keyword": "search engine",
"tags":["search","seo"],
"timestamp": 1391517755
}
],
"competitors":["google.com","ebay.com"],
"tools":[],
"project_id": 643526670283248,
"project_name": "myproject"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

Remove tags from keywords in an existing project / УДАЛИТЬ ТЕГИ КЛЮЧЕВЫХ СЛОВ В ТЕКУЩЕМ ПРОЕКТЕ
project_remove_tags
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрос позволяет удалить теги отслеживаемых ключевых слов из текущего проекта

Запрашиваемый URL (Requested URL)[DELETE]

https://api.semrush.com/management/v1/projects/{id}/tags?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

id*

Project ID

ID проекта

keywords

Keywords

Ключевые слова

tag

Tags for a keyword

Теги для ключевых слов

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

[{"tag":"seo", "keywords":["search tool", "search engine"]}]

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"url": "mysite.com",
"tools":[],
"project_id": 643526670283248,
"project_name": "myproject"
}

Параметры ответа (Response parameters)

Fields

Description

Описание

project_id

Project ID

ID проекта

project_name

The name of a project

Название проекта

url

The domain of a project

Домен проекта

tools

List of project tools activated by a user

Список инструментов, активированных пользователем

Position Tracking Tool / Инструмент отслеживания позиций

Management / Управление

Базовый URL для всех запросов:

https://api.semrush.com/management/v1/projects/{ID}/tracking/{METHOD}

Где{ID}- id проекта, а{METHOD}- название одного из доступных методов.

Enable the Position Tracking Tool in a project / ВКЛЮЧИТЬ ИНСТРУМЕНТ ОТСЛЕЖИВАНИЯ
tracking_enable
Стоимость: 100 API юнитов за запрос (100 API units per request)

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

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

tracking_url_type*

one of: rootdomain, subdomain, subfolder, url

tracked URL's type

Тип отслеживаемого URL

tracking_url*

string

tracked URL

Отслеживаемый URL

country_id*

integer

country id

region_id

integer

region id

city_id

integer

city id

weekly_notification*

1 or 0

  • The value "1" in this parameter means that weekly email-sending is enabled

  • The value "0" in this parameter means that weekly email-sending is disabled

- Значение «1» в этом параметре означает, что еженедельная отправка электронной почты включена.

- Значение «0» в этом параметре означает, что еженедельная отправка электронной почты отключена.

first_letter

1 (default) or 0

  • 1 - send the letter to login email when first data is available

  • 0 - do not send the letter to login email when first data is available

1 - отправить письмо на адрес электронной почты для входа, когда будут доступны первые данные

0 - не отправлять письмо на электронную почту для входа, когда доступны первые данные

timezone

integer

Time zone (crawling starts at 5am in a specified time zone)

Временная зона (сканирование начинается в 5 утра в указанном часовом поясе)

device

one of: desktop, phone, tablet

Target device

Отслеживаемое устройство

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

POST /enable?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
{
"tracking_url": "ebay.com", "tracking_url_type": "rootdomain", "country_id": "2840", "weekly_notification": "1", "device": "desktop"
}

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400
Enable/Disable email-sending containing project statistics / ВКЛЮЧЕНИЕ/ОТКЛЮЧЕНИЕ ОТПРАВКИ СТАТИСТИКИ ПО EMAIL
tracking_notification_update
Стоимость: 100 API юнитов за запрос (100 API units per request)

Этот запрос позволяет вам включать или отключать еженедельные электронные письма со статистикой проекта.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Request example

PUT /notifications?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
DELETE /notifications?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Available regions / Доступные регионы

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

Базовый URL для всех запросов:

https://api.semrush.com/management/v1/info/{METHOD}

Где{METHOD} – название одного из доступных методов

Get a list of countries / ВЫВОД СПИСКА СТРАН
get_countries
Стоимость: 100 API юнитов за запрос (100 API units per request)

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

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /countries?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"0":{
"id": 2840,
"name": "United States"
},
"1":{
"id": 2124,
"name": "Canada"
},
"2":{
"id": 2826,
"name": "United Kingdom"
},
...
}

Возвращаемые значения (Return values)

Name

Value

Description

Описание

id

integer

country id

идентификатор страны

name

string

country name

название страны

Get a list of regions / ВЫВОД СПИСКА РЕГИОНОВ
get_regions
Стоимость: 100 API юнитов за запрос (100 API units per request)

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

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

country_id*

integer

country id

ID страны

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /countries/{country_id}/regions?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"0":{
"id": 21133,
"name": "Alabama"
},
"1":{
"id": 21132,
"name": "Alaska"
},
"2":{
"id": 21136,
"name": "Arizona"
},
...
}

Возвращаемые значения (Return values)

Name

Value

Description

Описание

id

integer

region id

идентификатор региона

name

string

region name

название региона

Get a list of cities / СПИСОК ГОРОДОВ
get_cities
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрос позволяет получить список городов, по которым выбирается геолокация для проекта.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

country_id*

integer

country id

ID страны

region_id*

integer

region id

ID региона

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /countries/{country_id}/regions/{region_id}/cities?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"0":{
"id": 1013370,
"name": "Ajo"
},
"1":{
"id": 1013371,
"name": "Alpine"
},
"2":{
"id": 1013372,
"name": "Amado"
},
...
}

Возвращаемые значения (Return values)

Name

Value

Description

Описание

id

integer

city id

идентификатор города

name

string

city name

название города

Reports / Отчеты

Все запросы, связанные с отчетами, требуют использования метода запроса HTTP GET. Базовый URL для всех запросов:

https://api.semrush.com/reports/v1/projects/{ID}/tracking/

Где {ID} - id проекта.

Внимание! Для запросов, использующих параметр url, вы должны использовать правильную маску.

тип Url

Пример маски

rootdomain

*.ebay.com/*

subdomain

www.ebay.com/*

subfolder

ebay.com/motors/*

url

http://www.ebay.com/motors/

URLs with a trailing slash (/) and those without this sign are different ones. The positions of these URLs may also differ in search engine results.
Campaign Dates / СРОКИ КАМПАНИИ
tracking_campaign_dates
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрос возвращает список дат, для которых была собрана кампания.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_campaign_dates

request type

тип запроса

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_campaign_dates

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": "9",
"last_crawl": "2",
"data":{
"0":{
"Dt": "20140401",
},
"1":{
"Dt": "20140402",
},
"2":{
"Dt": "20140403",
},
"3":{
"Dt": "20140404",
},
...
}
}

Возвращаемые значения (Return values)

Name

Value

Description

Описание

total

integer

number of results

количество результатов

last_crawl

integer

time since the last crawl

время с последнего сканирования

Dt

date in YYYYMMDD format

date

дата

Organic Overview / Органический обзор
tracking_overview_organic
Стоимость: 100 API юнитов за запрос (100 API units per request)

Запрос позволяет вам получить обзор рейтинга домена в топ-100 Google, а также увидеть новые и потерянные ключевые слова, поисковые запросы с улучшенным или пониженным рейтингом и изменения в рейтинге домена за выбранный период.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_overview_organic

request type

тип запроса

url*

string

tracked URL or competitor URL (with mask)

отслеживаемый URL или URL конкурента (с маской)

display_tags

string

tags separated by the '|' symbol

теги, разделенные |

date_begin

date in YYYYMMDD format

starting date of a selected period

начальная дата выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

конечная дата выбранного периода

linktype_filter

  • 0 - Include local pack rankings in all reports. This is the default value.

  • 1 - Show only local pack rankings in all reports

  • 2 - Exclude local pack rankings from all reports

local pack filter

  • 0 - Включить местный рейтинг во все отчеты. Значение по умолчанию.

  • 1 - Выводить только местный рейтинг во всех отчетах

  • 2 - Исключить местный рейтинг из всех отчетов

serp_feature_filter

  • fsn: Featured snippet

  • geo: Local pack

  • rev: Reviews

  • stl: Site links

  • vid: Video

  • vib: Featured video

  • new: Top stories

  • rel: People also ask

  • img: Images

  • twt: Twitter

  • knw: Instant answer

  • kng: Knowledge panel

  • shp: Shopping ads

  • adt: AdWords top

  • adb: AdWords bottom

Use this filter to see keywords that have certain SERP features on a SERP.

Используйте этот фильтр, чтобы увидеть ключевые слова, которые имеют определенные функции в SERP.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Request example

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_overview_organic&date_begin=20140405&date_end=20140411&linktype_filter=0&url=*.ebay.com%2F*&serp_feature_filter=fsn

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": 199,
"visibility": 15.9602,
"differenceVisibility": 1.7159,
"all": 146,
"all_improved": 67,
"all_declined": 32,
"all_difference": 3,
"all_left": 3,
"all_entered": 6,
"top3": 36,
"top3_improved": 8,
"top3_declined": 2,
"top3_difference": 2,
"top3_left": 1,
"top3_entered": 3,
"top10": 67,
"top10_improved": 19,
"top10_declined": 13,
"top10_difference": 6,
"top10_left": 1,
"top10_entered": 7,
"top20": 97,
"top20_improved": 36,
"top20_declined": 19,
"top20_difference": 10,
"top20_left": 1,
"top20_entered": 11,
"data":{}
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

total

integer

number of results

количество результатов

visibility

percentage

visibility index

индекс видимости

differenceVisibility

percentage

visibility index

индекс видимости

all

integer

The number of keywords that bring a domain to the top 100 search results

Количество ключевых слов, по которым домен попадает в топ-100 результатов поиска.

all_difference

integer

changes in keywords that bring a domain to the top 100 search results

изменения в ключевых словах, которые выводят домен в топ-100 результатов поиска

all_improved

integer

The number of improved keywords that bring a domain to the top 100 search results

Количество улучшенных ключевых слов, по которым домен попадает в топ-100 результатов поиска.

all_declined

integer

The number of declined keywords that bring a domain to the top 100 search results

Количество отклоненных ключевых слов, по которым домен попадает в топ-100 результатов поиска.

all_left

integer

The number of keywords that no longer bring a domain to the top 100 search results

Количество ключевых слов, по которым домен больше не попадает в топ-100 результатов поиска.

all_entered

integer

The number of new keywords bringing a domain to the top 100 search results

Количество новых ключевых слов, по которым домен попадает в топ-100 результатов поиска.

top3

integer

number of keywords that bring a domain to the top 3 search results

количество ключевых слов, по которым домен попадает в топ-3 результатов поиска

top3_improved

integer

The number of improved keywords that bring a domain to the top 3 search results

Количество улучшенных ключевых слов, которые выводят домен в топ-3 результатов поиска.

top3_declined

integer

The number of declined keywords that bring a domain to the top 3 search results

Количество отклоненных ключевых слов, по которым домен попадает в топ-3 результатов поиска.

top3_difference

integer

changes in keywords that bring a domain to the top 3 search results

изменения в ключевых словах, которые выводят домен в топ-3 результатов поиска

top3_left

integer

The number of keywords that no longer bring a domain to the top 3 search results

Количество ключевых слов, по которым домен больше не попадает в топ-3 результатов поиска.

top3_entered

integer

The number of new keywords bringing a domain to the top 3 search results

Количество новых ключевых слов, по которым домен попадает в топ-3 результатов поиска.

top10

integer

number of keywords that bring a domain to the first page of search results

количество ключевых слов, которые выводят домен на первую страницу результатов поиска

top10_improved

integer

The number of improved keywords that bring a domain to the first page of search results

Количество улучшенных ключевых слов, которые выводят домен на первую страницу результатов поиска.

top10_declined

integer

The number of declined keywords that bring a domain to the first page of search results

Количество отклоненных ключевых слов, которые выводят домен на первую страницу результатов поиска.

top10_difference

integer

changes in keywords that bring a domain to the first page of search results

изменения в ключевых словах, которые выводят домен на первую страницу результатов поиска

top10_left

integer

The number of keywords that no longer bring a domain to the first page of search results

Количество ключевых слов, по которым домен больше не выводится на первую страницу результатов поиска.

top10_entered

integer

The number of new keywords bringing a domain to the first page of search results

Количество новых ключевых слов, выводящих домен на первую страницу результатов поиска.

top20

integer

number of keywords that bring a domain to the first two pages of search results

количество ключевых слов, по которым домен попадает на первые две страницы результатов поиска

top20_improved

integer

The number of improved keywords that bring a domain to the first two pages of search results

Количество улучшенных ключевых слов, по которым домен попадает на первые две страницы результатов поиска.

top20_declined

integer

The number of declined keywords that bring a domain to the first two pages of search results

Количество отклоненных ключевых слов, по которым домен попадает на первые две страницы результатов поиска.

top20_difference

integer

changes in keywords that bring a domain to the first two pages of search results

изменения в ключевых словах, по которым домен попадает на первые две страницы результатов поиска

top20_left

integer

The number of keywords that no longer bring a domain to the first two pages of search results

Количество ключевых слов, по которым домен больше не выводится на первые две страницы результатов поиска.

top20_entered

integer

The number of new keywords bringing a domain to the first two pages of search results

Количество новых ключевых слов, по которым домен попадает на первые две страницы результатов поиска.

data

array

array of positions and numbers of keywords on this position (from 0 to 99)

массив позиций и номеров ключевых слов на этой позиции (от 0 до 99)

Organic Positions report / ОТЧЕТ ПО ПОЗИЦИЯМ В ОРГАНИЧЕСКОЙ ВЫДАЧЕ
tracking_position_organic
Стоимость: 100 API юнитов за строку (100 API units per line)

В отчете перечислены все ключевые слова из кампании, позиции до 6 доменов для этих ключевых слов в топ-100 результатах органического поиска Google по этим ключевым словам, а также изменения позиций за выбранный период времени.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_position_organic

request type

тип запроса

top_filter

top_3, top_3_income, top_3_leave, top_3_down, top_3_up, top_1page, top_1page_income, top_1page_leave, top_1page_down, top_1page_up, top_2page, top_2page_income, top_2page_leave, top_2page_down, top_2page_up, top_100, top_100_income, top_100_leave, top_100_down, top_100_up

positions filter

фильтр по позициям

url*

string

tracked URL or competitor URL (with mask)

отслеживаемый URL или URL конкурента (с маской)

date_begin

date in YYYYMMDD format

starting date of a selected period

начальная дата выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

конечная дата выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные |

display_filter

string

filter for columns Ph, Nq, Cp

фильтр по столбцам

display_limit

integer

number of returned results

количество возвращенных результатов

display_offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

display_sort

ph_asc, ph_desc,{DOMAIN_N}_pos_asc,{DOMAIN_N}_pos_desc,{DOMAIN_N}_be_asc,{DOMAIN_N}_be_desc,{DOMAIN_N}_di_asc,{DOMAIN_N}_di_desc, cp_asc, cp_desc, nq_desc, nq_asc

report sortings

сортировка отчета

linktype_filter

  • 0 - Include local pack rankings in all reports. This is the default value.

  • 1 - Show only local pack rankings in all reports

  • 2 - Exclude local pack rankings from all reports

local pack filter

  • 0 - Включить местный рейтинг во все отчеты. Значение по умолчанию.

  • 1 - Выводить только местный рейтинг во всех отчетах

  • 2 - Исключить местный рейтинг из всех отчетов

serp_feature_filter

  • fsn: Featured snippet

  • geo: Local pack

  • rev: Reviews

  • stl: Site links

  • vid: Video

  • vib: Featured video

  • new: Top stories

  • rel: People also ask

  • img: Images

  • twt: Twitter

  • knw: Instant answer

  • kng: Knowledge panel

  • shp: Shopping ads

  • adt: AdWords top

  • adb: AdWords bottom

Use this filter to see keywords that have certain SERP features on a SERP.

Используйте этот фильтр, чтобы увидеть ключевые слова, которые имеют определенные функции в SERP.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Request example

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_position_organic&display_limit=10&display_offset=0&display_sort=20140411_asc&date_begin=20140405&date_end=20140411&display_filter=&url=*.ebay.com%2F*&linktype_filter=0&serp_filter_filter=fsn

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": "199",
"limit": "10",
"offset": "0",
"data":{
"0":{
"Pi": "1209571576516105373",
"Ph": "pig trough",
"Tg":{},
"Cp": "0.25",
"Nq": "1300",
"Dt":{
"20150414":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"20150415":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"20150416":{
"*.alibaba.com/*": "",
"*.aliexpress.com/*": ""
},
"20150417":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"20150418":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"20150419":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"20150420":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
}
},
"Lt":{
"20150414":{
"*.alibaba.com/*": "org",
"*.aliexpress.com/*": "org"
},
"20150415":{
"*.alibaba.com/*": "org",
"*.aliexpress.com/*": "org"
},
...
},
"Lu":{
"20150414":{
"*.alibaba.com/*": "http://www.alibaba.com/",
"*.aliexpress.com/*": "http://www.aliexpress.com/"
},
"20150415":{
"*.alibaba.com/*": "http://www.alibaba.com/",
"*.aliexpress.com/*": "http://www.aliexpress.com/"
},
...
},
"Be":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"Fi":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"Diff":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
},
"Diff1":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
},
"Diff7":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
},
"Diff30":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
}
},
...
}

Возвращенные значения (Return values)

Name

Value

Description

total

integer

number of results

количество результатов

limit

integer

number of returned results

количество возвращенных результатов

offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

Pi

string

keyword ID

ID ключевого слова

Ph

string

keyword

ключевое слово

Tg

array

tags for a keyword

теги для ключевых слов

Cp

integer

Средняя цена 1 клика по объявлению в (Google AdWords) по данному запросу для рекламодателя (в долларах США).

Nq

integer

Среднемесячное количество поисковых запросов по данному ключевому слову. Это значение рассчитывается за последние 12 месяцев.

Dt

array

array of dates and positions (dates in format "YYYYMMDD")

массив дат и позиций (даты в формате "ГГГГММДД")

Lt

string

Ranking type

  • "org" - organic ranking

  • "geo" - local pack ranking

Тип рейтинга

"org" - органический рейтинг

"geo" - местный рейтинг

Lu

array

Landing URLs

Целевые URL

Be

array

Position at the beginning of specified period

Позиция в начале указанного периода

Fi

array

Position at the end of specified period

Позиция на конец указанного периода

Sf

array

Serp features on a SERP in the specified date

Показывает Serp в поисковой выдаче в указанную дату

Vi

array

Visibility of domain on a SERP in the specified date

Видимость домена в поисковой выдаче в указанную дату

Tr

array

Estimated traffic in the specified date

Расчетный трафик в указанную дату

Diff

array

Position difference for specified period

Разница позиций за указанный период

Diff1

array

Position difference for 1-day period

Разница позиций за день

Diff7

array

Position difference for 1-week period

Разница по позициям за неделю

Diff30

array

Position difference for 1-month period

Разница по позициям за месяц

AdWords Positions report / ОТЧЕТ ПО ПЛАТНЫМ ПОЗИЦИЯМ (ADWORDS)
tracking_position_adwords
Стоимость: 100 API юнитов за строку (100 API units per line)

В отчете перечислены все ключевые слова из кампании, позиции до 6 доменов для этих ключевых слов в результатах платного поиска Google и изменения позиций за выбранный период времени.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_position_adwords

request type

тип запроса

url*

string

tracked URL or competitor URL (with mask)

отслеживаемый URL или URL конкурента (с маской)

date_begin

date in YYYYMMDD format

starting date of a selected period

начальная дата выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

конечная дата выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные |

display_filter

string

filter for columns Ph, Nq, Cp

фильтр по столбцам

display_limit

integer

number of returned results

количество возвращенных результатов

display_offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

display_sort

ph_asc, ph_desc,{DOMAIN_N}_pos_asc,{DOMAIN_N}_pos_desc,{DOMAIN_N}_be_asc,{DOMAIN_N}_be_desc,{DOMAIN_N}_di_asc,{DOMAIN_N}_di_desc, cp_asc, cp_desc, nq_desc, nq_asc

report sortings

сортировка отчета

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_position_adwords&display_limit=10&display_offset=0&display_sort=20140411_asc&date_begin=20140405&date_end=20140411&display_filter=&url=*.ebay.com%2F*

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": "199",
"limit": "10",
"offset": "0",
"data":{
"0":{
"Pi": "1329428353566010647",
"Ph": "alibaba express",
"Tg":{},
"Cp": "0.65",
"Nq": "18100",
"Dt":{
"20150414":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": "2"
},
"20150415":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": "2"
},
"20150416":{
"*.alibaba.com/*": "",
"*.aliexpress.com/*": ""
},
"20150417":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": "2"
},
"20150418":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": ""
},
"20150419":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": "2"
},
"20150420":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": "2"
}
},
"Lu":{
"20150414":{
"*.alibaba.com/*": "http://www.alibaba.com/",
"*.aliexpress.com/*": "http://www.aliexpress.com/"
},
"20150415":{
"*.alibaba.com/*": "http://www.alibaba.com/",
"*.aliexpress.com/*": "http://www.aliexpress.com/"
},
...
},
"Be":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": "2"
},
"Fi":{
"*.alibaba.com/*": "1",
"*.aliexpress.com/*": "2"
},
"Diff":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
},
"Diff1":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
},
"Diff7":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
},
"Diff30":{
"*.alibaba.com/*": 0,
"*.aliexpress.com/*": 0
}
},
...
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

total

integer

number of results

количество результатов

limit

integer

number of returned results

количество возвращённых результатов

offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

Pi

string

keyword ID

ID ключевого слова

Ph

string

keyword

ключевое слово

Tg

array

tags for a keyword

теги для ключевых слов

Cp

integer

Средняя цена 1 клика по объявлению в (Google AdWords) по данному запросу для рекламодателя (в долларах США).

Nq

integer

Среднемесячное количество поисковых запросов по данному ключевому слову. Это значение рассчитывается за последние 12 месяцев.

Dt

array

array of dates and positions (dates in format "YYYYMMDD")

массив дат и позиций (даты в формате "ГГГГММДД")

Lu

array

Landing URLs

Целевые URL

Be

array

Position at the beginning of specified period

Позиция в начале указанного периода

Fi

array

Position at the end of specified period

Позиция на конец указанного периода

Diff

array

Position difference for specified period

Разница позиций за указанный период

Diff1

array

Position difference for 1-day period

Разница позиций за день

Diff7

array

Position difference for 1-week period

Разница по позициям за неделю

Diff30

array

Position difference for 1-month period

Разница по позициям за месяц

Organic Competitors Discovery report / ОТЧЕТ ПО КОНКУРЕНТАМ В ОРГАНИЧЕСКОМ ПОИСКЕ
tracking_competitors_organic
Стоимость: 1000 API юнитов за строку (1000 API units per line)

Отчеты позволяют увидеть список доменов, которые появляются в топ-100 результатах органического поиска Google по ключевым словам из кампании отслеживания в выбранном регионе. При построении списка учитываются: среднее положение конкурентов в результатах поиска, их видимость, а также результаты за выбранный период.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_competitors_organic

request type

тип запроса

url

string

tracked URL

отслеживаемый URL

url_type*

one of: rootdomain, subdomain, subfolder, url

type of a competitor URL

тип отслеживаемого URL конкурента

black_list

string

exclude domains from results (separated by the '|' symbol)

исключить домены из результатов (разделить символом |)

top_start

integer

start depth range

начальный диапазон глубины

top_end

integer

end depth range

конечный диапазон глубины

date_begin

date in YYYYMMDD format

starting date of a selected period

дата начала выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

дата окончания выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные знаком "|"

display_limit

integer

number of returned results

количество возвращенных запросов

display_offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

display_sort

ur_asc, ur_desc,{DATE}_asc,{DATE}_desc, cl_asc, cl_desc, cd_asc, cd_desc, av_asc, av_desc

report sortings

сортировка отчетов

linktype_filter

  • 0 - Include local pack rankings in all reports. This is the default value.

  • 1 - Show only local pack rankings in all reports

  • 2 - Exclude local pack rankings from all reports

local pack filter

  • 0 - Включить местный рейтинг во все отчеты. Значение по умолчанию.

  • 1 - Выводить только местный рейтинг во всех отчетах

  • 2 - Исключить местный рейтинг из всех отчетов

serp_feature_filter

  • fsn: Featured snippet

  • geo: Local pack

  • rev: Reviews

  • stl: Site links

  • vid: Video

  • vib: Featured video

  • new: Top stories

  • rel: People also ask

  • img: Images

  • twt: Twitter

  • knw: Instant answer

  • kng: Knowledge panel

  • shp: Shopping ads

  • adt: AdWords top

  • adb: AdWords bottom

Use this filter to see keywords that have certain SERP features on a SERP.

Используйте этот фильтр, чтобы увидеть ключевые слова, которые имеют определенные функции в SERP.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Request example

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_competitors_organic&display_limit=10&display_offset=0&display_sort=20140411_desc&date_begin=20140405&date_end=20140411&top_start=1&top_end=10&url_type=rootdomain&linktype_filter=0&serp_feature_filter=fsn

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"Md":{
"Ur": "alibaba.com",
"Dt":{
"20150414":{
"Mc": "143",
"Av": "20",
"Sq": "20",
"Cl": "14.24"
},
"20150420":{
"Mc": "146",
"Av": "19",
"Sq": "19",
"Cl": "15.96"
}
},
"Cd": "1.72"
},
"total": "12706",
"limit": "10",
"offset": "0",
"data":{
"0":{
"Ur": "alibaba.com",
"Dt":{
"20150414":{
"Mc": "143",
"Av": "20",
"Sq": "20",
"Cl": "14.24"
},
"20150420":{
"Mc": "146",
"Av": "19",
"Sq": "19",
"Cl": "15.96"
}
},
"Cd": "1.72"
},
...
}
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

total

integer

number of results

количество результатов

limit

integer

number of returned results

количество возвращенных результатов

offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

Ur

string

competitor URL

URL конкурента

Dt

array

dates and positions (date in YYYYMMDD format)

даты и позиции (дата в формате ГГГГММДД)

Cl

float

visibility

видимость

Cd

float

visibility change for specified period

изменения видимости за указанный период

Av

integer

average position

средняя позиция

Sq

integer

position deviation

отклонение позиции

Mc

integer

number of keywords

количество ключевых слов

AdWords Competitors Discovery report / ОТЧЕТ ПО КОНКУРЕНТАМ В ПЛАТНОЙ ВЫДАЧЕ (ADWORDS)
tracking_competitors_adwords
Стоимость: 1000 API юнитов за строку (1000 API units per line)

Отчет позволяет вам видеть домены, которые появляются в результатах платного поиска Google по ключевым словам из кампании отслеживания в выбранном регионе.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_competitors_adwords

request type

тип запроса

url

string

tracked URL

отслеживаемый URL

url_type*

one of: rootdomain, subdomain, subfolder, url

type of a competitor URL

тип отслеживаемого URL конкурента

black_list

string

exclude domains from results (separated by the '|' symbol)

исключить домены из результатов (разделить символом |)

top_start

integer

start depth range

начальный диапазон глубины

top_end

integer

end depth range

конечный диапазон глубины

date_begin

date in YYYYMMDD format

starting date of a selected period

дата начала выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

дата окончания выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные знаком "|"

display_limit

integer

number of returned results

количество возвращенных запросов

display_offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

display_sort

ur_asc, ur_desc,{DATE}_asc,{DATE}_desc, cl_asc, cl_desc, cd_asc, cd_desc, av_asc, av_desc

report sortings

сортировка отчетов

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_competitors_adwords&display_limit=10&display_offset=0&display_sort=20140411_desc&date_begin=20140405&date_end=20140411&top_start=1&top_end=10&url_type=rootdomain

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"Md":{
"Ur": "alibaba.com",
"Dt":{
"20150414":{
"Mc": "22",
"Av": "7",
"Sq": "17",
"Cl": "9.25"
},
"20150420":{
"Mc": "18",
"Av": "1",
"Sq": "2",
"Cl": "8.74"
}
},
"Cd": "-0.50",
"Ps": 426
},
"total": "504",
"limit": "10",
"offset": "0",
"data":{
"0":{
"Ur": "isexdoll.com",
"Dt":{
"20150414":{
"Mc": "0",
"Av": "0",
"Sq": "0",
"Cl": "0.00"
},
"20150420":{
"Mc": "7",
"Av": "3",
"Sq": "3",
"Cl": "2.81"
}
},
"Cd": "2.81"
},
...
}
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

total

integer

number of results

количество результатов

limit

integer

number of returned results

количество возвращенных результатов

offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

Ur

string

competitor URL

URL конкурента

Dt

array

dates and positions (date in YYYYMMDD format)

даты и позиции (дата в формате ГГГГММДД)

Cl

float

visibility

видимость

Cd

float

visibility change for specified period

изменения видимости за указанный период

Av

integer

average position

средняя позиция

Sq

integer

position deviation

отклонение позиции

Mc

integer

number of keywords

количество ключевых слов

Organic Visibility Index report / ОТЧЕТ ВИДИМОСТИ ДОМЕНА В ОРГАНИЧЕСКОМ ПОИСКЕ
tracking_visibility_organic
Стоимость: 100 API юнитов за запрос (100 API units per request)

Отчет показывает видимость домена, который показывает прогресс веб-сайта в топ-100 результатах органического поиска Google по ключевым словам из кампании отслеживания, а также изменения в видимости домена за выбранный период.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_visibility_organic

request type

тип запроса

url*

string

tracked URL or competitor URL (with mask)

отслеживаемый URL или URL конкурента (с маской)

date_begin

date in YYYYMMDD format

starting date of a selected period

начальная дата выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

конечная дата выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные символом |

linktype_filter

  • 0 - Include local pack rankings in all reports. This is the default value.

  • 1 - Show only local pack rankings in all reports

  • 2 - Exclude local pack rankings from all reports

local pack filter

  • 0 - Включить местный рейтинг во все отчеты. Значение по умолчанию.

  • 1 - Выводить только местный рейтинг во всех отчетах

  • 2 - Исключить местный рейтинг из всех отчетов

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_visibility_organic&date_begin=20140401&date_end=20140411&url=*.ebay.com%2F*&linktype_filter=0

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": "9",
"data":{
"0":{
"Dt": "20140401",
"Vi": 7,
"Vr": 96
},
"1":{
"Dt": "20140402",
"Vi": 7,
"Vr": 96
},
"2":{
"Dt": "20140403",
"Vi": 7,
"Vr": 96
},
"3":{
"Dt": "20140404",
"Vi": 7,
"Vr": 96
},
...
}
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

total

integer

number of results

количество результатов

Dt

date in YYYYMMDD format

date

дата

Vi

integer

absolute visibility value

абсолютное значение видимости

Vr

float

relative visibility value

относительное значение видимости

AdWords Visibility Index report / ОТЧЕТ ВИДИМОСТИ ДОМЕНА В ПЛАТНОЙ ВЫДАЧЕ (ADWORDS)
tracking_visibility_adwords
Стоимость: 100 API юнитов за запрос (100 API units per request)

Отчет демонстрирует видимость домена, показывает прогресс веб-сайта в платных результатах поиска Google по ключевым словам из кампании отслеживания, а также изменения видимости за выбранный период.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_visibility_adwords

request type

тип запроса

url*

string

tracked URL or competitor URL (with mask)

отслеживаемый URL или URL конкурента (с маской)

date_begin

date in YYYYMMDD format

starting date of a selected period

начальная дата выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

конечная дата выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные символом |

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Пример запроса (Request example)

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_visibility_adwords&date_begin=20140401&date_end=20140411&url=*.ebay.com%2F*

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": "9",
"data":{
"0":{
"Dt": "20140401",
"Vi": 7,
"Vr": 96
},
"1":{
"Dt": "20140402",
"Vi": 7,
"Vr": 96
},
"2":{
"Dt": "20140403",
"Vi": 7,
"Vr": 96
},
"3":{
"Dt": "20140404",
"Vi": 7,
"Vr": 96
},
...
}
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

total

integer

number of results

количество результатов

Dt

date in YYYYMMDD format

date

дата

Vi

integer

absolute visibility value

абсолютное значение видимости

Vr

integer

relative visibility value

относительное значение видимости

Organic Landing Pages report / ОТЧЕТ ПО ВЫДАЧЕ ЦЕЛЕВЫХ URL В ОРГАНИЧЕСКОМ ПОИСКЕ
tracking_landing_pages_organic
Стоимость: 1000 API юнитов за строку (1000 API units per line)

This report lists all landing pages of selected domain for current tracking campaign. For each landing page all the keywords that this landing page ranks for are reported.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_landing_pages_organic

request type

тип запроса

url*

string

tracked URL or competitor URL (with mask)

отслеживаемый URL или URL конкурента (с маской)

date_begin

date in YYYYMMDD format

starting date of a selected period

начальная дата выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

конечная дата выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные символом |

display_filter

string

filter for columns Ph, Nq, Cp

фильтр по столбцам

display_limit

integer

number of returned results

количество возвращённых результатов

display_offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

display_sort

ph_asc, ph_desc,{DOMAIN_N}_pos_asc,{DOMAIN_N}_pos_desc,{DOMAIN_N}_be_asc,{DOMAIN_N}_be_desc,{DOMAIN_N}_di_asc,{DOMAIN_N}_di_desc, cp_asc, cp_desc, nq_desc, nq_asc

report sortings

сортировка отчета

newlost_filter

new, lost

return only new or lost urls

возвращает только новые или потерянные URL

linktype_filter

  • 0 - Include local pack rankings in all reports. This is the default value.

  • 1 - Show only local pack rankings in all reports

  • 2 - Exclude local pack rankings from all reports

local pack filter

  • 0 - Включить местный рейтинг во все отчеты. Значение по умолчанию.

  • 1 - Выводить только местный рейтинг во всех отчетах

  • 2 - Исключить местный рейтинг из всех отчетов

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Request example

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_landing_pages_organic&display_sort=1_mc_desc&date_begin=20180207&date_end=20180207&display_limit=100&display_filter=&display_offset=0&display_tags=&url=semrush.com/blog&filter_url=&newlost_filter=&linktype_filter=0

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": 37,
"state": "0",
"limit": 100,
"offset": 0,
"new": 0,
"lost": 0,
"keywords": 107,
"Pc":{
"http": 0,
"https": 37
},
"data":{
"0":{
"Ur": "https://www.semrush.com/blog/topsy-is-dead-alternative-social-analytics-tools-you-need-to-use-now/",
"Tp": "",
"Dt":{
"20180207":{
"Mc": 9,
"Av": 2.22,
"Tr": 61.518333,
"Tc": 116.040433,
"Rq": 19620
},
"Diff":{
"Mc": 0,
"Av": 0,
"Tr": 0,
"Tc": 0,
"Rq": 0
}
},
"Kw":[
{
"Pi": "7922908393917093815",
"Ph": "topsy analytics",
"Tp": "",
"Rq": 320,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 3.882667,
"Diff": 0
},
"Tc":{
"20180207": 25.819733,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "1522738860508378941",
"Ph": "topsy com analytics",
"Tp": "",
"Rq": 170,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 2.062667,
"Diff": 0
},
"Tc":{
"20180207": 4.682253,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "3772292990852912364",
"Ph": "topsy social",
"Tp": "",
"Rq": 90,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 1.092,
"Diff": 0
},
"Tc":{
"20180207": 0,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "8747962949595138851",
"Ph": "topsy twitter analytics",
"Tp": "",
"Rq": 90,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 1.092,
"Diff": 0
},
"Tc":{
"20180207": 9.67512,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "9069259884330927019",
"Ph": "what is topsy com",
"Tp": "",
"Rq": 90,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 2,
"Diff": 0
},
"Tr":{
"20180207": 0.375,
"Diff": 0
},
"Tc":{
"20180207": 0,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "2019165307386841491",
"Ph": "topsy com",
"Tp": "",
"Rq": 5400,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 3,
"Diff": 0
},
"Tr":{
"20180207": 17.1,
"Diff": 0
},
"Tc":{
"20180207": 41.382,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "13769451381664187323",
"Ph": "topsy.com",
"Tp": "",
"Rq": 880,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 3,
"Diff": 0
},
"Tr":{
"20180207": 2.786667,
"Diff": 0
},
"Tc":{
"20180207": 2.870267,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "2409524746484837701",
"Ph": "topsy",
"Tp": "",
"Rq": 12100,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 4,
"Diff": 0
},
"Tr":{
"20180207": 31.863333,
"Diff": 0
},
"Tc":{
"20180207": 25.8093,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "3435076276275003494",
"Ph": "topsy twitter",
"Tp": "",
"Rq": 480,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 4,
"Diff": 0
},
"Tr":{
"20180207": 1.264,
"Diff": 0
},
"Tc":{
"20180207": 5.80176,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
}
],
"Amp": 0
},
...
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

keywords

integer

number of keywords used to build this report

количество ключевых слов, использованных для построения этого отчета

limit

integer

maximum number of results to return

максимальное количество возвращенных результатов

offset

integer

use this parameter to specify how many results to skip before building a report

используйте параметр, чтобы указать, сколько результатов нужно пропустить перед построением отчета

total

integer

number of results

количество результатов

lost

integer

number of lost URLs (URLs that ranked for at least one keyword from a given campaign on the start date of the selected period, but don't rank for any keyword from a given campaign on the end date of the selected period)

количество потерянных URL-адресов (URL-адреса, которые получили ранжирование хотя бы по одному ключевому слову из кампании на дату начала выбранного периода, но не ранжируются ни по одному ключевому слову из кампании на дату окончания выбранного периода)

new

integer

number of new URLs (URLs that didn't rank for any keyword from a given campaign on the start date of the selected period, but rank for at least one keyword from a given campaign on the end date of the selected period)

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

data

array

list of URLs ranking for keywords from a given campaign

список URL-адресов, ранжируемых по ключевым словам кампании

data -> Ur

string

an URL that ranks for keyword(s) from a given campaign

URL-адрес, который ранжируется по ключевым словам кампании

data -> Tp

string (can be “”, “new” or “lost”)

"new" - means that this URL didn't rank for any keyword from a given campaign on the start date of the selected period, but ranks for at least one keyword from a given campaign on the end date of the selected period. "lost" - means that this URL ranked for at least one keyword from a given campaign on the start date of the selected period, but doesn't rank for any keyword from a given campaign on the end date of the selected period.

«новый» – этот URL не ранжируется ни по одному ключевому слову из кампании на дату начала выбранного периода, но ранжируется по крайней мере по одному ключевому слову кампании на дату окончания выбранного периода.[Разрыв обтекания текста]“потерянный" – этот URL получил рейтинг по крайней мере для одного ключевого слова из кампании на дату начала выбранного периода, но не ранжируется ни по одному ключевому слову из кампании на дату окончания выбранного периода.

data -> Dt

array

data on overall metrics for a given URL

данные об общих показателях для URL

data -> Dt -> YYYYMMDD

array

data on overall metrics for a given URL on a given date

данные об общих показателях для URL на указанную дату

data -> Dt -> YYYYMMDD -> Av

float

average position for a list of keywords given URL ranks for on a given date

средняя позиция для списка ключевых слов с рейтингом URL на указанную дату

data -> Dt -> YYYYMMDD -> Mc

integer

number of keywords given URL ranks for on a given date

количество ключевых слов, по которым URL ранжируется на указанную дату

data -> Dt -> YYYYMMDD -> Rq

integer

total volume for a list of keywords given URL ranks for on a given date

общий объем для списка ключевых слов, по которым URL ранжируется на указанную дату

data -> Dt -> Diff

array

how values of overall metrics changed between the start and the end of the selected period

как изменились значения общих показателей между началом и концом выбранного периода

data -> Dt -> Diff -> Av

float

how average position for a list of keywords given URL ranks for changed between the start and the end of the selected period

как средняя позиция для списка ключевых слов URL изменилась между началом и концом выбранного периода

data -> Dt -> Diff -> Mc

integer

how number of keywords given URL ranks for changed between the start and the end of the selected period

как количество ключевых слов, для которых задан URL, изменилось между началом и концом выбранного периода

data -> Dt -> Diff -> Rq

integer

how total volume changed between the start and the end of the selected period

как изменился общий объем между началом и концом выбранного периода

data -> Kw

array

list of keywords given URL ranks for

список ключевых слов с указанными рейтингами для URL

data -> Kw -> Ph

string

keyword given URL ranks for

ключевое слово с заданным рейтингом для URL

data -> Kw -> Pi

string

keyword ID

id ключевого слова

data -> Kw -> Rq

integer

keyword volume

объем ключевого слова

data -> Kw -> Tp

string (can be “”, “new” or “lost”)

"new" - means that this URL didn't rank for this keyword on the start date of the selected period, but ranks for this keyword on the end date of the selected period. "lost" - means that this URL ranked for this keyword on the start date of the selected period, but doesn't rank this keyword on the end date of the selected period.

«новый» – этот URL не ранжируется ни по одному ключевому слову из кампании на дату начала выбранного периода, но ранжируется по крайней мере по одному ключевому слову кампании на дату окончания выбранного периода.[Разрыв обтекания текста]“потерянный" – этот URL получил рейтинг по крайней мере для одного ключевого слова из кампании на дату начала выбранного периода, но не ранжируется ни по одному ключевому слову из кампании на дату окончания выбранного периода.

data -> Kw -> Tg

array

keyword tags

теги ключевых слов

data -> Kw -> Dt

array

data on overall metrics for a given pair: URL + keyword

данные об общих показателях для данной пары: URL + ключевое слово

data -> Kw -> Dt -> Diff

integer

how position of a given URL, that ranks for given keyword on a given date changed between the start and the end of the selected period

как позиция URL, который ранжируется по ключевому слову на заданную дату, изменилась между началом и концом выбранного периода

data -> Kw -> Lt

array

this array contains data on position type (organic or local map pack)

массив содержит данные о типе позиции (обычный или локальный map pack)

data -> Kw -> Lt -> YYYYMMDD

string (can be “org” or “geo”)

what type of position URL held on the given day; “org” - normal organic position, “geo” - position within local map pack

тип URL позиции на заданный день: «Org» - органическая позиция, «geo» - позиция в локальном поиске / local map pack.

Adwords Landing Pages report / ОТЧЕТ ПО ПЛАТНОЙ ВЫДАЧЕ ЦЕЛЕВЫХ URL
tracking_landing_pages_adwords
Стоимость: 1000 API юнитов за строку (1000 API units per line)

This report lists all landing pages of selected domain for current tracking campaign. For each landing page all the keywords that this landing page ranks for are reported.

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

action*

report

type*

tracking_landing_pages_adwords

request type

тип запроса

url*

string

tracked URL or competitor URL (with mask)

отслеживаемый URL или URL конкурента (с маской)

date_begin

date in YYYYMMDD format

starting date of a selected period

начальная дата выбранного периода

date_end

date in YYYYMMDD format

end date of a selected period

конечная дата выбранного периода

display_tags

string

tags separated by the '|' symbol

теги, разделенные символом |

display_filter

string

filter for columns Ph, Nq, Cp

фильтр по столбцам

display_limit

integer

number of returned results

количество возвращённых результатов

display_offset

integer

This parameter allows you to skip a specified number of lines before sending results

Этот параметр позволяет пропустить указанное количество строк перед отправкой результатов.

display_sort

ph_asc, ph_desc,{DOMAIN_N}_pos_asc,{DOMAIN_N}_pos_desc,{DOMAIN_N}_be_asc,{DOMAIN_N}_be_desc,{DOMAIN_N}_di_asc,{DOMAIN_N}_di_desc, cp_asc, cp_desc, nq_desc, nq_asc

report sortings

сортировка отчета

newlost_filter

new, lost

return only new or lost urls

возвращает только новые или потерянные URL

linktype_filter

  • 0 - Include local pack rankings in all reports. This is the default value.

  • 1 - Show only local pack rankings in all reports

  • 2 - Exclude local pack rankings from all reports

local pack filter

  • 0 - Включить местный рейтинг во все отчеты. Значение по умолчанию.

  • 1 - Выводить только местный рейтинг во всех отчетах

  • 2 - Исключить местный рейтинг из всех отчетов

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Request example

GET /?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=tracking_landing_pages_adwords&display_sort=1_mc_desc&date_begin=20180207&date_end=20180207&display_limit=100&display_filter=&display_offset=0&display_tags=&url=semrush.com/blog&filter_url=&newlost_filter=&linktype_filter=0

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"total": 37,
"state": "0",
"limit": 100,
"offset": 0,
"new": 0,
"lost": 0,
"keywords": 107,
"Pc":{
"http": 0,
"https": 37
},
"data":{
"0":{
"Ur": "https://www.semrush.com/blog/topsy-is-dead-alternative-social-analytics-tools-you-need-to-use-now/",
"Tp": "",
"Dt":{
"20180207":{
"Mc": 9,
"Av": 2.22,
"Tr": 61.518333,
"Tc": 116.040433,
"Rq": 19620
},
"Diff":{
"Mc": 0,
"Av": 0,
"Tr": 0,
"Tc": 0,
"Rq": 0
}
},
"Kw":[
{
"Pi": "7922908393917093815",
"Ph": "topsy analytics",
"Tp": "",
"Rq": 320,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 3.882667,
"Diff": 0
},
"Tc":{
"20180207": 25.819733,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "1522738860508378941",
"Ph": "topsy com analytics",
"Tp": "",
"Rq": 170,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 2.062667,
"Diff": 0
},
"Tc":{
"20180207": 4.682253,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "3772292990852912364",
"Ph": "topsy social",
"Tp": "",
"Rq": 90,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 1.092,
"Diff": 0
},
"Tc":{
"20180207": 0,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "8747962949595138851",
"Ph": "topsy twitter analytics",
"Tp": "",
"Rq": 90,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 1,
"Diff": 0
},
"Tr":{
"20180207": 1.092,
"Diff": 0
},
"Tc":{
"20180207": 9.67512,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "9069259884330927019",
"Ph": "what is topsy com",
"Tp": "",
"Rq": 90,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 2,
"Diff": 0
},
"Tr":{
"20180207": 0.375,
"Diff": 0
},
"Tc":{
"20180207": 0,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "2019165307386841491",
"Ph": "topsy com",
"Tp": "",
"Rq": 5400,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 3,
"Diff": 0
},
"Tr":{
"20180207": 17.1,
"Diff": 0
},
"Tc":{
"20180207": 41.382,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "13769451381664187323",
"Ph": "topsy.com",
"Tp": "",
"Rq": 880,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 3,
"Diff": 0
},
"Tr":{
"20180207": 2.786667,
"Diff": 0
},
"Tc":{
"20180207": 2.870267,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "2409524746484837701",
"Ph": "topsy",
"Tp": "",
"Rq": 12100,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 4,
"Diff": 0
},
"Tr":{
"20180207": 31.863333,
"Diff": 0
},
"Tc":{
"20180207": 25.8093,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
},
{
"Pi": "3435076276275003494",
"Ph": "topsy twitter",
"Tp": "",
"Rq": 480,
"Gs": 1,
"Tg":{},
"Dt":{
"20180207": 4,
"Diff": 0
},
"Tr":{
"20180207": 1.264,
"Diff": 0
},
"Tc":{
"20180207": 5.80176,
"Diff": 0
},
"Lt":{
"20180207":[
"org"
]
}
}
],
"Amp": 0
},
...
}

Возвращенные значения (Return values)

Name

Value

Description

Описание

keywords

integer

number of keywords used to build this report

количество ключевых слов, использованных для построения этого отчета

limit

integer

maximum number of results to return

максимальное количество возвращенных результатов

offset

integer

use this parameter to specify how many results to skip before building a report

используйте параметр, чтобы указать, сколько результатов нужно пропустить перед построением отчета

total

integer

number of results

количество результатов

lost

integer

number of lost URLs (URLs that ranked for at least one keyword from a given campaign on the start date of the selected period, but don't rank for any keyword from a given campaign on the end date of the selected period)

количество потерянных URL-адресов (URL-адреса, которые получили ранжирование хотя бы по одному ключевому слову из кампании на дату начала выбранного периода, но не ранжируются ни по одному ключевому слову из кампании на дату окончания выбранного периода)

new

integer

number of new URLs (URLs that didn't rank for any keyword from a given campaign on the start date of the selected period, but rank for at least one keyword from a given campaign on the end date of the selected period)

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

data

array

list of URLs ranking for keywords from a given campaign

список URL-адресов, ранжируемых по ключевым словам кампании

data -> Ur

string

an URL that ranks for keyword(s) from a given campaign

URL-адрес, который ранжируется по ключевым словам кампании

data -> Tp

string (can be “”, “new” or “lost”)

"new" - means that this URL didn't rank for any keyword from a given campaign on the start date of the selected period, but ranks for at least one keyword from a given campaign on the end date of the selected period. "lost" - means that this URL ranked for at least one keyword from a given campaign on the start date of the selected period, but doesn't rank for any keyword from a given campaign on the end date of the selected period.

«новый» – этот URL не ранжируется ни по одному ключевому слову из кампании на дату начала выбранного периода, но ранжируется по крайней мере по одному ключевому слову кампании на дату окончания выбранного периода.[Разрыв обтекания текста]“потерянный" – этот URL получил рейтинг по крайней мере для одного ключевого слова из кампании на дату начала выбранного периода, но не ранжируется ни по одному ключевому слову из кампании на дату окончания выбранного периода.

data -> Dt

array

data on overall metrics for a given URL

данные об общих показателях для URL

data -> Dt -> YYYYMMDD

array

data on overall metrics for a given URL on a given date

данные об общих показателях для URL на указанную дату

data -> Dt -> YYYYMMDD -> Av

float

average position for a list of keywords given URL ranks for on a given date

средняя позиция для списка ключевых слов с рейтингом URL на указанную дату

data -> Dt -> YYYYMMDD -> Mc

integer

number of keywords given URL ranks for on a given date

количество ключевых слов, по которым URL ранжируется на указанную дату

data -> Dt -> YYYYMMDD -> Rq

integer

total volume for a list of keywords given URL ranks for on a given date

общий объем для списка ключевых слов, по которым URL ранжируется на указанную дату

data -> Dt -> Diff

array

how values of overall metrics changed between the start and the end of the selected period

как изменились значения общих показателей между началом и концом выбранного периода

data -> Dt -> Diff -> Av

float

how average position for a list of keywords given URL ranks for changed between the start and the end of the selected period

как средняя позиция для списка ключевых слов URL изменилась между началом и концом выбранного периода

data -> Dt -> Diff -> Mc

integer

how number of keywords given URL ranks for changed between the start and the end of the selected period

как количество ключевых слов, для которых задан URL, изменилось между началом и концом выбранного периода

data -> Dt -> Diff -> Rq

integer

how total volume changed between the start and the end of the selected period

как изменился общий объем между началом и концом выбранного периода

data -> Kw

array

list of keywords given URL ranks for

список ключевых слов с указанными рейтингами для URL

data -> Kw -> Ph

string

keyword given URL ranks for

ключевое слово с заданным рейтингом для URL

data -> Kw -> Pi

string

keyword ID

id ключевого слова

data -> Kw -> Rq

integer

keyword volume

объем ключевого слова

data -> Kw -> Tp

string (can be “”, “new” or “lost”)

"new" - means that this URL didn't rank for this keyword on the start date of the selected period, but ranks for this keyword on the end date of the selected period. "lost" - means that this URL ranked for this keyword on the start date of the selected period, but doesn't rank this keyword on the end date of the selected period.

«новый» – этот URL не ранжируется ни по одному ключевому слову из кампании на дату начала выбранного периода, но ранжируется по крайней мере по одному ключевому слову кампании на дату окончания выбранного периода.[Разрыв обтекания текста]“потерянный" – этот URL получил рейтинг по крайней мере для одного ключевого слова из кампании на дату начала выбранного периода, но не ранжируется ни по одному ключевому слову из кампании на дату окончания выбранного периода.

data -> Kw -> Tg

array

keyword tags

теги ключевых слов

data -> Kw -> Dt

array

data on overall metrics for a given pair: URL + keyword

данные об общих показателях для данной пары: URL + ключевое слово

data -> Kw -> Dt -> Diff

integer

how position of a given URL, that ranks for given keyword on a given date changed between the start and the end of the selected period

как позиция URL, который ранжируется по ключевому слову на заданную дату, изменилась между началом и концом выбранного периода

data -> Kw -> Lt

array

this array contains data on position type (organic or local map pack)

массив содержит данные о типе позиции (обычный или локальный map pack)

data -> Kw -> Lt -> YYYYMMDD

string (can be “org” or “geo”)

what type of position URL held on the given day; “org” - normal organic position, “geo” - position within local map pack

тип URL позиции на заданный день: «Org» - органическая позиция, «geo» - позиция в локальном поиске / local map pack.

Sortings / Сортировка

Value

Description

Описание

ph_asc

sorting by a keyword in ascending order (Ph)

сортировка по ключевому слову в порядке возрастания (Ph)

ph_desc

sorting by a keyword in descending order (Ph)

сортировка по ключевому слову в порядке убывания (Ph)

{DATE}_asc

sorting by date in ascending order

сортировка по дате в порядке возрастания

{DATE}_desc

sorting by date, in descending order

сортировка по дате в порядке убывания

cp_asc

sorting by CPC in ascending order (Cp)

сортировка по цене за клик в порядке возрастания (Cp)

cp_desc

sorting by CPC in descending order (Cp)

сортировка по цене за клик в порядке убывания (Cp)

nq_asc

sorting by volume in ascending order (Nq)

сортировка по объему в порядке возрастания (Nq)

nq_desc

sorting by volume in descending order (Nq)

сортировка по объему в порядке убывания (Nq)

{DOMAIN_N}_di_asc

sorting by the difference in a domain's previous and current positions in ascending order

сортировка по разнице в предыдущей и текущей позиции домена в порядке возрастания

{DOMAIN_N}_di_desc

sorting by the difference in a domain's previous and current positions in descending order

сортировка по разнице в предыдущей и текущей позиции домена в порядке убывания

{DOMAIN_N}_fi_asc,{DOMAIN_N}_pos_asc

sorting by a position at the end date in ascending order

сортировка по позиции на дату окончания в порядке возрастания

{DOMAIN_N}_fi_desc,{DOMAIN_N}_pos_desc

sorting by a position at the end date in descending order

сортировка по позиции на дату окончания в порядке убывания

{DOMAIN_N}_be_asc

sorting by a position at the starting date in ascending order

сортировка по позиции на начальную дату в порядке возрастания

{DOMAIN_N}_be_desc

sorting by a position at the starting date in ascending order

сортировка по позиции на начальную дату в порядке возрастания

ur_asc

sorting by a URL in ascending order

сортировка по URL в порядке возрастания

ur_desc

sorting by a URL in descending order

сортировка по URL в порядке убывания

cl_asc

sorting by visibility in ascending order

сортировка по видимости в порядке возрастания

cl_desc

sorting by visibility in descending order

сортировка по видимости в порядке убывания

cd_asc

sorting by visibility change in ascending order

сортировка по изменению видимости в порядке возрастания

cd_desc

sorting by visibility change in descending order

сортировка по изменению видимости в порядке убывания

av_asc

sorting by average position in ascending order

сортировка по средней позиции в порядке возрастания

av_desc

sorting by average position in descending order

сортировка по средней позиции в порядке убывания

{DATE}date in YYYYMMDD format
{DOMAIN_N}- domain number (0,1,2,3,4)

Filters / Фильтры

Чтобы применить фильтр к отчету, вы должны добавить параметр display_filter со строкой в кодировке URL, содержащей фильтры, разделенные знаком "|" (максимальное количество - 25).

Фильтр состоит из |||

ParameterValuesDescription
sign "+" or "-" include or exclude
field Ph, Cp, Nq
  • Ph - phrase
  • Cp - Средняя цена 1 клика по объявлению в (Google AdWords) по данному запросу для рекламодателя (в долларах США).
  • Nq - Среднемесячное количество поисковых запросов по данному ключевому слову. Это значение рассчитывается за последние 12 месяцев.
operation for metrical fields: Eq, Gt, Lt
for textual fields: Bw, Ew, Eq, Co
for metrical fields:
  • Eq - exactly matching
  • Gt - greater than
  • Lt - less than
for textual fields:
  • Bw - starts with
  • Ew - ends with
  • Eq - exactly matching
  • Co - containing
value value to filter

Site Audit Tool Management / Управление инструментами аудита сайта

Базовый URL для всех запросов:

https://api.semrush.com/management/v1/projects/{ID}/siteaudit
Enable the Site Audit Tool / ВКЛЮЧИТЬ ИНСТРУМЕНТ АУДИТА САЙТА
siteaudit_campaign_save
Стоимость: 100 API units per request

Запрос позволяет вам включить инструмент аудита сайта для проекта, который дает возможность планировать аудит, включать или исключать страницы из сканирования и устанавливать количество страниц для сканирования.

Запрашиваемый URL (Requested URL)[POST]

https://api.semrush.com/management/v1/projects/{ID}/siteaudit/enable?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Request example

{
"domain": "www.mysite.com",
"scheduleDay": 1,
"notify": false,
"allow":["", "", ""],
"disallow":["", "", ""],
"pageLimit": 1000,
"userAgentType": 2,
"removedParameters":["", "", ""]
"crawlSubdomains": true,
"respectCrawlDelay": false
}

Параметры запроса (Request parameters)

domain

Project URL

URL проекта

scheduleDay

run periodically day(1..7) if 0 - manual start

запускать периодически день (1..7) если 0 - ручной запуск

notify

Email notification about the finished audit

Уведомление по электронной почте о завершении аудита

allow

Mask ALLOW in this project

Маска РАЗРЕШИТЬ в этом проекте

disallow

Mask DISALLOW in this project

Маска DISALLOW в этом проекте

pageLimit

Number of crawled page

Количество просканированных страниц

userAgentType

Type of user agent. Available values:

  • 0 - SemrushBot Desktop

  • 1 - SemrushBot Mobile

  • 2 - GoogleBot Desktop

  • 3 - GoogleBot Mobile

"Тип пользовательского агента. Доступные значения:

0 - Рабочий стол SemrushBot

1 - SemrushBot Mobile

2 - GoogleBot Desktop

3 - GoogleBot Mobile "

removedParameters

Specifies URL parameters to be excluded from the audit scope

Задает параметры URL, которые нужно исключить из области аудита.

crawlSubdomains

Specifies whether to crawl subdomains of the selected domain. Available values:

  • true - SemrushBot will crawl the selected domain, including its subdomains

  • false - SemrushBot will crawl the selected domain, excluding its subdomains

Указывает, сканировать ли субдомены выбранного домена. Доступные значения:

true - SemrushBot просканирует выбранный домен, включая его поддомены

false - SemrushBot просканирует выбранный домен, исключая его поддомены

respectCrawlDelay

Specifies whether SemrushBot should follow the “crawl-delay” directive in robots.txt. Available values:

  • true - SemrushBot will follow the “crawl-delay” directive in robots.txt

  • false - SemrushBot will crawl pages with an interval of 1 second

Указывает, должен ли SemrushBot следовать директиве crawl-delay в файле robots.txt. Доступные значения:

true - SemrushBot будет следовать директиве crawl-delay в robots.txt.

false - SemrushBot будет сканировать страницы с интервалом в 1 секунду

Edit a campaign / РЕДАКТИРОВАТЬ КАМПАНИЮ
siteaudit_campaign_save
Стоимость: 100 API units per request

Запрос позволяет вам изменить существующую кампанию аудита сайта, что дает возможность перенастроить аудит, изменить объем страниц для сканирования и количество страниц.

Запрашиваемый URL (Requested URL)[POST]

https://api.semrush.com/management/v1/projects/{ID}/siteaudit/save?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Request example

{
"domain": "www.mysite.com",
"scheduleDay": 1,
"notify": false,
"allow":["", "", ""],
"disallow":["", "", ""],
"pageLimit": 1000,
"userAgentType": 2,
"removedParameters":["", "", ""]
"crawlSubdomains": true,
"respectCrawlDelay": false
}

Параметры запроса (Request parameters)

domain

Project URL

URL проекта

scheduleDay

run periodically day(1..7) if 0 - manual start

запускать периодически день (1..7) если 0 - ручной запуск

notify

Email notification about the finished audit

Уведомление по электронной почте о завершении аудита

allow

Mask ALLOW in this project

Маска РАЗРЕШИТЬ в этом проекте

disallow

Mask DISALLOW in this project

Маска DISALLOW в этом проекте

pageLimit

Number of crawled page

Количество просканированных страниц

userAgentType

Type of user agent. Available values:

  • 0 - SemrushBot Desktop

  • 1 - SemrushBot Mobile

  • 2 - GoogleBot Desktop

  • 3 - GoogleBot Mobile

"Тип пользовательского агента. Доступные значения:

0 - Рабочий стол SemrushBot

1 - SemrushBot Mobile

2 - GoogleBot Desktop

3 - GoogleBot Mobile "

removedParameters

Specifies URL parameters to be excluded from the audit scope

Задает параметры URL, которые нужно исключить из области аудита.

crawlSubdomains

Specifies whether to crawl subdomains of the selected domain. Available values:

  • true - SemrushBot will crawl the selected domain, including its subdomains

  • false - SemrushBot will crawl the selected domain, excluding its subdomains

Указывает, сканировать ли субдомены выбранного домена. Доступные значения:

true - SemrushBot просканирует выбранный домен, включая его поддомены

false - SemrushBot просканирует выбранный домен, исключая его поддомены

respectCrawlDelay

Specifies whether SemrushBot should follow the “crawl-delay” directive in robots.txt. Available values:

  • true - SemrushBot will follow the “crawl-delay” directive in robots.txt

  • false - SemrushBot will crawl pages with an interval of 1 second

Указывает, должен ли SemrushBot следовать директиве crawl-delay в файле robots.txt. Доступные значения:

true - SemrushBot будет следовать директиве crawl-delay в robots.txt.

false - SemrushBot будет сканировать страницы с интервалом в 1 секунду

Reports / Отчеты

Базовый URL для всех запросов:

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit
Get a list of a campaign's snapshots / ПОЛУЧИТЬ СПИСОК СНАПШОТОВ КАМПАНИИ
siteaudit_snapshot_list
Стоимость: 100 API units per request

Запрос позволяет вам получить список идентификаторов прошлых аудитов, включая даты их завершения.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/snapshots?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"snapshots":[
{
"snapshot_id":"540d9e420cf2e0c1006966e3",
"finish_date":1410178856809
},
{
"snapshot_id":"54102bd20cf2e0c100696a10",
"finish_date":1410345954754
}]
}

Параметры ответа (Response parameters)

snapshot_id

Snapshot id

id снимка

finish_date

Date when the last audit finished

Дата окончания последнего аудита

Get text descriptions about issues / ПОЛУЧИТЬ ТЕКСТОВОЕ ОПИСАНИЕ ПРОБЛЕМ С САЙТОМ
siteaudit_meta
Стоимость: 100 API units per request

Запрос выдает текстовое описание того, почему проблема может быть опасной для веб-сайта и как ее можно исправить.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/meta/issues?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Response example

{
"issues":[
{
"id":1,
"title":"HTTP 5XX server errors",
"desc":"5xx errors happen on the server’s side. (500 – an internal server error; 503 – a server is unavailable; 507 – a server is running out of memory, etc.) \n\nHaving a lot of error pages negatively affects both User Experience and a search engine robot’s crawlability, which can lead to less traffic to your website.",
"title_page":"##count## pages returned 5XX status code upon request",
"title_detailed":"This page returned 5XX status code on request",
"info_column":"Code",
"count_description":"This page returned 5XX status code on request",
"multidata":false,
"other_problem_link":"##count## more page on this site has 500 status code",
"desc_with_link":" ##count## pages returned 5XX status code upon request"
}]
}

Параметры ответа (Response parameters)

id

Issue id

id проблемы

title

Issue Title

название проблемы

desc

Issue Description

описание проблемы

title_page

Page Title

название страницы

info_column

-

count_description

-

multidata

-

other_problem_link

-

desc_with_link

-

Run Audit / ЗАПУСК АУДИТА
siteaudit_launch
Стоимость: 100 API units per request

Запрос запуска аудита

Запрашиваемый URL (Requested URL)[POST]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/launch?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"snapshot_id":"54102d92e4b0f889a040c9c8"
}

Параметры ответа (Response parameters)

snapshot_id

Snapshot ID for this audit

ID снапшота аудита

Get information about a campaign / ПОЛУЧИТЬ ИНФОРМАЦИЮ О КАМПАНИИ
siteaudit_campaign_info
Стоимость: 100 API units per request

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

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/info?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"id":4594705336925861,
"name":"test",
"url":"semrush.com",
"status":"FINISHED",
"errors":228,
"warnings":391,
"notices":9,
"broken":0,
"blocked":0,
"redirected":2,
"healthy":1,
"haveIssues":2,
"haveIssuesDelta":0,
"defects":{"109":2},
"markups":{
"twitterCard":0,
"openGraph":0,
"schemaOrg":0,
"microfomats":0
},
"depths":{"0":3},
"crawlSubdomains":true,
"respectCrawlDelay":false,
"canonical":0,
"user_agent_type":2,
"last_audit":1410346398040,
"last_failed_audit":0,
"next_audit":-1,
"running_pages_crawled":178,
"running_pages_limit":500,
"pages_crawled":178,
"pages_limit":500,
"total_checks":22725,
"errors_delta":0,
"warnings_delta":0,
"notices_delta":0,
"mask_allow":[],
"mask_disallow":[],
"removedParameters":["rr","r","p"],
"excluded_checks":null
}

Параметры ответа (Response parameters)

id

Project ID

ID проекта

url

Project URL

URL проекта

name

Project name

Название проекта

status

Audit’s status: Running, Finished, Checking, or Saving

Статус аудита: "Выполняется", "Завершено", "Проверяется" или "Сохраняется".

errors

Number of errors found during the last audit

Количество ошибок, обнаруженных во время последней проверки

warnings

Number of warnings found during the last audit

Количество предупреждений, обнаруженных во время последней проверки

notices

Number of notices found during the last audit

Количество уведомлений, обнаруженных во время последней проверки

broken

Number of broken pages

Количество битых страниц

blocked

Number of pages blocked from crawling

Количество страниц, сканирование которых заблокировано

redirected

Number of redirecting pages

Количество перенаправляющих страниц

healthy

Number of healthy pages

Количество здоровых страниц

haveIssues

Number of pages with issues

Количество страниц с проблемами

haveIssuesDelta

Difference in the number of issues found during the previous and last audits

Разница в количестве проблем, обнаруженных в ходе предыдущей и последней аудиторских проверок.

defects

List of issue IDs detected on crawled pages and the number of times each issue was detected

Список идентификаторов проблем, обнаруженных на просканированных страницах, и количество обнаружений каждой проблемы.

markups

Number of markups detected on crawled pages. Supported markups are: Twitter Card, Open Graph, Schema.org, microfomats

Количество разметок, обнаруженных на просканированных страницах. Поддерживаемые разметки: Twitter Card, Open Graph, Schema.org, микрофоматы.

depths

Number of clicks required for SemrushBot to reach an analyzed page from the homepage

Количество кликов, необходимое SemrushBot для перехода на анализируемую страницу с главной страницы.

crawlSubdomains

Indicates whether SemrushBot crawled subdomains of the selected of the analyzed domain:

  • true - SemrushBot crawled the analyzed domain, including its subdomains

  • false - SemrushBot crawled the analyzed domain, excluding its subdomains

Указывает, сканировал ли SemrushBot поддомены выбранного из анализируемого домена:

true - SemrushBot просканировал анализируемый домен, включая его поддомены

false - SemrushBot просканировал анализируемый домен, исключая его поддомены

respectCrawlDelay

Indicates whether SemrushBot followed the “crawl-delay” directive in robots.txt:

  • true - SemrushBot followed the “crawl-delay” directive in robots.txt

  • false - SemrushBot crawled pages with an interval of 1 second

Указывает, соблюдал ли SemrushBot директиву crawl-delay в robots.txt:

true - SemrushBot следовал директиве crawl-delay в robots.txt

false - SemrushBot сканировал страницы с интервалом в 1 секунду

canonical

Indicates whether an analyzed page is marked with the rel=“canonical” link element

Указывает, помечена ли анализируемая страница элементом ссылки rel = «canonical».

user_agent_type

Type of user agent:

  • 0 - SemrushBot Desktop

  • 1 - SemrushBot Mobile

  • 2 - GoogleBot Desktop

  • 3 - GoogleBot Mobile

Тип пользовательского агента:

0 - Рабочий стол SemrushBot

1 - SemrushBot Mobile

2 - GoogleBot Desktop

3 - GoogleBot Mobile

last_audit

Date of the last audit

Дата последней проверки

last_failed_audit

Date of the last site audit failure

Дата последнего сбоя аудита сайта

next_audit

Date of next scheduled audit

Дата следующего планового аудита

running_pages_crawled

Number of pages crawled during the running audit

Количество страниц, просканированных во время текущего аудита

running_pages_limit

Crawled pages' limit for the running audit

Лимит просканированных страниц для текущего аудита

pages_crawled

Number of crawled pages

Количество просканированных страниц

pages_limit

Crawled pages limit

Лимит просканированных страниц

total_checks

Total checks made during the last audit

Всего проверок, проведенных во время последней проверки

errors_delta

Difference in the number of errors found during the previous and last audits

Разница в количестве ошибок, обнаруженных при предыдущем и последнем аудитах

warnings_delta

Difference in the number of warnings found during the previous and last audits

Разница в количестве предупреждений, обнаруженных при предыдущем и последнем аудитах

notices_delta

Difference in the number of notices found during the previous and last audits

Разница в количестве уведомлений, обнаруженных в ходе предыдущей и последней проверок

mask_allow

Mask ALLOW in this project

Маска РАЗРЕШИТЬ в этом проекте

mask_disallow

Mask DISALLOW in this project

Маска DISALLOW в этом проекте

removedParameters

URL parameters excluded from the audit scope

Параметры URL исключены из области аудита

excluded_checks

IDs of issues (errors, warnings and notices) excluded from the audit scope

Идентификаторы проблем (ошибок, предупреждений и уведомлений), исключенных из области аудита

Get information about a snapshot / ПОЛУЧИТЬ ИНФОРМАЦИЮ О СНАПШОТЕ
siteaudit_snapshot_info
Стоимость: 10000 API units per request

Запрос позволяет вам получить обзор аудита, включая оценку веб-сайта, проблемы, количество выполненных проверок и т. д.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/snapshot?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&snapshot_id={snapshot_id}

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

snapshot_id

String

Snaphot Id, or latest snapshot

Идентификатор снапшота, или последний снапшот

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"quality":{
"value":42,
"delta":0
},
"errors":[
{
"id":1,
"count":4,
"delta":0,
"checks":174
},
],
"warnings":[
{
"id":101,
"count":2,
"delta":0,
"checks":127
},
],
"notices":[
{
"id":201,
"count":1,
"delta":0,
"checks":127
},
],
"snapshot_id":"54102d92e4b0f889a040c9c8",
"pages_crawled":178,
"finish_date":1410346398040
}

Параметры ответа (Response parameters)

quality.value

Website's score

Оценка веб-сайта

quality.delta

Difference in scores a website received during the previous and last audits

Разница в баллах, полученных сайтом в ходе предыдущего и последнего аудита

snapshot_id

Snapshot ID

ID снапшота

pages_crawled

Crawled pages

Просканированные страницы

finish_date

Date when the last audit finished

Дата окончания последнего аудита

warnings|errors|notices.id

Issue ID

Идентификатор проблемы

warnings|errors|notices.count

Number of found issues

Количество найденных проблем

warnings|errors|notices.delta

Difference in the number of issues found during the previous and last audits

Разница в количестве проблем, обнаруженных в ходе предыдущей и последней аудиторских проверок.

warnings|errors|notices.checks

the number of performed checks for errors, warnings, or notices

количество выполненных проверок на наличие ошибок, предупреждений или уведомлений

Detailed report for an issue / ДЕТАЛЬНЫЙ ОТЧЕТ О ПРОБЛЕМЕ
siteaudit_snapshot_issue
Стоимость: 100 API units per request or 100 API units by one issue

В отчете содержится описание проблемы, когда эта проблема была обнаружена, а также URL-адреса затронутых страниц. Работает только для последнего снапшота.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/snapshot/{snapshotId}/issue/{issueId}?page={page}&filter={filter}&sort={sort}&limit={limit}&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

key*

string

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

snapshotId*

string

ID of the last snapshot

Идентификатор последнего снимка

issueId*

integer

Issue ID

Идентификатор проблемы

page

integer

Pagination. If not specified, the default value will be 1.

Пагинация. Если не указано, значение по умолчанию будет 1.

filter

string

Filters data. Add this parameter as many times as you need.

Фильтрует данные. Добавьте этот параметр столько раз, сколько вам нужно.

limit

integer

Limits data. If not specified, the default value will be 10.

Ограничивает данные. Если не указано, значение по умолчанию будет 10.

sort

  • index_desc, index_asc

  • targeturl_desc,targeturl_asc

  • firstseen_desc, firstseen_asc

  • dominteractivetime_desc, dominteractivetime_asc

  • samplesize_desc, samplesize_asc

  • tag_desc, tag_asc

  • code_desc, code_asc

  • val_desc, val_asc

  • count_desc, count_asc

  • resourcetype_desc, resourcetype_asc

  • info_desc, info_asc

  • infourl_desc, infourl_asc

  • item_desc, item_asc

  • fields_desc, fields_as

Sorting.

Сортировка

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"limit":10,
"page":1,
"total":101,
"data":[
{
"title":"Web Tutorials • Mike & Associates",
"info":"404",
"first_seen":1410178856809,
"last_seen":1410346398040,
"target_url":"http://semrush.com/errors/404.html",
"page_id":"54102d9e0cf2e0c100696c88",
"source_url":"http://semrush.com"
},
],
"issue_id":8
}

Параметры ответа (Response parameters)

Date when an issue was first noticed

limit

Limit result on one page

Ограничить результат на одной странице

page

Page number

Номер страницы

total

Total number of results per request

Общее количество результатов на запрос

issue_id

Issue ID

Идентификатор проблемы

title

The title of a page on which an error has been detected

Заголовок страницы, на которой обнаружена ошибка.

info

Issue's description

Описание проблемы

first_seen

first seen

впервые замечена

last_seen

Date when an issue was last noticed

Дата, когда проблема была замечена в последний раз

target_url

Target URL (for example, for a broken link issue, a URL of a webpage returning an error status will be shown)

Целевой URL-адрес (например, для проблемы с неработающей ссылкой будет показан URL-адрес веб-страницы, возвращающей статус ошибки)

page_id

Page ID

ID страницы

source_url

The URL of a webpage on which an error has been detected

URL-адрес веб-страницы, на которой обнаружена ошибка.

Get page ID by an URL / ПОЛУЧИТЬ ID СТРАНИЦЫ ПО URL
siteaudit_page_list
Стоимость: 100 API units per request

Запрос выдает вам идентификатор просканированной страницы.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/page/list?url_contains={url}&limit={limit}&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

url*

String

url for search(contains match)

URL для поиска (содержит совпадения)

limit

integer default 10

limit data line

ограничить строку данных

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"data":[
{
"url":"http://semrush.com",
"page_id":"54102d9e0cf2e0c100696c88"
},
],
"total":178
}

Параметры ответа (Response parameters)

url

url

url

page_id

page id

id страницы

total

Total number of results per request

Общее количество результатов на запрос

Get information about a page / ПОЛУЧИТЬ ИНФОРМАЦИЮ О СТРАНИЦЕ
siteaudit_page_info
Стоимость: 1000 API units per request

Запрос выдает информацию о странице и список ее проблем.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/page/{pageId}?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

pageId*

String

page ID

ID страницы

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"weight":0,
"title":"Web Tutorials • Mike & Associates",
"url":"http://semrush.com",
"notices":[
{
"id":202,
"data":[
{
"discovered":1410178856809,
"info":null,
"target_url":"http://%/test.com"
}
],
"total":8
}
],
"warnings":[
{
"id":110,
"data":[
{
"discovered":1410178856809,
"info":null,
"target_url":"http://semrush.com/index_files/html.jpg"
},
],
"total":200
}
],
"errors":[
{
"id":8,
"data":[
{
"discovered":1410178856809,
"info":"503",
"target_url":"http://semrush.com/errors/503.html"
},
],
"total":101
},
],
"page_id":"54102d9e0cf2e0c100696c88"
}

Параметры ответа (Response parameters)

weight

This page's weight

Вес этой страницы

title

This page's title

Заголовок этой страницы

url

URL

URL

notices|warnings|errors.id

Issue ID

Идентификатор проблемы

notices|warnings|errors.discovered

Date when an issue was first noticed

Дата, когда проблема была впервые замечена

notices|warnings|errors.info

Issue's description

Описание проблемы

notices|warnings|errors.target_url

Target URL (for example, for a broken link issue, a URL of a webpage returning an error status will be shown)

Целевой URL-адрес (например, для проблемы с неработающей ссылкой будет показан URL-адрес веб-страницы, возвращающей статус ошибки)

notices|warnings|errors.total

Total Issues

Всего проблем

page_id

Page ID

ID страницы

Get snaphots history / ПОЛУЧИТЬ ИСТОРИЮ СНАПШОТОВ
siteaudit_campaign_history
Стоимость: 10000 API units per request or 10000 API units by one snapshot

Этот запрос позволяет увидеть результаты аудитов за выбранный период.

Запрашиваемый URL (Requested URL)[GET]

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/history?limit={limit}&offset={offset}&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Параметры запроса (Request parameters)

Name

Value

Description

Описание

key*

String

An identification key assigned to a user after subscribing to Semrush that is available via Profile page

Идентификационный ключ, назначаемый пользователю после подписки на Semrush, доступный на странице профиля.

limit*

Integer default 7

limit

offset*

Integer default 0

offset

Поля, отмеченные звездочкой (*), обязательны для заполнения.

Ответ (Response)

Result Code
Success HTTP 200
Error HTTP 400

Пример ответа (Response example)

{
"data":[
{
"quality":{
"value":42,
"delta":0
},
"errors":[
{
"id":1,
"count":4,
"delta":0,
"checks":174
},
],
"warnings":[
{
"id":101,
"count":2,
"delta":0,
"checks":127
},
],
"notices":[
{
"id":201,
"count":1,
"delta":0,
"checks":127
},
],
"snapshot_id":"54102d92e4b0f889a040c9c8",
"pages_crawled":178,
"finish_date":1410346398040
},
],
"total":0,
"limit":0,
"offset":0
}

Параметры ответа (Response parameters)

quality.value

Website's score

Оценка веб-сайта

quality.delta

Difference in scores a website received during the previous and last audits

Разница в баллах, полученных сайтом в ходе предыдущего и последнего аудита

snapshot_id

Snapshot ID

ID снапшота

pages_crawled

Crawled pages

Просканированные страницы

finish_date

Date when the last audit finished

Дата окончания последнего аудита

warnings|errors|notices.id

Issue ID

Идентификатор проблемы

warnings|errors|notices.count

Number of found issues

Количество найденных проблем

warnings|errors|notices.delta

Difference in the number of issues found during the previous and last audits

Разница в количестве проблем, обнаруженных в ходе предыдущей и последней проверок.

warnings|errors|notices.checks

the number of performed checks for errors, warnings, or notices

количество выполненных проверок на наличие ошибок, предупреждений или уведомлений

Filters / Фильтры

Чтобы применить фильтр к отчету, добавьте параметр фильтра со строкой в кодировке URL.

Формат: '[+-]|field|operator|value1;...;valueN'

Parameter

Values

Description

Описание

sign

"+" or "-"

Include or exclude

включить / исключить

field

string

Filter by the specified field

фильтр по полям

operation

Bw, Ew, Eq, Co

  • Bw - begins with

  • Ew - ends with

  • Eq - equals

  • Co - contains

Bw - начинается с

Ew - оканчивается на

Eq - равно

Co - содержит

values

string

List of values separated by ';'

Список значений, разделенных ';'

Example filter string:'+|source_url|Co|semrush;site_audit'

If you want to apply a number of filters, keep adding the filter parameter. Example:

https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/snapshot/{snapshotId}/issue/{issueId}?filter={filter1}&filter={filter2}&filter={filter3}

Price in API units

$1 = 20,000 API units. View SEMrush API packages
Цены отображаются для таких типов запросов, как: lines, calls и keywords
Тип Описание Стоимость в единицах API
на строку на вызов на ключевое слово
project_list List all existing projects 100
project_get Get information about an existing project 100
project_create Create a new project 100 100*
project_update Update an existing project 100 100*
project_delete Delete an existing project 100
project_add_keywords Add keywords to an existing project 100
project_delete_keywords Remove keywords from an existing project 100
project_add_competitors Add competitors to an existing project 100
project_delete_competitors Remove competitors from an existing project 100
project_add_tags Group keywords with tags in an existing project 100
project_remove_tags Remove tags from keywords in an existing project 100
tracking_overview_organic Organic Overview 100
tracking_visibility_organic Organic Visibility Index report 100
tracking_visibility_adwords AdWords Visibility Index report 100
tracking_position_organic Organic Positions report 100
tracking_position_adwords AdWords Positions report 100
tracking_competitors_organic Organic Competitors Discovery report 1000
tracking_competitors_adwords AdWords Competitors Discovery report 1000
tracking_landing_pages_organic Organic Landing Pages report 1000
tracking_landing_pages_adwords Adwords Landing Pages report 1000
tracking_campaign_dates Campaign Dates 100
tracking_enable Enable the Position Tracking Tool in a project 100
tracking_notification_update Enable/Disable email-sending containing project statistics 100
get_countries Get a list of countries 100
get_regions Get a list of regions 100
get_cities Get a list of cities 100
siteaudit_snapshot_list Get a list of a campaign's snapshots 100
siteaudit_meta Get text descriptions about issues 100
siteaudit_launch Run Audit 100
siteaudit_campaign_info Get information about a campaign 100
siteaudit_campaign_save Enable the Site Audit Tool 100
siteaudit_snapshot_info Get information about a snapshot 10000
siteaudit_snapshot_issue Detailed report for an issue 100 100
siteaudit_page_list Get page ID by an URL 100
siteaudit_page_info Get information about a page 1000
siteaudit_campaign_history Get snaphots history 10000** 10000
* Дополнительные юниты API взимаются за каждое новое добавленное ключевое слово.[Разрыв обтекания текста]
** По снапшотам

Error Messages / Сообщения об ошибках

Сообщения об ошибках API проектов возвращаются в определенном формате:

{"code":{ERROR_CODE}, "message":{ERROR_MESSAGE}}
ERROR_CODE integer Machine-parseable codes
ERROR_MESSAGE string Descriptive error text

В дополнение к описанию ошибки сообщения об ошибках содержат коды, анализируемые компьютером. Хотя текст сообщения об ошибке может измениться, коды останутся прежними. В следующей таблице описаны коды, которые могут появиться при работе с API::

ERROR_CODE ERROR_MESSAGE
511 Unknown error
512 Can't find project with project_id{ID}
513 Invalid tool_id
515 Campaign already exists
519 Missing mandatory URL parameter
520 Invalid tag name
521 Projects limit exceed, projects created:{projects_count}, user limit are{projects_limit}
522 Keywords limit exceed, keywords limit{keywords_limit}already tracked keywords{keywords_count}
70 API key hash failure
120 Wrong key - ID pair
121 Wrong format or empty hash
122 Wrong format or empty key
130 Api disabled
131 Limit exceeded
132 API units balance is zero
134 Total limit exceeded