logo-small logo-small_halloween

SEMrush API
3.0

Есть вопросы?
Клиенты из США, бесплатный звонок
+1-800-815-9959
не в сети
c понедельника по пятницу (ET)
Российские клиенты, бесплатный звонок
United Kingdom
España
France
Italia
+44 (808) 1642570
в сети
c понедельника по пятницу по местному времени

Analytics API

Once you get your API key, you can start integrating with SEMrush API. Below you will find which reports you can request and which columns, parameters, values, sortings, and filters you can use.

Сводные отчеты
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report provides live or historical data on a domain’s keyword rankings in both organic and paid search in all regional databases.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_ranksтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database database база, к которой производится запрос (одно значение из списка); если параметр не указан, будут отправлены данные для всех имеющихся баз данных
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Db, Dt, Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sh, Sv список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
* обязательные поля

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

https://api.semrush.com/?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&type=domain_ranks&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac,Sh,Sv&domain=apple.com&database=us

Пример ответа

Database;Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;PLA keywords;PLA uniques us;apple.com;17;16464474;149904314;169865994;128201;2419518;2807373;38208;1583
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report provides live or historical data on a domain’s keyword rankings in both organic and paid search in a chosen regional database.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_rankтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
* обязательные поля

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

https://api.semrush.com/?type=domain_rank&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=seobook.com&database=us

Пример ответа

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost seobook.com;24041;5249;37332;143496;0;0;0
domain_rank_history
Цена: 10 API юниты за строку

This report provides live and historical data on a domain’s keyword rankings in both organic and paid search in a chosen database.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_rank_historyтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_daily 1 при передаче данного параметра в отчете будут показываться данные за предыдущие 30 дней или больше, в остальных случаях - показываются данные по месяцам за всю историю
export_columns Rk, Or, Ot, Oc, Ad, At, Ac, Dt список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort dt_asc, dt_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.

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

https://api.semrush.com/?type=domain_rank_history&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Rk,Or,Ot,Oc,Ad,At,Ac,Dt&domain=ebay.com&database=us

Пример ответа

Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Date 19;31504470;130638193;86905921;855962;25237906;18531300;20181215 19;31428334;130546351;87216370;781997;24688558;18258152;20181115 20;34087220;132189007;87847948;681771;18793935;14881683;20181015 24;36261896;108559244;79568188;596593;18348335;13814442;20180915 17;35872063;145322220;98773137;459219;17132356;11858911;20180815 22;31971728;126192213;83310184;396048;14714089;10535151;20180715 22;32150402;129064157;85648349;656471;17195723;11821757;20180615 22;32233111;129012619;87024318;572933;16868825;11620251;20180515 22;33578371;129326683;86572478;568862;16842916;11609684;20180415 23;34324832;128669039;85257252;565697;16847760;11621421;20180315
rank_difference
Цена: 20 API юниты за строку Цена за исторические данные: 100 API юниты за строку

This report shows changes in the number of keywords, traffic, and budget estimates of the most popular websites in Google top 100 and paid search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*rank_differenceтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date date in format "YYYYMM15" for historical data or "YYYYMMDD" for the last 30 days позволяет запросить отчеты с историческими данными
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Om, Tm, Um, Am, Bm, Cm список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort om_asc, om_desc, tm_asc, tm_desc, um_asc, um_desc, am_asc, am_desc, bm_asc, bm_desc, cm_asc, cm_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
* обязательные поля

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

https://api.semrush.com/?type=rank_difference&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=5&database=us

Пример ответа

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords Difference;Organic Traffic Difference;Organic Cost Difference;Adwords Keywords Difference;Adwords Traffic Difference;Adwords Cost Difference wikipedia.org;1;83084012;1953530514;1766901500;98;6375;9285;469000;176196;-1008051;1;3;13 sites-domme.com;82912;356281;17749;18861;0;0;0;329506;16924;18008;0;0;0 namvideo.com;32556;996641;56717;37766;0;0;0;251320;9382;2923;0;0;0 suziequimpertraiteur.com;83918;472690;17493;23327;0;0;0;173988;-11050;-12218;0;0;0 pinterest.es;4684;4842602;531065;176004;0;0;0;155799;24012;-2499;0;0;0
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report lists the most popular domains ranked by traffic originating from Google top 100 organic search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*rankтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date date in format "YYYYMM15" for historical data or "YYYYMMDD" for the last 30 days позволяет запросить отчеты с историческими данными
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
* обязательные поля

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

https://api.semrush.com/?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&type=rank&display_limit=10&database=us

Пример ответа

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost wikipedia.org;1;83084012;1953530514;1766901500;98;6375;9285 youtube.com;2;71381392;874589621;496405761;68366;63473756;29516519 amazon.com;3;76392627;677301991;516247065;7674897;606923091;363744884 facebook.com;4;59801076;629787192;375601566;86015;33960778;26585075 google.com;5;298085025;613488552;566022367;1595846;281663489;487303722 imdb.com;6;17461526;483977535;412200555;6339;560097;106539 twitter.com;7;32510040;385551377;360045590;9697;2709637;2624519 pornhub.com;8;5153670;256082593;63910755;0;0;0 merriam-webster.com;9;2491950;213086954;188495487;88;157540;58197 craigslist.org;10;6979245;206372423;286510568;139;63063;69747
Отчеты по домену
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report lists keywords that bring users to a domain via Google top 100 organic search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_organicтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
display_daily 1 при передаче данного параметра в отчете будут показываться данные за предыдущие 30 дней или больше, в остальных случаях - показываются данные по месяцам за всю историю This option is applied only when display_positions is set.
export_columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tg, Tc, Co, Nr, Td, Kd, Fl, Ts список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc, co_asc, co_desc, kd_asc, kd_desc, cp_asc, cp_desc, nr_asc, nr_desc, ts_asc, ts_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_positions new, lost, rise или fall new - показать ключевые слова, появившиеся в текущем месяце
lost - показать ключевые слова, исчезнувшие в текущем месяце
rise - показать ключевые слова, улучшившие свои позиции в текущем месяце
fall - показать ключевые слова, ухудшившие свои позиции в текущем месяце
display_filter Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Fl фильтр для столбцов
* обязательные поля

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

https://api.semrush.com/?type=domain_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CPh%7CCo%7Cseo&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&domain=seobook.com&display_sort=tr_desc&database=us

Пример ответа

Keyword;Position;Previous Position;Position Difference;Search Volume;CPC;Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends seo;9;10;1;110000;14.82;http://www.seobook.com/;17.53;44.40;0.50;0;0.81,1.00,1.00,1.00,1.00,0.81,0.81,0.81,0.81,0.81,0.81,0.81 seobook;1;1;0;1300;4.54;http://www.seobook.com/;5.52;4.28;0.32;379000;0.62,0.81,0.62,0.81,0.81,0.62,0.62,0.81,0.81,0.62,1.00,0.81 seo tools;6;6;0;8100;10.54;http://tools.seobook.com/;2.15;3.87;0.54;321000000;0.67,0.82,0.82,1.00,0.82,0.82,0.67,0.67,0.67,0.67,0.82,0.82 seo basics;2;2;0;1600;6.84;http://www.seobook.com/learn-seo/seo-basics/;1.10;1.29;0.22;42500000;0.81,1.00,1.00,1.00,1.00,1.00,1.00,1.00,1.00,0.81,1.00,0.81 seo book keyword tool;1;1;0;110;16.73;http://tools.seobook.com/keyword-tools/seobook/;0.46;1.33;0.34;5340000;0.41,0.41,0.52,0.52,0.65,0.82,0.65,1.00,1.00,0.82,0.65,0.41 seo book keyword density;1;1;0;110;6.64;http://tools.seobook.com/general/keyword-density/;0.46;0.53;0.15;539000;0.14,0.43,0.43,0.33,0.33,0.24,0.52,0.67,0.81,0.81,1.00,1.00 free seo tools;6;6;0;1600;7.18;http://tools.seobook.com/;0.42;0.52;0.60;204000000;0.68,0.84,1.00,1.00,1.00,0.84,0.84,1.00,1.00,0.84,1.00,0.84 learn seo;8;8;0;1900;7.76;http://www.seobook.com/learn-seo/;0.30;0.40;0.47;396000000;0.67,0.79,0.79,0.79,0.79,0.79,1.00,0.79,0.79,0.67,0.79,0.67 aaron seo;1;1;0;70;0.00;http://www.seobook.com/;0.29;0.00;0.03;16300000;0.22,0.56,0.11,0.44,0.11,0.11,0.11,0.33,0.11,1.00,0.78,0.22 seo book keyword suggestion tool free download;1;1;0;70;0.00;http://tools.seobook.com/;0.29;0.00;0.14;775000;0.29,1.00,0.00,0.43,0.00,0.00,0.14,0.00,0.14,0.00,0.00,0.43
Цена: 20 API юниты за строку Цена за исторические данные: 100 API юниты за строку

This report lists keywords that bring users to a domain via Google paid search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_adwordsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ph, Po, Pp, Pd, Ab, Nq, Cp, Tg, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur, Ts, Un список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_positions new, lost, rise или fall new - показать ключевые слова, появившиеся в текущем месяце
lost - показать ключевые слова, исчезнувшие в текущем месяце
rise - показать ключевые слова, улучшившие свои позиции в текущем месяце
fall - показать ключевые слова, ухудшившие свои позиции в текущем месяце
display_filter Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Un фильтр для столбцов
* обязательные поля

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

https://api.semrush.com/?type=domain_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Vu,Tr,Tc,Co,Nr,Td&domain=ebay.com&display_sort=po_asc&database=us

Пример ответа

Keyword;Position;Previous Position;Position Difference;Search Volume;CPC;Visible Url;Traffic (%);Traffic Cost;Competition;Number of Results;Trends g tube pads amazon;1;1;0;30;0.36;www.ebay.com/;0.00;0;0.88;3130000;0.14,0.14,0.43,0.14,0.71,0.14,0.57,0.14,1.00,0.14,0.14,0.14 13.8 v power supply;1;1;0;140;1.24;www.ebay.com/;0.00;8;1.00;9750000;0.82,0.82,0.52,1.00,0.82,0.65,0.65,0.65,0.82,0.82,0.82,1.00 ruger 22 250 magazine;1;1;0;10;0.02;www.ebay.com/22+250+magazine;0.00;0;0.64;1370000;1.00,0.60,0.80,0.40,0.20,0.20,0.20,0.20,0.20,0.20,0.20,0.40 nike roshe run woven rainbow buy online;1;1;0;50;0.00;www.ebay.com/;0.00;0;0.00;34;0.00,0.00,0.00,0.00,0.00,0.00,0.00,1.00,0.00,0.00,0.00,0.00 wildside under the influence vinyl;1;1;0;30;0.00;;0.00;0;0.00;83;0.11,0.11,1.00,0.11,0.33,0.22,0.00,0.11,0.00,0.11,0.11,0.11 rca 45 record player;1;1;0;10;0.20;www.ebay.com/;0.00;0;1.00;1170000;0.03,0.13,0.03,0.08,0.03,0.03,0.03,0.08,0.03,0.18,0.18,1.00 uber store;1;1;0;720;2.43;www.ebay.com/Uber+store;0.00;82;0.52;149000000;0.67,0.82,0.55,0.67,0.67,0.67,0.82,1.00,0.82,0.82,0.82,0.82 mouse maze for sale;1;1;0;40;0.16;;0.00;0;1.00;7410000;1.00,0.50,0.50,1.00,0.50,0.50,0.50,1.00,0.50,0.50,0.50,1.00 air britain;1;1;0;140;0.64;www.ebay.com/;0.00;4;0.08;64200000;1.00,1.00,1.00,1.00,0.82,0.82,0.82,1.00,0.82,0.82,0.82,0.53 esoterica stonehaven;1;1;0;140;0.02;;0.00;0;0.08;67;0.81,0.81,0.35,0.65,0.42,0.27,0.27,0.35,0.54,0.54,1.00,0.54
domain_adwords_unique
Цена: 40 API юниты за строку

This report shows unique ad copies SEMrush noticed when the domain ranked in Google paid search results for keywords from our databases.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_adwords_uniqueтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Ph, Po, Pp, Cp, Tg, Tr, Co, Td, Un, Tt, Ds, Vu, Ur, Pc, Ts список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort pc_asc, pc_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Tt, Ds, Vu фильтр для столбцов

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

https://api.semrush.com/?type=domain_adwords_unique&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=3&export_columns=Tt,Ds,Vu,Ur,Pc&domain=ebay.com&database=us

Пример ответа

Title;Description;Visible Url;Url;Number of Keywords Authentic Designer Goods - Clothing Shoes and Accessories;Prada Gucci Burberry Lanvin Chanel ;www.ebay.com/usr/luxeloveshop;http://www.ebay.com/usr/luxeloveshop&ved=0CHYQ0Qw;633 Boat For Sale on eBay;Huge selection of Boat For Sale.Free Shipping available. Buy Now!;www.ebay.com/;http://rover.ebay.com/rover/1/711-42618-2056-0/2%3Fmpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fsch%252Fi.html%253F_nkw%253Dboat%252520for%252520sale%26keyword%3Dboat%2Bfor%2Bsale%26crlp%3D35687221484_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s4%26device%3Dc&ved=0CIABENEM;361 Personalize Phone Cases - ebay.com;iPhone, iPod, HTC, Samsung, Sony, LG. Prices as low as $9.98.;www.stores.ebay.com/FSC25;http://www.stores.ebay.com/FSC25&ved=0CBMQ0Qw;273
domain_organic_organic
Цена: 40 API юниты за строку Цена за исторические данные: 200 API юниты за строку

This report lists a domain’s competitors in organic search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_organic_organicтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Dn, Cr, Np, Or, Ot, Oc, Ad список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort np_desc, np_asc, cr_desc, cr_asc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
* обязательные поля

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

https://api.semrush.com/?type=domain_organic_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&domain=seobook.com&database=us

Пример ответа

Domain;Competitor Relevance;Common Keywords;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords seochat.com;0.13;338;11021;5640;9690;0 seocentro.com;0.12;237;2196;8091;43478;0 internetmarketingninjas.com;0.12;323;15751;16182;30168;20 webconfs.com;0.12;265;6689;4291;14093;0 link-assistant.com;0.12;326;18255;13089;51583;26 wordtracker.com;0.12;289;7685;11254;51352;1 keywordtool.io;0.11;337;19247;103615;145337;1 kwfinder.com;0.10;259;4885;8260;33067;2 seoreviewtools.com;0.10;240;4537;7181;32502;0 smallseotools.com;0.10;469;21126;299488;450094;10
domain_adwords_adwords
Цена: 40 API юниты за строку Цена за исторические данные: 200 API юниты за строку

This report lists a domain’s competitors in paid search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_adwords_adwordsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Dn, Cr, Np, Ad, At, Ac, Or список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort np_desc, np_asc, cr_desc, cr_asc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
* обязательные поля

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

https://api.semrush.com/?type=domain_adwords_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Cr,Np,Ad,At,Ac,Or&domain=ebay.com&database=us

Пример ответа

Domain;Competitor Relevance;Common Keywords;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords bestdeals.today;0.07;192427;4180961;231702687;219085005;98743 amazon.com;0.07;337566;7674897;606923091;363744884;76392627 discount99.us;0.04;21583;82580;486315;307513;0 netdeals.com;0.03;27343;740384;38400483;28864800;6 walmart.com;0.03;21533;558633;146423426;31455771;19967088 blackfridaydeals2016.co;0.02;23660;1091009;75093364;65877087;0 informationvine.com;0.02;25758;1377703;86672506;90105545;0 target.com;0.02;21805;1037283;52256534;51634896;9181821 savesmart.com;0.02;11659;151845;5477272;5183214;8 shop411.com;0.02;29103;1896105;84369570;98212347;0
domain_adwords_historical
Цена: 100 API юниты за строку

This report shows keywords a domain has bid on in the last 12 months and its positions in paid search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_adwords_historicalтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Ph, Dt, Po, Cp, Nq, Tr, Ur, Tt, Ds, Vu, Cv список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort cv_asc, cv_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Nq, Cp, Tr фильтр для столбцов

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

https://api.semrush.com/?type=domain_adwords_historical&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=1&export_columns=Ph,Dt,Po,Cp,Nq,Tr,Ur,Tt,Ds,Vu&domain=amazon.com&database=us

Пример ответа

Keyword;Date;Position;CPC;Search Volume;Traffic (%);Url;Title;Description;Visible Url amazon;20181215;1;0.02;83100000;3905700;https://www.amazon.com/;Amazon.com Official Site | Free 2-Day Shipping with Prime Ad www.amazon.com/;Earth's biggest selection of books, electronics, apparel & more at low prices. Fast Shipping. Try Prime for Free. Save with Our Low Prices. Explore Amazon Devices. Read Ratings & Reviews. Shop Our Huge Selection. Shop Best Sellers & Deals.; amazon;20181115;1;0.02;83100000;3905700;https://www.amazon.com/;Amazon.com® Official Site | Huge Selection & Great Prices Ad www.amazon.com/;Free Two-Day Shipping with Prime. Read Ratings & Reviews. Explore Amazon Devices. Fast Shipping.; amazon;20181015;1;0.02;83100000;3905700;http://www.amazon.com/;Amazon.com Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Read Ratings & Reviews. Try Prime for Free. Explore Amazon Devices. Shop Best Sellers & Deals. Save with Our Low Prices. Shop Our Huge Selection. Fast Shipping.;www.amazon.com/ amazon;20180915;1;0.02;83100000;3905700;http://www.amazon.com/;Amazon.com Official Site | Free 2-Day Shipping with Prime;Earth's biggest selection of books, electronics, apparel & more at low prices.;www.amazon.com/ amazon;20180815;1;0.02;83100000;3905700;http://www.amazon.com/;Amazon.com | Amazon® Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Explore Amazon Devices. Shop Our Huge Selection. Read Ratings & Reviews. Try Prime for Free. Fast Shipping. Save with Our Low Prices.;www.amazon.com/ amazon;20180715;1;0.02;83100000;3905700;http://www.amazon.com/;amazon - Official Site | Huge Selection at amazon.com;Discounted Contemporary Furniture at amazon .com;www.amazon.com/ amazon;20180615;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music amazon;20180515;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music amazon;20180415;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music amazon;20180315;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music amazon;20180215;1;0.02;83100000;3905700;http://www.amazon.com/;;Free Two-Day Shipping with Prime.;www.amazon.com/ amazon;20180115;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music
domain_domains
Цена: 80 API юниты за строку Цена за исторические данные: 400 API юниты за строку

This report allows users to compare up to five domains by common keywords, unique keywords, all keywords, or search terms that are unique to the first domain.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_domainsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domains*stringдомены для сравнения в указанном формате, разделенные знаком "|", зашифрованные с помощью urlencode. Домен состоит из <sign>|<type>|<domain>, где
<sign> - тип операции: "+", "-", "*", "/"
<type> - "or" для ключевых слов или "ad" для ключевых слов из AdWords
<domain> - домен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ph, P0, P1, P2, P3, P4, Nr, Cp, Nq, Kd, Co, Td список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort p0_asc, p0_desc, p1_asc, p1_desc, p2_asc, p2_desc, p3_asc, p3_desc, p4_asc, p4_desc, nq_asc, nq_desc, co_asc, co_desc, cp_asc, cp_desc, nr_asc, nr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, P0, P1, P2, P3, P4, Nq, Cp, Co, Nr фильтр для столбцов
* обязательные поля

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

https://api.semrush.com/?type=domain_domains&database=us&display_limit=10&domains=*|or|ebay.com|*|or|imdb.com|*|or|youtube.com&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Пример ответа

Keyword;ebay.com;imdb.com;youtube.com;Domain4 Pos;Domain5 Pos;Number of Results;CPC;Search Volume;Keyword Difficulty;Competition;Trends straight talk;44;11;12;0;0;1290000000;0.37;1500000;88.28;0.21;1.00,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82 patagonia;39;47;22;0;0;338000000;0.94;1220000;85.11;0.98;1.00,0.54,0.45,0.45,0.30,0.30,0.30,0.30,0.45,0.45,0.67,1.00 gomovies;72;18;9;0;0;23700000;0.37;1000000;60.57;0.01;0.00,0.00,0.00,0.03,0.45,0.67,0.67,1.00,0.82,0.82,0.82,0.82 hoverboard;84;93;10;0;0;48300000;1.21;823000;76.60;1.00;1.00,0.45,0.30,0.30,0.25,0.25,0.30,0.30,0.30,0.25,0.25,0.67 jack in the box;63;86;15;0;0;1320000000;0.33;823000;86.19;0.08;1.00,1.00,0.82,0.82,1.00,0.82,0.82,1.00,1.00,0.82,1.00,0.82 lego;42;20;4;0;0;750000000;0.36;673000;88.30;0.72;1.00,0.67,0.67,0.55,0.55,0.55,0.55,0.55,0.55,0.55,0.55,0.82 people magazine;72;22;29;0;0;4170000000;3.60;673000;81.22;0.14;1.00,1.00,0.82,1.00,0.82,1.00,1.00,1.00,1.00,1.00,1.00,1.00 shopkins;22;40;3;0;0;34100000;0.72;550000;71.33;0.85;1.00,0.55,0.45,0.45,0.37,0.30,0.30,0.30,0.30,0.25,0.25,0.30 alexis texas;78;19;51;0;0;95;0.53;450000;80.19;0.00;1.00,1.00,0.82,0.82,0.82,1.00,0.82,0.82,0.82,0.82,0.82,0.82 james avery;60;10;24;0;0;88400000;0.11;450000;82.75;0.26;1.00,0.37,0.37,0.37,0.45,0.55,0.30,0.30,0.30,0.30,0.37,0.55
domain_shopping
Цена: 30 API юниты за строку Цена за исторические данные: 150 API юниты за строку

This report lists keywords that trigger a domain’s product listing ads to appear in Google's paid search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_shoppingтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Ph,Po,Pp,Pd,Nq,Sn,Ur,Tt,Pr,Ts список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort po_asc, po_desc, nq_asc, nq_desc, pr_asc, pr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph,Po,Nq,Ur,Tt,Pr фильтр для столбцов

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

https://api.semrush.com/?type=domain_shopping&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&database=us&display_limit=3&display_sort=nq_desc&export_columns=Ph,Po,Pp,Pd,Nq,Sn,Ur,Tt,Pr,Ts

Пример ответа

Keyword;Position;Previous Position;Position Difference;Search Volume;Shop Name;Url;Title;Product Price;Timestamp apple watch;5;0;-5;1830000;eBay;http://www.ebay.com/i/123473122981;Apple Watch Series 2 - 38MM - Aluminum Case - White Sport Band - Smartwatch;169.99;1548155351 playstation;5;0;-5;673000;eBay;http://www.ebay.com/i/113408567972;877 Fully Tested Ps Vita PCH-1100 AB01 Crystal Black Console System Fw 3.68;95.94;1548148745 playstation;7;0;-7;673000;eBay;http://www.ebay.com/i/113493854733;Sony PlayStation 2 PS2 Fat Console Controller W/ Cords - Boots Up Refurbished;34.07;1548148745
domain_shopping_unique
Цена: 60 API юниты за строку Цена за исторические данные: 300 API юниты за строку

This report shows product listing ad copies SEMrush noticed when the domain ranked in Google's paid search results for keywords from our databases.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_shopping_uniqueтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Tt,Pr,Ur,Pc,Un,Ts список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort pr_asc, pr_desc, pc_asc, pc_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Tt,Pr фильтр для столбцов

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

https://api.semrush.com/?type=domain_shopping_unique&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&database=us&display_limit=3&export_columns=Tt,Pr,Ur,Pc

Пример ответа

Title;Product Price;Url;Number of Keywords Windows 7 Professional 32/64 Bit Activation Key;6.1;http://www.ebay.com/i/323416369252;390 Microsoft Windows 7 Ultimate 32/64 Bit SP1&2 Download Link & MS Activation Key;4.99;http://www.ebay.com/i/202550754305;245 1080P DIY Spy Hidden Nanny Micro Pinhole Built-in Battery HD Camera DVR Recorder;32;http://www.ebay.com/i/192495737640;236
domain_shopping_shopping
Цена: 60 API юниты за строку Цена за исторические данные: 300 API юниты за строку

This report lists domains a queried domain is competing against in Google's paid search results with product listing ads.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_shopping_shoppingтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Dn,Cr,Np,Sh,Ad,At,Ac,Or список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort np_asc, np_desc, cr_asc, cr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.

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

https://api.semrush.com/?type=domain_shopping_shopping&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&database=us&display_limit=10&display_sort=np_desc&export_columns=Dn,Cr,Np,Ad,At,Ac,Or

Пример ответа

Domain;Competitor Relevance;Common Keywords;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords walmart.com;0.17;316712;555313;145469121;30624447;19966933 amazon.com;0.13;488457;7126039;568143801;329123277;76322373 etsy.com;0.08;117812;38328;22363968;3015402;9654230 newegg.com;0.05;61108;11250;6273638;2207224;2190128 jet.com;0.05;60721;9777;151975;161632;634721 target.com;0.05;62272;1037704;51821814;51369601;9143593 homedepot.com;0.04;67022;492858;103685779;56643236;7106954 zoro.com;0.04;60008;56711;1996755;1891827;304263 poshmark.com;0.04;52296;10435;5570134;1155108;2321101 bestbuy.com;0.04;45126;96379;54662964;20450677;5160927
domain_organic_unique
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report shows unique pages of the analyzed domain ranking in Google's top 100 results organic search results

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_organic_uniqueтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ur, Pc, Tg, Tr список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort Pc, Tg, Tr This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ur, Pc, Tg, Tr фильтр для столбцов
* обязательные поля

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

https://api.semrush.com/?type=domain_organic_unique&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CPc%7CGt%7C100&display_limit=10&export_columns=Ur,Pc,Tg,Tr&domain=seobook.com&display_sort=tr_desc&database=us

Пример ответа

Url;Number of Keywords;Traffic;Traffic (%) http://www.seobook.com/;317;2488;15.14 http://tools.seobook.com/meta-medic/;492;1289;7.84 http://tools.seobook.com/robots-txt/generator/;197;1133;6.89 http://tools.seobook.com/;588;1015;6.17 http://tools.seobook.com/ppc-tools/free-ppc-ad-coupons.html;930;916;5.57 http://tools.seobook.com/general/keyword-density/;417;794;4.83 http://tools.seobook.com/keyword-tools/seobook/;262;729;4.43 http://tools.seobook.com/server-header-checker/;322;722;4.39 http://tools.seobook.com/robots-txt/;319;583;3.54 http://tools.seobook.com/keyword-list/generator.php;103;469;2.85
domain_organic_subdomains
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report shows subdomains of the analyzed domain ranking in Google's top 100 organic search results

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*domain_organic_subdomainsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
domain*example.comдомен
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ur, Pc, Tg, Tr список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
* обязательные поля

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

https://api.semrush.com/?type=domain_organic_subdomains&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ur,Pc,Tg,Tr&domain=apple.com&database=us

Пример ответа

Url;Number of Keywords;Traffic;Traffic (%) itunes.apple.com;12576097;80811145;53.47 www.apple.com;1461853;43132944;28.54 support.apple.com;1255701;21914725;14.50 discussions.apple.com;1042589;2163623;1.43 trailers.apple.com;67190;799797;0.53 developer.apple.com;125007;713958;0.47 secure.store.apple.com;3036;482174;0.32 checkcoverage.apple.com;4368;210723;0.14 beta.apple.com;1113;205472;0.14 appleid.apple.com;351;139299;0.09
Отчеты по ключевому слову
Цена: 10 API юниты за строку

This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in all regional databases.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_allтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phraseключевое слово
database database база, к которой производится запрос (одно значение из списка); если параметр не указан, будут отправлены данные для всех имеющихся баз данных
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Db, Ph, Nq, Cp, Co список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию

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

https://api.semrush.com/?type=phrase_all&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Db,Ph,Nq,Cp,Co&phrase=What+is+SEO&database=us

Пример ответа

Database;Phrase;Search Volume;CPC;Competition
us;what is seo;14800;4.70;0.07
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in a chosen regional database.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_thisтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phraseключевое слово
database* database база, к которой производится запрос (одно значение из списка)
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ph, Nq, Cp, Co, Nr список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
* обязательные поля

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

https://api.semrush.com/?type=phrase_this&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Ph,Nq,Cp,Co,Nr&phrase=What+is+SEO&database=us

Пример ответа

Keyword;Search Volume;CPC;Competition;Number of Results
what is seo;14800;4.70;0.07;577000000
phrase_organic
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report lists domains that are ranking in Google top 20 organic search results with a requested keyword.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_organicтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phraseключевое слово
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Dn, Ur список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
* обязательные поля

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

https://api.semrush.com/?type=phrase_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Ur&phrase=seo&database=us

Пример ответа

Domain;Url wikipedia.org;http://en.wikipedia.org/wiki/Search_engine_optimization searchengineland.com;http://searchengineland.com/guide/what-is-seo moz.com;http://moz.com/beginners-guide-to-seo google.com;https://support.google.com/webmasters/answer/35291%3Fhl%3Den majesticseo.com;http://www.majesticseo.com/ wspider.com;http://wspider.com/ baytechwebdesign.com;http://www.baytechwebdesign.com/services/online-marketing/seo-san-jose/ yelp.com;http://www.yelp.com/search%3Ffind_desc%3DSeo%2BCompany%26find_loc%3DSan%2BJose%252C%2BCA sanjoseseoservices.com;http://sanjoseseoservices.com/ starkmarketing.com;http://www.starkmarketing.com/
phrase_adwords
Цена: 20 API юниты за строку Цена за исторические данные: 100 API юниты за строку

This report lists domains that are ranking in Google paid search results with a requested keyword.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_adwordsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phraseключевое слово
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Dn, Ur список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
* обязательные поля

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

https://api.semrush.com/?type=phrase_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Ur&phrase=seo&database=us

Пример ответа

Domain;Url seop.com;http://www.seop.com&ved=0CBMQ0Qw digitalsherpa.com;http://content.digitalsherpa.com/ultimate-seo-checklist-for-small-business-websites-free-ebook%3Futm_campaign%3DUltimate%2520SEO%2520Checklist%2520for%2520SMBs%26utm_medium%3Dgoogle%26utm_source%3Dppc%26mkwid%3DsFfCoTwav_dc%26pcrid%3D47184889391%26pkw%3Dseo%26pmt%3De%26utm_term%3Dseo&ved=0CBkQ0Qw rankpay.com;http://www.rankpay.com/r/adwords&ved=0CB8Q0Qw mdz.ca;http://www.mdz.ca&ved=0CJkBENEM scorpiondesign.com;http://www.scorpiondesign.com/What-We-Do/Search-Engine-Optimization.aspx%3FSPPC%3DGoogle%26sppcadid%3D132382%26keyword%3D%252Bseo%2520company%26matchtype%3Db%26adposition%3D1s2%26random%3D9845616637911377530%26network%3Dsearch%26device%3Dc%26networkType%3Dg&ved=0CJsBENEM moz.com;http://moz.com%3Futm_source%3Dgoogle%26utm_medium%3Dcpc%26utm_term%3Dseo%26utm_campaign%3DFree&ved=0CJ0BENEM gstatemarketing.com;http://www.gstatemarketing.com&ved=0CJ8BENEM siliconbeachdigital.com;https://www.SiliconBeachDigital.com/%3Fsec%3Dgoogft&ved=0CKEBENEM wildnettechnologies.com;http://seo.wildnettechnologies.com/seo-services%3Futm_source%3DPay%2520per%2520Click%2520Ads%26utm_medium%3DGoogle%2520Adwords%26utm_campaign%3DSEO%2520Services&ved=0CKMBENEM icrossing.com;http://m1024.ic-live.com/228/%3F151516816%26OVMTC%3DBroad%26site%3D%26creative%3D33350689017%26OVKEY%3Dseo%2520firm%26url_id%3D151516816%26adpos%3D1s7%26device%3Dc%26devicemodel%3D&ved=0CKUBENEM
phrase_related
Цена: 40 API юниты за строку Цена за исторические данные: 200 API юниты за строку

This report provides an extended list of related keywords, synonyms, and variations relevant to a queried term in a chosen database.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_relatedтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phraseключевое слово
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ph, Nq, Cp, Co, Nr, Td список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Nq, Cp, Co, Nr фильтр для столбцов
* обязательные поля

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

https://api.semrush.com/?type=phrase_related&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Nq,Cp,Co,Nr,Td&phrase=What+is+SEO&database=us

Пример ответа

Keyword;Search Volume;CPC;Competition;Number of Results;Trends
who is seo;10;0.00;0.10;427000000;0.20,0.20,0.40,0.20,0.20,1.00,0.20,0.20,0.20,0.20,0.20,0.20
what is seo optimisation;30;0.00;0.00;19400000;0.00,0.50,0.00,0.00,0.00,0.50,0.50,1.00,0.50,0.50,0.50,1.00
seo what is it;10;0.00;0.10;520000000;0.09,0.03,0.03,0.06,0.03,0.03,0.03,1.00,0.03,0.03,0.03,0.06
whats seo;720;6.01;0.12;31600000;0.82,1.00,1.00,1.00,1.00,1.00,1.00,1.00,1.00,0.82,1.00,1.00
whats a seo;10;0.00;0.12;36700000;1.00,0.33,0.33,0.67,0.33,0.33,0.33,0.67,0.33,0.33,0.33,0.67
what is seo marketing;1600;9.09;0.36;465000000;0.42,0.67,0.67,0.67,0.54,0.67,0.67,0.67,0.67,0.79,1.00,0.79
what is search engine optimization;1300;6.36;0.14;172000000;0.81,0.81,0.81,1.00,0.81,0.81,0.81,0.62,0.62,0.81,1.00,0.81
what does search engine optimization mean;10;0.00;0.14;54700000;0.14,0.14,0.43,0.14,0.71,0.14,0.57,0.14,1.00,0.14,0.14,0.14
define seo marketing;10;7.54;0.22;17700000;1.00,0.25,0.25,0.50,0.25,0.25,0.25,0.50,0.25,0.25,0.25,0.50
seo search;480;5.97;0.25;514000000;0.81,1.00,0.81,1.00,0.81,0.81,0.81,0.81,1.00,0.81,1.00,0.81
phrase_adwords_historical
Цена: 100 API юниты за строку

This report shows domains that have bid on a requested keyword in the last 12 months and their positions in paid search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_adwords_historicalтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phraseключевое слово
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Dn, Dt, Po, Ur, Tt, Ds, Vu, At, Ac, Ad список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию

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

https://api.semrush.com/?type=phrase_adwords_historical&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=1&export_columns=Dn,Dt,Po,Ur,Tt,Ds,Vu&phrase=movie&database=us

Пример ответа

Domain;Date;Position;Url;Title;Description;Visible Url blendedmovie.com;20140515;1;47.xg4ken.com/media/redir.php%3Fprof%3D626%26camp%3D58398%26affcode%3Dkw599%26cid%3D36205335494%26networkType%3Dsearch%26kdv%3Dc%26url%5B%5D%3Dhttp%253A%252F%252Fblendedmovie.com%252F%2523home&ved=0CBoQ0Qw;Blended Movie - blendedmovie.com;A wildly different family vacation. Out 5/23. Buy Tickets Today!;www.blendedmovie.com/ blendedmovie.com;20140415;;;;; blendedmovie.com;20140315;;;;; blendedmovie.com;20140215;;;;; blendedmovie.com;20140115;;;;; blendedmovie.com;20131215;;;;; blendedmovie.com;20131115;;;;; blendedmovie.com;20131015;;;;; blendedmovie.com;20130915;;;;; blendedmovie.com;20130815;;;;; blendedmovie.com;20130715;;;;; blendedmovie.com;20130615;;;;;
phrase_fullsearch
Цена: 20 API юниты за строку

The report offers a list of phrase matches and alternate search queries, including particular keywords or keyword expressions.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_fullsearchтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phraseключевое слово
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns Ph, Nq, Cp, Co, Nr, Td список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Nq, Cp, Co, Nr фильтр для столбцов

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

https://api.semrush.com/?type=phrase_fullsearch&phrase=buy+ticket+online&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Nq,Cp,Co,Nr,Td&database=us

Пример ответа

Keyword;Search Volume;CPC;Competition;Number of Results;Trends buy tickets online;2900;2.38;0.92;679000000;0.99,0.99,0.99,0.83,0.99,0.99,0.99,0.99,0.99,0.83,0.83,0.83 buy movie tickets online;2400;1.96;0.35;290000000;0.35,0.24,0.30,0.24,0.99,0.54,0.44,0.30,0.24,0.30,0.81,0.81 buy lottery tickets online;1300;0.90;0.30;3170000;0.24,0.24,0.36,0.28,0.81,0.28,0.24,0.44,0.36,0.24,0.24,0.99 buy concert tickets online;590;1.28;0.96;24700000;0.55,0.99,0.67,0.67,0.67,0.82,0.82,0.67,0.55,0.55,0.55,0.55 buy powerball tickets online;590;0.00;0.19;204000;0.06,0.11,0.38,0.09,0.99,0.11,0.14,0.99,0.21,0.06,0.06,0.06 can you buy lottery tickets online;480;0.56;0.17;2270000;0.20,0.20,0.30,0.16,0.68,0.20,0.25,0.45,0.37,0.13,0.13,0.99 buy six flags tickets online;390;0.95;0.56;198000;0.24,0.16,0.67,0.55,0.44,0.99,0.67,0.55,0.16,0.44,0.10,0.08 buying movie tickets online;390;1.87;0.45;43900000;0.44,0.28,0.36,0.28,0.82,0.54,0.54,0.44,0.28,0.28,0.99,0.99 can you buy powerball tickets online;390;0.00;0.03;136000;0.05,0.05,0.17,0.06,0.99,0.06,0.07,0.46,0.25,0.07,0.05,0.09 buy greyhound tickets online;320;0.14;0.67;124000;0.05,0.04,0.08,0.07,0.04,0.08,0.13,0.08,0.07,0.30,0.68,0.99
phrase_kdi
Цена: 50 API юниты за строку

This report provides keyword difficulty, an index that helps to estimate how difficult it would be to seize competitors' positions in organic search within the Google top 20 with an indicated search term.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*phrase_kdiтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
phrase*phrasePhrase (from 1 to 100 keywords separated by semicolons)
database* database база, к которой производится запрос (одно значение из списка)
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_columns Ph, Kd список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию

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

https://api.semrush.com/?type=phrase_kdi&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Ph,Kd&phrase=ebay;seo&database=us

Пример ответа

Keyword;Keyword Difficulty Index ebay;95.10 seo;78.35
Отчеты по URL
Цена: 10 API юниты за строку Цена за исторические данные: 50 API юниты за строку

This report lists keywords that bring users to a URL via Google top 20 organic search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*url_organicтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
url*http://example.com/The URL of a landing page you'd like to investigate.
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ph, Po, Pp, Nq, Cp, Co, Kd, Tr, Tg, Tc, Nr, Td, Fl, Ts список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Fl фильтр для столбцов
* обязательные поля

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

https://api.semrush.com/?type=url_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td&url=http://tools.seobook.com/&database=us

Пример ответа

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost;Number of Results;Trends seo tools;4;8100;10.54;0.54;3.21;5976;226000000;0.67,0.82,0.82,1.00,0.82,0.82,0.67,0.67,0.67,0.67,0.82,0.82 free seo tools;6;1600;7.18;0.60;0.45;574;209000000;0.68,0.84,1.00,1.00,1.00,0.84,0.84,1.00,1.00,0.84,1.00,0.84 seo book keyword suggestion tool free download;1;70;0.00;0.14;0.31;0;775000;0.29,1.00,0.00,0.43,0.00,0.00,0.14,0.00,0.14,0.00,0.00,0.43 seo tools search engine software;2;210;0.00;0.02;0.15;0;37600000;0.54,1.00,1.00,0.81,0.65,0.81,1.00,0.81,0.81,0.81,0.54,0.35 tools seobook;1;30;16.96;0.29;0.13;407;162000;0.27,0.08,0.04,0.04,0.04,0.04,0.04,0.04,0.54,1.00,1.00,0.04 seo tools software;7;480;5.66;0.11;0.10;108;152000000;0.54,0.81,0.81,0.81,0.81,1.00,1.00,1.00,0.66,0.81,1.00,0.54 free seo;7;480;4.09;0.54;0.10;78;727000000;0.81,1.00,0.81,1.00,1.00,0.66,0.81,0.81,0.81,0.81,1.00,1.00 search engine optimization tools;4;260;9.58;0.45;0.10;174;80600000;1.00,0.81,0.66,0.81,0.66,0.66,0.81,0.81,0.81,0.66,1.00,1.00 seo optimization tools;4;210;8.21;0.33;0.07;120;56300000;0.81,1.00,0.81,0.81,0.81,0.81,0.65,0.81,0.65,0.65,0.81,1.00 seo optimization software;6;210;21.58;0.13;0.05;226;59100000;0.54,0.81,0.54,0.54,0.81,0.81,0.81,0.54,0.65,0.81,1.00,1.00
Цена: 20 API юниты за строку Цена за исторические данные: 100 API юниты за строку

This report lists keywords that bring users to a URL via Google paid search results.

Запрашиваемый URL

https://api.semrush.com/

Параметры запроса

НазваниеЗначениеОписание
type*url_adwordsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
url*http://example.com/The URL of a landing page you'd like to investigate.
database* database база, к которой производится запрос (одно значение из списка)
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1если установлена "1", значения столбцов будут экранированы в двойные кавычки.
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
display_date дата в формате "YYYYMM15" позволяет запросить отчеты с историческими данными
export_columns Ph, Po, Nq, Cp, Co, Tg, Tr, Tc, Nr, Td, Tt, Ds, Ts список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd фильтр для столбцов
* обязательные поля

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

https://api.semrush.com/?type=url_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=5&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td,Tt,Ds&url=http://www.amazon.com/&database=us

Пример ответа

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost;Number of Results;Trends;Title;Description amazon;1;83100000;0.02;0.16;0.68;78114;81;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon.com Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Read Ratings & Reviews. Try Prime for Free. Explore Amazon Devices. Shop Best Sellers & Deals. Save with Our Low Prices. Shop Our Huge Selection. Fast Shipping. amazon;1;83100000;0.02;0.16;0.68;78114;75;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon.com Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Shop Our Huge Selection. Try Prime for Free. amazon;1;83100000;0.02;0.16;0.68;78114;2680000000;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon.com | Amazon® Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Explore Amazon Devices. Shop Our Huge Selection. Read Ratings & Reviews. Try Prime for Free. Fast Shipping. Save with Our Low Prices. amazon;1;83100000;0.02;0.16;0.68;78114;84;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon® Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Shop Our Huge Selection. Fast Shipping. Read Ratings & Reviews. Shop Best Sellers & Deals. Stream Videos Instantly. Save with Our Low Prices. amazon;1;83100000;0.02;0.16;0.68;78114;76;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon.com Official Site | Free 2-Day Shipping with Prime;Earth's biggest selection of books, electronics, apparel & more at low prices.
Display Advertising Reports NEW
 
publisher_text_ads
Цена: 50 API юниты за строку

This report lists display ads that have appeared on a publisher’s website.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*publisher_text_adsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
domain*example.comдомен
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns title, text, first_seen, last_seen, times_seen, visible_url список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all
display_filter ad, title, text, url фильтр для столбцов

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=urbandictionary.com&type=publisher_text_ads

Пример ответа

title;text;first_seen;last_seen;times_seen;visible_url Diabetes II Insulin;Get Complete Info on Diabetes Medication And Treatments.;1467072000000;1471478400000;985369;everydayhealth.com/Insulin FICA;Federally Insured Cash Account Official Site of the FICA Account;1460073600000;1468627200000;693521;ficaaccount.com 米国暮らしでも映画は無理;アメリカに住んでるだけじゃ映画の 英語は聞き取れません。なぜ?;1461801600000;1468627200000;664230;mogomogobuster.com Free Downloadable Videos;Download The Most Viewed End Time Bible Prophecy Videos Online Today!;1459900800000;1467936000000;528229;worldslastchance.com Learn English Online Free »;How to learn english fast and easy? Learn english grammar online free!;1459900800000;1462406400000;463272;learn-english-online.us Type 2 Diabetes Recipes;Sign Up for Weight Loss Tips & More Try our Customized Meal Planner Now;1466985600000;1468022400000;432721;everydayhealth.com/Type-2-Diabetes Download a Book Free »;Download Allatra - worth reading Most extraordinary book of century;1466467200000;1468540800000;432453;allatra-book.org/Download_Free Insulin Dependent;Learn About the Causes, Symptoms And Treatment of Type 2 Diabetes.;1467072000000;1468627200000;409819;everydayhealth.com/Insulin Parmesan Meatball Sliders;Get Cooking With Hunt's - Make This Delicious Baked Dish Tonight!;1459900800000;1468281600000;363474;hunts.com BANKSY MINI WALL MURAL;Banksy Mural on Concrete Texture 12x12x3, for Wall or Table Top;1466121600000;1468627200000;314699;designproject.net
 
publisher_advertisers
Цена: 50 API юниты за строку

This report lists advertisers whose display ads have appeared on a queried publisher’s website.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*publisher_advertisersтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
domain*example.comдомен
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns domain, ads_count, first_seen, last_seen, times_seen список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all
display_filter url фильтр для столбцов

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=urbandictionary.com&type=publisher_advertisers

Пример ответа

domain;ads_count;first_seen;last_seen;times_seen stylewe.com;3243;1459900800000;1471046400000;13912898 arabmatchmaking.com;13788;1459900800000;1468627200000;10674727 facebook.com;145903;1369440000000;1468627200000;9581288 truthfinder.com;136;1461801600000;1468627200000;4455000 everydayhealth.com;699;1459900800000;1471478400000;2932806 instantcheckmate.com;49;1396137600000;1468627200000;2790630 bestbackground-1191.appspot.com;125;1459987200000;1468540800000;2479866 muslims4marriage.com;53663;1459900800000;1468627200000;1473834 mogomogobuster.com;20;1461801600000;1468627200000;1240533 newlife24h.com;6;1461456000000;1468540800000;1121633
 
advertiser_publishers
Цена: 100 API юниты за строку

This report lists publisher’s websites where an advertiser’s display ads have appeared.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*advertiser_publishersтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
domain*example.comдомен
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns domain, ads_count, first_seen, last_seen, times_seen список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all
display_filter url фильтр для столбцов

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=wayfair.com&type=advertiser_publishers

Пример ответа

domain;ads_count;first_seen;last_seen;times_seen thisnext.com;10837;1388880000000;1471910400000;888747 antiquesnavigator.com;7410;1439424000000;1471910400000;518508 antiques.com;7945;1459900800000;1471910400000;364953 cotedetexas.blogspot.com;10980;1401235200000;1471910400000;212340 toynewsi.com;1449;1459900800000;1471910400000;176293 epicsports.com;3762;1461628800000;1471910400000;168701 lampsusa.com;1174;1459900800000;1465862400000;149453 blueridgenow.com;5130;1459900800000;1471910400000;137279 christmas.com;5293;1459900800000;1471824000000;122658 aquasupercenter.com;5045;1459900800000;1471910400000;121911
 
advertiser_text_ads
Цена: 100 API юниты за строку

This report lists display ads of a queried advertiser’s website.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*advertiser_text_adsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
domain*example.comдомен
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns title, text, first_seen, last_seen, times_seen, visible_url список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all
display_filter ad, title, text, url фильтр для столбцов

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&type=advertiser_text_ads

Пример ответа

title;text;first_seen;last_seen;times_seen;visible_url Dakota Digital Products »;Free shipping on U.S. orders $150+ Digital Dash/Gauges, Cruise Control;1461801600000;1471910400000;76233;stores.ebay.com/Phoenix-Tuning Star Wars Vintage Figures »;Huge selection of Vintage 1977-1985 Star Wars Figures,Vehicles,Playsets;1462320000000;1471910400000;44121;solossmugglersshop.com Gfo $17/Lb Free Shipping »;Prevent Algae In Aquariums Lowest Prices On Gfo Anywhere;1459900800000;1469923200000;42029;ebay.com PlatinumPool online store;Best online swimming pool store Lowest prices and free shipping;1466726400000;1470441600000;22003;stores.ebay.com Strip Curtains $99/roll »;Phthalate Free Clear PVC Save Energy & Money;1459900800000;1469923200000;19863;ebay.com Great Furniture »;Home Goods Furniture;1461801600000;1471910400000;13936;stores.ebay.com/doordirect/ Kathymac Jewelry »;Indian Jewelry,Silver Turquoise Pendants, Earrings, Fashion Jewelry;1465948800000;1471910400000;11956;stores.ebay.com/Kathymac-Jewelry Kia & Hyundai OEM Parts »;Low cost Original Equipment Parts Free shipping;1459900800000;1470009600000;8093;ebay.com/usr/phd_auto_parts Ducati Used Parts;European and American Sportbike Used Parts and Accessories;1459900800000;1471305600000;7828;stores.ebay.com/imperialsportbikes ACECLUB - eBay Stores;Welceom to ACECLUB. We carries auto parts, Mobil1 oil, LED strips etc.;1461801600000;1468972800000;7234;stores.ebay.com/aceclub
 
advertiser_landings
Цена: 100 API юниты за строку

This report lists URLs of a domain’s landing pages promoted via display ads.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*advertiser_landingsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
domain*example.comдомен
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns target_url, first_seen, last_seen, times_seen, ads_count список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort ast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc, ads_count_asc, ads_count_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all
display_filter url фильтр для столбцов

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&type=advertiser_landings

Пример ответа

target_url;first_seen;last_seen;times_seen;ads_count http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=profootballtalk.nbcsports.com&image=27571844;1465948800000;1471910400000;101584;1 http://www.wayfair.com/gateway.php?refid=GX56855779276.lampsusa.com~&position=none&network=d&pcrid=56855779276&device=c&placement=lampsusa.com;1459900800000;1465862400000;53535;1 http://www.wayfair.com/gateway.php?refid=GX49222149933.www.antiques.com~&position=none&network=d&pcrid=49222149933&device=t&placement=www.antiques.com;1459900800000;1471910400000;52003;1 http://www.wayfair.com/gateway.php?refid=GX56855779276.lampsusa.com~&position=none&network=d&pcrid=56855779276&device=t&placement=lampsusa.com;1459900800000;1465862400000;51424;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=82baac0daefc2cb2.anonymous.google&image=27571844;1462406400000;1471910400000;43596;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=bronxbaseballdaily.com&image=27571844;1462320000000;1471910400000;41458;1 http://www.wayfair.com/gateway.php?refid=GX62899178682.www.antiquesnavigator.com~&position=none&network=d&pcrid=62899178682&device=t&placement=www.antiquesnavigator.com&image=14557927;1459987200000;1471824000000;33808;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=gotitans.com&image=27571844;1462320000000;1471910400000;32005;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=www.celticslife.com&image=27571844;1468281600000;1471910400000;31344;1 http://www.wayfair.com/gateway.php?refid=GX60014892162.www.antiquesnavigator.com~&position=none&network=d&pcrid=60014892162&device=t&placement=www.antiquesnavigator.com&image=14982740;1460073600000;1471824000000;28714;1
 
advertiser_publisher_text_ads
Цена: 100 API юниты за строку

This report lists the display ads of a given advertiser that have appeared on a particular publisher’s website.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*advertiser_publisher_text_adsтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
advertiser_domain*example.comдомен
publisher_domain*example.comдомен
display_limitintegerколичество результатов; если параметр не передан или равен нулю, его значение будет 10 000
display_offsetintegerначальная позиция
Пожалуйста, учитывайте, что если вы используете параметр display_offset, значение параметра display_limit должно быть увеличено на значение параметра display_offset
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns title, text, first_seen, last_seen, times_seen, visible_url список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all
display_filter ad, title, text, url фильтр для столбцов

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&advertiser_domain=ebay.com&publisher_domain=urbandictionary.com&type=advertiser_publisher_text_ads

Пример ответа

title;text;first_seen;last_seen;times_seen;visible_url Strip Curtains $99/roll »;Phthalate Free Clear PVC Save Energy & Money;1460160000000;1468627200000;415;ebay.com Kathymac Jewelry;Indian Jewelry,Silver Turquoise Pendants, Earrings, Fashion Jewelry;1466035200000;1468540800000;265;stores.ebay.com/Kathymac-Jewelry PlatinumPool online store »;Best online swimming pool store Lowest prices and free shipping;1467331200000;1468627200000;234;stores.ebay.com Discount Diamond Grind;Diamond Grind and ERGO Killer Prices and Free ship;1461801600000;1468627200000;211;grinderpalace.com Memories from the past;Memorablia from the 60s til today musicians boys bands, actors, teens;1461888000000;1467244800000;161;stores.ebay.com/teen-idol-heaven Muhammad Ali G.O.A.T.;Honor the Greatest of All Time! American Apparel G.O.A.T T-Shirt;1465948800000;1466726400000;157;ebay.com Car Headlight Fog Upgrade;Specialize Automotive Lighting Lamp Quality Brand item Replacement Bulb;1465948800000;1468627200000;115;stores.ebay.com/formulaj87/ Rev. Tye's Coin Stache »;Are you nikel-ish? Tons of certified buffalo nickels;1461801600000;1468195200000;88;stores.ebay.com/RevTyes-Coin-Stache Marine Emblem Bullet Pen;Made in USA by a Veteran. Well made with the Corps in mind.;1468195200000;1468540800000;74;ebay.com/itm/like/172037229785 RPG Books Great Price;Low Prices on New RPG Books From Mongoose & StarFleet;1461974400000;1467936000000;69;ebay.com
 
advertiser_rank
Цена: 10 API юниты за строку

This report lists advertisers ranked by the total number of display ads noticed by SEMrush.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*advertiser_rankтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
domain*example.comдомен
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns domain, ads_overall, text_ads_overall, media_ads_overall, first_seen, last_seen, times_seen, domain_overall список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&type=advertiser_rank

Пример ответа

domain;ads_overall;text_ads_overall;media_ads_overall;first_seen;last_seen;times_seen;domain_overall ebay.com;2932;2658;274;1364342400000;1471910400000;848588;37213
 
publisher_rank
Цена: 10 API юниты за строку

This report lists publishers ranked by the total number of display ads noticed by SEMrush.

Запрашиваемый URL

https://api.semrush.com/analytics/da/v2/

Параметры запроса

НазваниеЗначениеОписание
type*publisher_rankтип отчета
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXидентификационный ключ пользователя, Вы можете найти его в своём профиле на сайте
action*report
domain*example.comдомен
export_escape1If this parameter uses the value "1", the report’s string columns will be wrapped in double quotation marks (").
export_decode1 или 00 означает, что ответ будет передан в закодированном виде (urlencoded),
1 - ответ не будет преобразован
export_columns domain, ads_overall, text_ads_overall, media_ads_overall, first_seen, last_seen, times_seen, domain_overall список названий столбцов через запятую; если параметр не передан, будут отправлены столбцы по-умолчанию
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android стандартное значение параметра all

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

https://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=urbandictionary.com&type=publisher_rank

Пример ответа

domain;ads_overall;text_ads_overall;media_ads_overall;first_seen;last_seen;times_seen;domain_overall urbandictionary.com;1916819;1687303;229516;1368921600000;1471910400000;78970987;64985
Столбцы
Описание колонок ответа:
Значение Описание
Ab The place on a SERP where an ad appeared (top, side, or bottom blocks).
Ac Estimated budget spent buying keywords in Google AdWords for ads that appear in paid search results (monthly estimation).
Ad Keywords a website is buying in Google AdWords for ads that appear in paid search results.
Am Changes in the number of paid keywords.
At Traffic brought to the website via paid search results.
Bm Changes in paid traffic.
Cg The total cost of all traffic driven to an analyzed domain with a given keyword over a specific period of time.
Cm Changes in paid traffic price.
Co Competitive density of advertisers using the given term for their ads. One (1) means the highest competition.
Cp Average price in US dollars advertisers pay for a user's click on an ad containing a particular keyword (Google AdWords).
Cr Competition level based on the total number of keywords of each domain and the number of keywords the domains have in common.
Cv Keyword coverage represents the percentage of ads displayed for a particular keyword in the last 12 months (100% = 12 months).
Db Regional database (US, UK, Italy, etc.)
Dn A website's position for a particular keyword in Google's top 20 organic search results.
Ds Ad text.
Dt Actual date.
Fl SERP features
Hs This columns shows whether or not a report's line returns historical data.
Ip IP address.
Kd An estimate of how difficult it would be to rank well in organic search results for a particular keyword. The higher the percentage, the harder it is to achieve high rankings for the given keyword.
Lc Number of API units per line.
Li Number of lines requested for a report by a particular user.
Np Common keywords that domains are ranking for in Google's top 20 organic search results.
Nq The average number of times users have searched for a given keyword per month. We calculate this value over the last 12 months.
Nr The total number of organic results returned for a given keyword at the last date of collection.
Oc Estimated price of organic keywords in Google AdWords.
Of Value of a parameter display_offset requested by a particular user.
Om Changes in the number of organic keywords.
Or Keywords that bring users to a website via Google's top 20 organic search results.
Ot Traffic brought to a website via Google's top 20 organic search results.
P0 A position of the first queried domain for a particular keyword in Google top 20 organic or paid search results.
P1 A position of the second queried domain for a particular keyword in Google top 20 organic or paid search results.
P2 A position of the third queried domain for a particular keyword in Google top 20 organic or paid search results.
P3 A position of the fourth queried domain for a particular keyword in Google top 20 organic or paid search results.
P4 A position of the fifth queried domain for a particular keyword in Google top 20 organic or paid search results.
Pc Number of keywords.
Pd The difference between the previous position a domain was earning with a particular keyword and its current position.
Ph Keyword bringing users to the website via Google's top 20 organic search results.
Po position a URL gets with a particular keyword in Google top 20 organic or paid search results.
Pp A position a domain gets with a particular keyword in Google top 20 organic or paid search results.
Pr Price of promoted product
Rh The SEMrush rating of the website's popularity based on organic traffic coming from Google's top 20 organic search results.
Rk The SEMrush rating of the website's popularity based on organic traffic coming from Google's top 20 organic search results.
Rt Report type.
Sh Number of keywords the website is using for product listing ads.
Sn Shop name
Sv Number of unique product listing ads (PLA Copies)
Tc The total amount spent on keywords in Google AdWords for which the domain is ranking in search results.
Tg The amount of estimated organic traffic driven to an analyzed domain with a given keyword over a specific period of time.
Td The interest of searchers in a particular keyword during the last 12 months. This metric is based on changes in the number of queries per month.
Tm Changes in organic traffic.
Tr The share of traffic driven to the website with a particular keyword for a specified period.
Ts UNIX Timestamp.
Tt Ad title.
Um Changes in organic traffic cost.
Un Ad id
Ur The URL of the target page (Backlinks).
Vu Visible URL.
ads_count The total number of all types of display ads (media and text) during a specified period.
ads_overall The total number of all types of display ads (media and text) for all time.
advertisers_count The total number of advertisers on Google’s Display Network where a publisher promoted a website in the last 7 days.
advertisers_overall The total number of advertisers on Google’s Display Network where a publisher promoted a website.
anchor A clickable text of a backlink.
avg_positions An average position of an ad.
domain Domain name.
domain_overall The total number of advertisers on Google’s Display Network where a publisher promoted a website, or the total number of publishers’ websites where the display ads of an advertiser's website appeared during a whole period.
external_num The number of the source page’s links that point to other websites’ pages.
first_seen The timestamp on which SEMrush first noticed a backlink.
image_alt A URL of an image backlink's location.
internal_num The number of the source page’s links that point to webpages of the same website.
last_seen The timestamp on which SEMrush last noticed a backlink.
media_ads_count The total number of media display ads of an advertiser SEMrush has noticed during a specified period.
media_ads_overall The total number of an advertiser’s media display ads SEMrush has noticed for a whole period.
media_type The display ad’s type of media.
publishers_count The total number of publishers’ websites where display ads of an advertiser's website appeared in the last 7 days.
publishers_overall The total number of publishers’ websites where the display ads of an advertiser's website appeared during a whole period.
redirect_url The last URL in a redirect chain.
response_code Server response code.
source_title The title of the source page.
source_size The source page‘s size in bytes.
source_url The URL of the source page.
target_title The title of the target page.
target_url The URL of the target page (Backlinks).
target_url The landing page of a display ad (Display Advertising).
text The text of a display ad.
text_ads_count The total number of display ads during a specified period.
text_ads_overall The total number of display ads SEMrush noticed for a whole period.
times_seen The number of times SEMrush saw a display ad.
title The title of a display ad.
type Backlink type (follow, nofollow, image, form, text).
visible_url A visible URL of a display ad.
score This metric measures the importance of a domain using a 100-point scale (from 0 to 100) and is based on the quality and volume of links pointing to this domain. The higher the score, the higher the quality of the domain. Domain Score is calculated in the same way as Google's PageRank
trust_score This metric measures the trustworthiness of a particular domain using a 100-point scale (with ‘0’ indicating a low-trust site and ‘100’ indicating a highly trusted site) and is based on the number of backlinks from trusted sites pointing to the domain. If a site’s Trust Score is significantly lower than its Domain Score, this may be a sign that the latter was artificially inflated. Backlinks from such sites may trigger Google penalties.
neighbour A domain with a similar backlink profile to the analyzed domain.
similarity This metric is calculated based on the number of referring domains to each competitor and the total number of common referring domains to all competitors. If websites have a large number of common referring domains, they can be considered competitors.
common_refdomains The number of referring domains that link back to both the analyzed and competing domains.
domains_num The total number of domains, including common referring domains, linking to a given domain.
backlinks_num The number of backlinks to a given domain.
  • Порядок столбцов указан в первой строке файла
  • Имена столбцов никогда не меняются
  • порядок столбцов может изменяться
  • количество МОЖЕТ увеличиваться
  • старые столбцы могут удаляться только после предварительного уведомления
Сортировки
Описание сортировок:
am_asc сортировка по изменению кол-ва adwords ключевых слов, по возрастанию (Am)
am_desc сортировка по изменению кол-ва adwords ключевых слов, по убыванию (Am)
bm_asc сортировка по изменению adwords трафика, по возрастанию (Bm)
bm_desc сортировка по изменению adwords трафика, по убыванию (Bm)
cm_asc сортировка по изменению стоимости adwords трафика, по возрастанию (Cm)
cm_desc сортировка по изменению стоимости adwords трафика, по убыванию (Cm)
co_asc сортировка по конкуренции по возрастанию (поле Co)
co_desc сортировка по конкуренции по убыванию (поле Co)
cp_asc сортировка по CPC по возрастанию (поле Cp)
cp_desc сортировка по CPC по убыванию (поле Cp)
cr_desc сортировка по релевантности по убыванию (поле Cr)
cv_asc сортировка по покрытию по возрастанию (поле Cv)
cv_desc сортировка по покрытию по убыванию (поле Cv)
dt_asc - sorting by last update date, in ascending order (Ts)
dt_desc - sorting by last update date, in descending order (Ts)
np_desc сортировка по общим ключевым словам по убыванию (поле Np)
nq_asc сортировка по количеству запросов по возрастанию (поле Nq)
nq_desc сортировка по количеству запросов по убыванию (поле Nq)
nr_asc сортировка по количеству результатов по возрастанию (поле Nr)
nr_desc сортировка по количеству результатов по убыванию (поле Nr)
om_asc сортировка по изменению кол-ва organic ключевых слов, по возрастанию (Om)
om_desc сортировка по изменению кол-ва organic ключевых слов, по убыванию (Om)
p0_asc сортировка по позиции 1го домена по возрастанию (поле P0)
p0_desc сортировка по позиции 1го домена по убыванию (поле P0)
p1_asc сортировка по позиции 2го домена по возрастанию (поле P1)
p1_desc сортировка по позиции 2го домена по убыванию (поле P1)
p2_asc сортировка по позиции 3го домена по возрастанию (поле P2)
p2_desc сортировка по позиции 3го домена по убыванию (поле P2)
p3_asc сортировка по позиции 4го домена по возрастанию (поле P3)
p3_desc сортировка по позиции 4го домена по убыванию (поле P3)
p4_asc сортировка по позиции 5го домена по возрастанию (поле P4)
p4_desc сортировка по позиции 5го домена по убыванию (поле P4)
po_asc сортировка по позиции по возрастанию (поле Po)
po_desc сортировка по позиции по убыванию (поле Po)
tc_asc сортировка по стоимости трафика по возрастанию (поле Tc)
tc_desc сортировка по стоимости трафика по убыванию (поле Tc)
tm_asc сортировка по изменению organic трафика, по возрастанию (Tm)
tm_desc сортировка по изменению organic трафика, по убыванию (Tm)
tr_asc сортировка по трафику по возрастанию (поле Tr)
tr_desc сортировка по трафику по убыванию (поле Tr)
um_asc сортировка по изменению стоимости organic трафика, по возрастанию (Um)
um_desc сортировка по изменению стоимости organic трафика, по убыванию (Um)
last_seen_asc сортировка когда последний раз замечен, по возрастанию (last_seen)
last_seen_desc сортировка когда последний раз замечен, по убыванию (last_seen)
first_seen_asc сортировка когда первый раз замечен, по возрастанию (first_seen)
first_seen_desc сортировка когда первый раз замечен, по убыванию (first_seen)
times_seen_asc сортировка сколько был раз замечен, по возрастанию (times_seen)
times_seen_desc сортировка сколько был раз замечен, по убыванию (times_seen)
ads_count_asc сортировка по кол-ву объявлений, по возрастанию (ads_count)
ads_count_desc сортировка по кол-ву объявлений, по убыванию (ads_count)
Databases
Database code Database region Research types Google search domain
us США Organic, Adwords, PLA google.com
uk Великобритания Organic, Adwords, PLA google.co.uk
ca Канада Organic, Adwords, PLA google.ca
ru Россия Organic, Adwords, PLA google.ru
de Германия Organic, Adwords, PLA google.de
fr Франция Organic, Adwords, PLA google.fr
es Испания Organic, Adwords, PLA google.es
it Италия Organic, Adwords, PLA google.it
br Бразилия Organic, Adwords, PLA google.com.br
au Австралия Organic, Adwords, PLA google.com.au
ar Аргентина Organic, Adwords, PLA google.com.ar
be Бельгия Organic, Adwords, PLA google.be
ch Швейцария Organic, Adwords, PLA google.ch
dk Дания Organic, Adwords, PLA google.dk
fi Финляндия Organic, Adwords google.fi
hk Гонконг Organic, Adwords, PLA google.com.hk
ie Ирландия Organic, Adwords, PLA google.ie
il Израиль Organic, Adwords google.co.il
mx Мексика Organic, Adwords, PLA google.com.mx
nl Нидерланды Organic, Adwords, PLA google.nl
no Норвегия Organic, Adwords, PLA google.no
pl Польша Organic, Adwords, PLA google.pl
se Швеция Organic, Adwords, PLA google.se
sg Сингапур Organic, Adwords, PLA google.com.sg
tr Турция Organic, Adwords, PLA google.com.tr
jp Япония Organic, Adwords, PLA google.co.jp
in Индия Organic, Adwords, PLA google.co.in
hu Hungary Organic, Adwords google.hu
af Afghanistan Organic, Adwords google.com.af
al Albania Organic, Adwords google.al
dz Algeria Organic, Adwords google.dz
ao Angola Organic, Adwords google.co.ao
am Armenia Organic, Adwords google.am
at Austria Organic, Adwords, PLA google.at
az Azerbaijan Organic, Adwords google.az
bh Bahrain Organic, Adwords google.com.bh
bd Bangladesh Organic, Adwords google.com.bd
by Belarus Organic, Adwords google.by
bz Belize Organic, Adwords google.com.bz
bo Bolivia Organic, Adwords google.com.bo
ba Bosnia and Herzegovina Organic, Adwords google.ba
bw Botswana Organic, Adwords google.co.bw
bn Brunei Organic, Adwords google.com.bn
bg Bulgaria Organic, Adwords google.bg
cv Cabo Verde Organic, Adwords google.cv
kh Cambodia Organic, Adwords google.com.kh
cm Cameroon Organic, Adwords google.cm
cl Chile Organic, Adwords, PLA google.cl
co Colombia Organic, Adwords, PLA google.com.co
cr Costa Rica Organic, Adwords google.co.cr
hr Croatia Organic, Adwords google.hr
cy Cyprus Organic, Adwords google.com.cy
cz Czech Republic Organic, Adwords, PLA google.cz
cd Congo Organic, Adwords google.cd
do Dominican Republic Organic, Adwords google.com.do
ec Ecuador Organic, Adwords google.com.ec
eg Egypt Organic, Adwords google.com.eg
sv El Salvador Organic, Adwords google.com.sv
ee Estonia Organic, Adwords google.ee
et Ethiopia Organic, Adwords google.com.et
ge Georgia Organic, Adwords google.ge
gh Ghana Organic, Adwords google.com.gh
gr Greece Organic, Adwords google.gr
gt Guatemala Organic, Adwords google.com.gt
gy Guyana Organic, Adwords google.gy
ht Haiti Organic, Adwords google.ht
hn Honduras Organic, Adwords google.hn
is Iceland Organic, Adwords google.is
id Indonesia Organic, Adwords, PLA google.co.id
jm Jamaica Organic, Adwords google.com.jm
jo Jordan Organic, Adwords google.jo
kz Kazakhstan Organic, Adwords google.kz
kw Kuwait Organic, Adwords google.com.kw
lv Latvia Organic, Adwords google.lv
lb Lebanon Organic, Adwords google.com.lb
lt Lithuania Organic, Adwords google.lt
lu Luxembourg Organic, Adwords google.lu
mg Madagascar Organic, Adwords google.mg
my Malaysia Organic, Adwords, PLA google.com.my
mt Malta Organic, Adwords google.com.mt
mu Mauritius Organic, Adwords google.mu
md Moldova Organic, Adwords google.md
mn Mongolia Organic, Adwords google.mn
me Montenegro Organic, Adwords google.me
ma Morocco Organic, Adwords google.co.ma
mz Mozambique Organic, Adwords google.co.mz
na Namibia Organic, Adwords google.com.na
np Nepal Organic, Adwords google.com.np
nz New Zealand Organic, Adwords, PLA google.co.nz
ni Nicaragua Organic, Adwords google.com.ni
ng Nigeria Organic, Adwords google.com.ng
om Oman Organic, Adwords google.com.om
py Paraguay Organic, Adwords google.com.py
pe Peru Organic, Adwords google.com.pe
ph Philippines Organic, Adwords, PLA google.com.ph
pt Portugal Organic, Adwords, PLA google.pt
ro Romania Organic, Adwords google.ro
sa Saudi Arabia Organic, Adwords google.com.sa
sn Senegal Organic, Adwords google.sn
rs Serbia Organic, Adwords google.rs
sk Slovakia Organic, Adwords google.sk
si Slovenia Organic, Adwords google.si
za South Africa Organic, Adwords, PLA google.co.za
kr South Korea Organic, Adwords google.co.kr
lk Sri Lanka Organic, Adwords google.lk
th Thailand Organic, Adwords google.co.th
bs Bahamas Organic, Adwords google.bs
tt Trinidad and Tobago Organic, Adwords google.tt
tn Tunisia Organic, Adwords google.tn
ua Ukraine Organic, Adwords google.com.ua
ae United Arab Emirates Organic, Adwords, PLA google.ae
uy Uruguay Organic, Adwords google.com.uy
ve Venezuela Organic, Adwords google.co.ve
vn Vietnam Organic, Adwords google.com.vn
zm Zambia Organic, Adwords google.co.zm
zw Zimbabwe Organic, Adwords google.co.zw
ly Libya Organic, Adwords google.com.ly
mobile-us United States, Google Mobile Organic, Adwords google.com
mobile-uk United Kingdom, Google Mobile Organic, Adwords google.com
mobile-ca Canada, Google Mobile Organic, Adwords google.ca
mobile-de Germany, Google Mobile Organic, Adwords google.de
mobile-fr France, Google Mobile Organic, Adwords google.fr
mobile-es Spain, Google Mobile Organic, Adwords google.es
mobile-it Italy, Google Mobile Organic, Adwords google.it
mobile-br Brazil, Google Mobile Organic, Adwords google.com.br
mobile-au Australia, Google Mobile Organic, Adwords google.com.au
mobile-dk Denmark, Google Mobile Organic, Adwords google.dk
mobile-mx Mexico, Google Mobile Organic, Adwords google.com.mx
mobile-nl Netherlands, Google Mobile Organic, Adwords google.nl
mobile-se Sweden, Google Mobile Organic, Adwords google.se
mobile-tr Turkey, Google Mobile Organic, Adwords google.com.tr
mobile-in India, Google Mobile Organic, Adwords google.co.in
mobile-id Indonesia, Google Mobile Organic, Adwords google.co.id
mobile-il Israel, Google Mobile Organic, Adwords google.co.il
Фильтры
Чтобы применить фильтр к отчету, необходимо добавить параметр display_filter со строкой, содержащей фильтры, разделенные знаком "|" (максимальное число - 25), зашифрованные с помощью urlencode.
Обратите внимание, что некоторые готовые функции неправильно кодируют "+"! Убедитесь, что он кодируется в последовательность символов "%2B".
Фильтр состоит из <sign>|<field>|<operation>|<value>, ult
<sign> - "+" или "-" (include/exclude)
<field> - возможные поля: Co, Cp, Db, Hs, Nq, Nr, P0, P1, P2, P3, P4, Ph, Po, Pp, Qu, Rt, Tc, Tr, Ts, Ur, Vu, ad, title, text, url
  • Метрические поля
  • Текстовые поля
  • Поля с фиксированным набором значений
<operation> - доступные операции: Eq, Gt, Lt, Bw, Ew, Co, Wm
  • Для метрических полей
  • Для текстовых полей
  • Для полей с фиксированным набором значений
<value> - значение для фильтра
Сообщения об ошибках
Descriptions of error messages:
Значение Описание
ERROR 50 :: NOTHING FOUND Мы не нашли никакой информации, касательно Вашего запроса.
ERROR 40 :: MANDATORY PARAMETER action NOT SET OR EMPTY Необходимый параметр action не присутствует в запросе. Пожалуйста, добавьте его в запрос или проверьте правильность написания.
ERROR 41 :: MANDATORY PARAMETER type NOT SET OR EMPTY Необходимый параметр type не присутствует в запросе. Пожалуйста, добавьте его в запрос или проверьте правильность написания.
ERROR 42 :: MANDATORY PARAMETER domain NOT SET OR EMPTY Необходимый параметр domain не присутствует в запросе. Пожалуйста, добавьте его в запрос или проверьте правильность написания.
ERROR 43 :: MANDATORY PARAMETER phrase NOT SET OR EMPTY Необходимый параметр phrase не присутствует в запросе. Пожалуйста, добавьте его в запрос или проверьте правильность написания.
ERROR 44 :: MANDATORY PARAMETER url NOT SET OR EMPTY Необходимый параметр url не присутствует в запросе. Пожалуйста, добавьте его в запрос или проверьте правильность написания.
ERROR 46 :: MANDATORY PARAMETER database NOT SET OR EMPTY The required parameter database is missing, or its value is not set. Please add it to your request, or set its value.
ERROR 120 :: WRONG KEY - ID PAIR Вы используете неизвестный API ключ. Пожалуйста, используйте корректный API ключ из своего профиля.
ERROR 130 :: API DISABLED Ваш тариф не позволяет Вам использовать API.
ERROR 131 :: LIMIT EXCEEDED Был достигнут предел запросов для текущего отчета. (Действительно для пользователей со старым API.)
ERROR 132 :: API UNITS BALANCE IS ZERO Был достигнут предел запросов. Чтобы продолжить использовать API, пополните свой баланс или перейдите на тарифный план выше.
ERROR 133 :: DB ACCESS DENIED У Вас нет доступа к запрашиваемой базе данных.
ERROR 134 :: TOTAL LIMIT EXCEEDED Был достигнут предел запросов. (Действительно для пользователей со старым API.)
ERROR 135 :: API REPORT TYPE DISABLED У Вас нет доступа к запрашиваемому отчету.
Have a Suggestion?