contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 5:00 PM (EST/EDT)

Monday - Friday

mobile-menu

.Trends API reference

.Trends divider Last updated: November 15, 2024

Traffic Summary

Price: 1 API units per line

The Traffic Summary method provides estimated traffic metrics for domains of your choice. You can request data for traffic rank, visits, unique visitors, pages per visit, average visit duration, and bounce rate. About the Traffic Analytics Overview report ›

If the response returns no data, you aren’t charged API units for that request. If you request data for several domains and only get data for some of them, you’d be charged only for the data returned.
Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

targets* example1.com, subdomain.example2.com, e…
example1.com, subdomain.example2.com, example3.com/subfolder/

Array of domains, subdomains, and subfolders separated by commas. The maximum number of targets is 200.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, rank, visits, categories, deskt…
target, rank, visits, categories, desktop_visits, mobile_visits, users, desktop_users, mobile_users, direct, referral, social (deprecated), search (deprecated), paid (deprecated), search_organic, search_paid, social_organic, social_paid, mail, display_ad, unknown_channel (deprecated), time_on_site, desktop_time_on_site, mobile_time_on_site, pages_per_visit, desktop_pages_per_visit, mobile_pages_per_visit, bounce_rate, desktop_bounce_rate, mobile_bounce_rate, desktop_share, mobile_share, accuracy, display_date, country, device_type

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/summary

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/summary?targets=golang.org,blog.golang.org,tour.golang.org/welcome/&export_columns=target,visits,users&key=YOUR_API_KEY

Response example

Copy code

target;visits;users
golang.org;4491179;1400453
blog.golang.org;402104;204891
tour.golang.org/welcome/;10131;11628

Daily Traffic

Price: 1 API units per request

The Daily Traffic report provides a day-by-day breakdown of traffic to your selected domains. This detailed view lets you monitor daily fluctuations, identify trends, and quickly respond to changes in user behavior.

If a response is empty, no API units will be deducted.

About the Traffic Analytics Overview report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example1.com, subdomain.example2.com, e…
example1.com, subdomain.example2.com, example3.com/subfolder/

Target can be a domain, subdomain, or subfolder.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01, and the maximum is the beginning of the current month. For example, if today is June 19, 2024, use 2024-06-01.

target_type domain, subdomain, subfolder

Type of the analyzed target. If this parameter isn't specified, the default value is domain.

device_type desktop, mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

include_forecasted_items boolean

The parameter indicates whether the response includes forecasted items for the next four weeks. The display_date parameter must be set to the current month.
The default value is false.

export_columns display_date, country, device_type, tar…
display_date, country, device_type, target, rank, visits, users, hits, direct, search_organic, search_paid, social_organic, social_paid, referral, mail, display_ad, time_on_site, pages_per_visit, bounce_rate, desktop_share, mobile_share, is_forecasted

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/summary_by_day

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/summary_by_day?key=YOUR_API_KEY&target=amazon.com

Response example

Copy code

display_date;country;device_type;target;rank;visits;users;hits;direct;search_organic;search_paid;social_organic;social_paid;referral;mail;display_ad;time_on_site;pages_per_visit;bounce_rate;desktop_share;mobile_share;is_forecasted
2024-06-30;GLOBAL;all;amazon.com;0;103586597;70437917;651596634;76816533;17991257;58247;1565166;35436;6520778;580986;18194;647;6.275;0.4264;0.42145535;0.57854465;false
2024-06-29;GLOBAL;all;amazon.com;0;102457115;69824082;618914876;75032319;18494429;57690;1652788;40196;6548560;613758;17375;612;6.0252;0.4305;0.41698431;0.58301569;false
2024-06-28;GLOBAL;all;amazon.com;0;107005708;72051727;686604603;79105953;18057598;79027;1517547;55460;7387982;791156;10985;645;6.4055;0.4127;0.48403498;0.51596502;false
2024-06-27;GLOBAL;all;amazon.com;0;113180022;76235002;754933127;83265872;18964215;75376;1805024;33989;8191619;825698;18229;669;6.6559;0.4144;0.49430868;0.50569132;false
2024-06-26;GLOBAL;all;amazon.com;0;115844372;76942983;779737715;86152264;18914670;87033;1658947;38528;8137318;847370;8242;685;6.7106;0.4074;0.49127579;0.50872421;false
2024-06-25;GLOBAL;all;amazon.com;0;118358151;78689393;762819949;88565966;19039301;98995;1640685;59650;7958556;976174;18824;643;6.4338;0.4036;0.48358269;0.51641731;false
2024-06-24;GLOBAL;all;amazon.com;0;117514582;78407142;784803175;87053649;20025331;89054;1778839;5047;7668419;885536;8707;646;6.663;0.3978;0.49301105;0.50698895;false
2024-06-23;GLOBAL;all;amazon.com;0;100666629;69375175;646592976;74144248;17890619;62690;1407735;9300;6577603;565315;9119;632;6.3989;0.4225;0.43180014;0.56819986;false
2024-06-22;GLOBAL;all;amazon.com;0;101747143;69010191;673743869;76101430;17588862;46008;1495174;58429;5871932;576844;8464;627;6.6029;0.4159;0.4178943;0.5821057;false
2024-06-21;GLOBAL;all;amazon.com;0;109340156;74256859;704258068;81050746;18650361;67545;1469709;56162;7203966;808371;33296;617;6.4266;0.4114;0.48504706;0.51495294;false
2024-06-20;GLOBAL;all;amazon.com;0;111404266;74657696;738551585;81441782;19127523;88489;1445056;30992;8407398;828191;34835;634;6.6131;0.4;0.50342255;0.49657745;false
2024-06-19;GLOBAL;all;amazon.com;0;115030354;77172152;761763570;84513489;19779486;95961;1745132;34453;8104716;747541;9576;646;6.6104;0.4145;0.46715104;0.53284896;false
2024-06-18;GLOBAL;all;amazon.com;0;112162567;75613613;738426516;82178204;19241141;100591;1672551;58474;7983988;866790;60828;629;6.5699;0.4028;0.49272368;0.50727632;false
2024-06-17;GLOBAL;all;amazon.com;0;111418578;75062884;726620669;82642435;18753868;76336;1613479;56919;7451791;809438;14312;609;6.5111;0.4089;0.47990418;0.52009582;false
2024-06-16;GLOBAL;all;amazon.com;0;98532767;68217781;608461415;73490182;17108715;53785;1535140;56690;5780960;499517;7778;613;6.1594;0.4271;0.40585389;0.59414611;false
2024-06-15;GLOBAL;all;amazon.com;0;98234927;66849420;623297300;73015052;16987804;62817;1436509;52949;6161948;481711;36137;600;6.3309;0.4293;0.41174116;0.58825884;false
2024-06-14;GLOBAL;all;amazon.com;0;109489682;73346071;703388186;80895042;18953897;85524;1435966;33829;7283093;783235;19096;623;6.4097;0.3945;0.47460325;0.52539675;false
2024-06-13;GLOBAL;all;amazon.com;0;111573079;75122292;723933671;82388056;18895968;72921;1655438;21061;7631506;902932;5197;633;6.4725;0.4014;0.49206016;0.50793984;false
2024-06-12;GLOBAL;all;amazon.com;0;113597923;75159335;751484976;83306829;19614344;95841;1589911;7990;8074566;894463;13979;642;6.5974;0.3957;0.49374269;0.50625731;false
2024-06-11;GLOBAL;all;amazon.com;0;111752847;75171380;757817329;82324486;19159510;82862;1592017;19437;7707330;856596;10609;659;6.7627;0.389;0.50530528;0.49469472;false
2024-06-10;GLOBAL;all;amazon.com;0;112495395;75074303;761238582;82548042;19240554;72516;1650312;12019;8101044;860517;10391;656;6.7448;0.401;0.50204053;0.49795947;false
2024-06-09;GLOBAL;all;amazon.com;0;96979146;67827206;613818643;71508780;17144768;52551;1637482;14617;6043051;546336;31561;618;6.3159;0.42;0.42438743;0.57561257;false
2024-06-08;GLOBAL;all;amazon.com;0;95945983;67057452;603417777;70449620;17042670;58133;1406499;54176;6412400;510854;11631;611;6.2731;0.418;0.41780173;0.58219827;false
2024-06-07;GLOBAL;all;amazon.com;0;105063889;70552934;688149083;77206014;18352820;67047;1462756;32327;7174528;748314;20083;633;6.5349;0.4132;0.48267589;0.51732411;false
2024-06-06;GLOBAL;all;amazon.com;0;109415431;72869527;695519708;81158898;18025055;78162;1528083;36350;7787319;769875;31689;638;6.3408;0.4141;0.4920405;0.5079595;false
2024-06-05;GLOBAL;all;amazon.com;0;113060694;75476493;749087043;83246533;19510636;63484;1497359;54668;7792795;855375;39844;660;6.6093;0.3979;0.49058546;0.50941454;false
2024-06-04;GLOBAL;all;amazon.com;0;113635493;75692616;763604375;83549687;19467234;79189;1602640;13611;8029915;878385;14832;668;6.7057;0.4066;0.49861661;0.50138339;false
2024-06-03;GLOBAL;all;amazon.com;0;117709589;78811846;767848524;86195564;20354170;72084;1676320;14067;8411974;970207;15203;636;6.5084;0.4038;0.48972764;0.51027236;false
2024-06-02;GLOBAL;all;amazon.com;0;101701940;70142373;642436422;74934356;18265537;51936;1394863;55299;6421113;571641;7195;631;6.3013;0.4302;0.41776758;0.58223242;false
2024-06-01;GLOBAL;all;amazon.com;0;99413898;68288847;630945547;73340487;17468240;55983;1613196;82713;6164236;681477;7566;634;6.3309;0.4119;0.40935745;0.59064255;false

Weekly Traffic

Price: 1 API units per request

The Weekly Traffic report offers a week-by-week analysis of traffic to your chosen domains. By examining this data, you can understand broader trends, compare week-to-week performance, and make strategic decisions based on weekly traffic patterns.

If the response is empty, no API units will be deducted.

About the Traffic Analytics Overview report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example1.com, subdomain.example2.com, e…
example1.com, subdomain.example2.com, example3.com/subfolder/

Target can be a domain, subdomain, or subfolder.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01, and the maximum is the beginning of the current month. For example, if today is June 19, 2024, use 2024-06-01.

target_type domain, subdomain, subfolder

Type of the analyzed target. If this parameter isn't specified, the default value is domain.

device_type desktop, mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

include_forecasted_items boolean

The parameter indicates whether the response includes forecasted items for the next four weeks. The display_date parameter must be set to the current month.
The default value is false.

export_columns display_date, country, device_type, tar…
display_date, country, device_type, target, rank, visits, users, hits, direct, search_organic, search_paid, social_organic, social_paid, referral, mail, display_ad, time_on_site, pages_per_visit, bounce_rate, desktop_share, mobile_share, is_forecasted

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/summary_by_week

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/summary_by_week?key=YOUR_API_KEY&target=amazon.com

Response example

Copy code

display_date;country;device_type;target;rank;visits;users;hits;direct;search_organic;search_paid;social_organic;social_paid;referral;mail;display_ad;time_on_site;pages_per_visit;bounce_rate;desktop_share;mobile_share;is_forecasted
2024-06-24;GLOBAL;all;amazon.com;0;777946547;302122978;5039410079;575992556;131486801;545422;11618996;268306;52413232;5520678;100556;652;6.4756;0.4135;0.47073155;0.52926845;false
2024-06-17;GLOBAL;all;amazon.com;0;761769693;301350133;4989957253;562072334;131031860;537620;10848836;304729;51601394;5202490;170430;630;6.5489;0.4115;0.46940421;0.53059579;false
2024-06-10;GLOBAL;all;amazon.com;0;755676620;296881946;4929621459;557967689;129960792;526266;10895293;203975;50740447;5278971;103187;636;6.5203;0.4055;0.47154667;0.52845333;false
2024-06-03;GLOBAL;all;amazon.com;0;751810225;294833429;4881445153;553315096;129897353;470650;10811139;219816;51651982;5279346;164843;641;6.4906;0.4109;0.47294365;0.52705635;false
2024-05-27;GLOBAL;all;amazon.com;0;704936584;267575143;4614330178;515553743;124163063;468382;10706681;344186;48346032;5268733;85764;654;6.5425;0.4102;0.47318273;0.52681727;false

Purchase Conversion

Price: 1 API units per request

The Purchase Conversion report provides monthly conversion metrics for a domain in the CSV format. With this data, you can gain insights on your markets, prospects, or partners purchase conversions.

About the Traffic Analytics Overview report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com

Target is a domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01, and the maximum is the beginning of the current month. For example, if today is June 19, 2024, use 2024-06-01.

device_type* desktop

The parameter specifies the type of device data to retrieve. Currently, only desktop is supported.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, display_date, country, device_t…
target, display_date, country, device_type, conversion

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/purchase_conversion

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/purchase_conversion?key=YOUR_API_KEY&target=amazon.com&device_type=desktop

Response example

Copy code

target;display_date;device_type;country;conversion
amazon.com;2024-06-01;desktop;GLOBAL;0.04269275

Industry Categories

Price: 500 API units per request

The Industry Categories report provides a list of all domains within specific industry categories. With this data, you can gain insights on domains that fit within unique industry categories to better understand their distinctive features and trends.

About the Market Explorer All Domains report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

category* CATEGORY_NAME

Category name from the list of 110 categories. For example, human_resources.

Refer to Industry categories to find the list of all available values along with the corresponding Market Explorer business categories.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01, and the maximum is the beginning of the current month. For example, if today is June 19, 2024, use 2024-06-01.

export_columns domain_name, total_traffic, direct_traf…
domain_name, total_traffic, direct_traffic, referral_traffic, search_organic_traffic, search_paid_traffic, social_organic_traffic, social_paid_traffic, email_traffic, display_ad_traffic, facebook_traffic, youtube_traffic, pinterest_traffic, instagram_traffic, twitter_traffic, linkedin_traffic, vk_traffic, reddit_traffic, conversion_rate, unique_visitors, users_captured, hits, sum_time_on_site, bounce_rate, bounced_visits, male, female, age_18_24, age_25_34, age_35_44, age_45_54, age_55_64, age_65_plus, male_18_24, male_25_34, male_35_44, male_45_54, male_55_64, male_65_plus, female_18_24, female_25_34, female_35_44, female_45_54, female_55_64, female_65_plus, country_code, report_date, edu_level_compulsory_school, edu_level_none_completed, edu_level_post_graduate_education, edu_level_university, high_income, middle_income, low_income, household_size_1, household_size_2, household_size_3, household_size_4, household_size_5, household_size_6, household_size_7, household_size_8, household_size_9, household_size_10plus, occupation_fulltimework, occupation_homemaker, occupation_parttimework, occupation_studies, occupation_unemployed, occupation_ownbusiness, occupation_retired, occupation_leaveofabsence, occupation_parentalleave

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

country* AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you check traffic data filtered for a particular country.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

display_limit* integer

The number of results returned.
The available range is between 1 and 5000.

display_offset* integer

This parameter lets you skip a specified number of results before sending a report.
The available range is between 0 and 10000.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/categories

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/categories?category=human_resources&country=AD&display_limit=10&display_offset=0&key=API_KEY

Response example

Copy code

domain_name;total_traffic;direct_traffic;referral_traffic;search_organic_traffic;search_paid_traffic;social_organic_traffic;social_paid_traffic;email_traffic;display_ad_traffic;facebook_traffic;youtube_traffic;pinterest_traffic;instagram_traffic;twitter_traffic;linkedin_traffic;vk_traffic;reddit_traffic;conversion_rate;unique_visitors;users_captured;hits;sum_time_on_site;bounce_rate;bounced_visits;male;female;age_18_24;age_25_34;age_35_44;age_45_54;age_55_64;age_65_plus;male_18_24;male_25_34;male_35_44;male_45_54;male_55_64;male_65_plus;female_18_24;female_25_34;female_35_44;female_45_54;female_55_64;female_65_plus;country_code;report_date;edu_level_compulsory_school;edu_level_none_completed;edu_level_post_graduate_education;edu_level_university;high_income;middle_income;low_income;household_size_1;household_size_2;household_size_3;household_size_4;household_size_5;household_size_6;household_size_7;household_size_8;household_size_9;household_size_10plus;occupation_fulltimework;occupation_homemaker;occupation_parttimework;occupation_studies;occupation_unemployed;occupation_ownbusiness;occupation_retired;occupation_leaveofabsence;occupation_parentalleave
indeed.com;18620;8895;4799;2314;1164;0;0;1448;0;0;0;0;0;0;0;0;0;0;4354;9;18620;3227310;0.1933404940923738;3600;0.6904243;0.3095757;0.13854091;0.440245;0.280537;0.08626355;0.037387528;0.017025983;0.1165225;0.42973304;0.3022957;0.0947516;0.03991004;0.016787117;0.18764697;0.4636891;0.23201019;0.06733328;0.031761743;0.017558709;AD;2024-05-01;0.46321455;0.028287446;0.06481984;0.44367817;0.09540161;0.26906815;0.63553023;0.13270919;0.24117084;0.21062046;0.20114355;0.11359197;0.055764776;0.023532264;0.011185012;0.005105663;0.0051762834;0.44627333;0.096521236;0.11800249;0.06955633;0.1457444;0.053702947;0.05277644;0.012711484;0.0047113504
infojobs.net;12255;4883;470;6902;0;0;0;0;0;0;0;0;0;0;0;0;0;0;3249;10;12255;4995433;0.17568339453284373;2153;0.47255313;0.52744687;0.121825345;0.198704;0.18024941;0.26109073;0.16946223;0.068668276;0.09757042;0.1800576;0.19133587;0.35632342;0.10440411;0.07030859;0.14355595;0.21540979;0.17031677;0.17576933;0.22774948;0.06719868;AD;2024-05-01;0.4222642;0.06806176;0.099780075;0.40989396;0.08514375;0.18916306;0.72569317;0.11057742;0.23279755;0.24123856;0.2188085;0.105420485;0.046711907;0.01582265;0.020637617;0.0028577473;0.005127562;0.44936696;0.078933805;0.13659433;0.08388851;0.12887864;0.05400014;0.054835368;0.005990631;0.0075116367
talent.com;11344;10762;0;582;0;0;0;0;0;0;0;0;0;0;0;0;0;0;5376;3;11344;491748;0.8210507757404796;9314;0.59908205;0.40091795;0.21866216;0.36950135;0.22723173;0.094769776;0.05660717;0.033227824;0.18062045;0.36101496;0.2679556;0.096590064;0.05834302;0.03547591;0.27550694;0.38218236;0.16637903;0.092049755;0.054013327;0.029868564;AD;2024-05-01;0.44721228;0.026538664;0.0708589;0.45539016;0.092996284;0.26712725;0.6398765;0.13362561;0.24576849;0.21572691;0.2016009;0.11097466;0.052452184;0.021651657;0.010267598;0.004069376;0.0038626108;0.48953587;0.07320335;0.12561338;0.06425159;0.14529955;0.04686932;0.035852566;0.0135047445;0.0058696205
jooble.org;7797;4657;0;3140;0;0;0;0;0;0;0;0;0;0;0;0;0;0;4587;3;7797;1532153;0.4027189944850584;3140;0.575606;0.424394;0.23094493;0.33544725;0.23164774;0.112225376;0.05243293;0.03730176;0.17793651;0.34440866;0.2694976;0.11594807;0.053835746;0.038373403;0.3028403;0.32329288;0.18031195;0.10717629;0.050530285;0.035848293;AD;2024-05-01;0.43562716;0.028328264;0.07413586;0.4619087;0.08154843;0.25998673;0.65846485;0.13059273;0.24809307;0.22620025;0.19144984;0.11593379;0.050383914;0.020860901;0.010215381;0.0030489147;0.0032212143;0.44472128;0.08041625;0.13549943;0.06241533;0.16349958;0.057664484;0.038218208;0.012359119;0.0052063214
aon.com;4657;4657;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;;4443;1;4657;3399610;0;0;0.5394046;0.46059543;0.18130739;0.23552234;0.18804021;0.16795506;0.122363344;0.104811646;0.16266276;0.22513756;0.19159412;0.17821305;0.12986456;0.11252795;0.20314218;0.247684;0.18387821;0.1559419;0.11357865;0.09577505;AD;2024-05-01;0.44178998;0.021962438;0.07029041;0.46595716;0.099866554;0.3134804;0.58665305;0.1315256;0.25349978;0.20105638;0.20502754;0.10915429;0.053633045;0.024142027;0.011836823;0.006733796;0.0033907292;0.5324836;0.06662056;0.12836519;0.038454257;0.12428271;0.049814787;0.04584761;0.010400984;0.003730298
adecco.es;3957;235;0;3722;0;0;0;0;0;0;0;0;0;0;0;0;0;0;438;4;3957;1879656;0.4561536517563811;1805;0.38323218;0.6167678;0.12781385;0.19682199;0.21795592;0.25770178;0.12892464;0.07078184;0.102207534;0.20278989;0.21081077;0.26834205;0.12357837;0.09227138;0.14372447;0.1931138;0.2223956;0.25109038;0.13224657;0.05742919;AD;2024-05-01;0.4660022;0.14577962;0.05366857;0.3345496;0.044061877;0.12622423;0.8297139;0.128516;0.19638997;0.18299688;0.23775841;0.14284365;0.02642158;0.026844325;0.049333017;0.00021949699;0.008676654;0.46151227;0.061350048;0.13186538;0.06722816;0.21001422;0.039487466;0.009885519;0.0015177216;0.0171392
turijobs.com;3464;1732;1732;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;866;1;3464;199180;0;0;0.36778396;0.63221604;0.12056128;0.18266086;0.22542875;0.26411936;0.1341691;0.07306067;0.0993372;0.18723546;0.21380116;0.2758543;0.13071483;0.09305706;0.13290814;0.17999963;0.23219295;0.2572927;0.13617858;0.061428014;AD;2024-05-01;0.45911512;0.18992087;0.08119924;0.26976475;0.022469737;0.09809706;0.8794332;0.13598533;0.18234913;0.1878126;0.23054896;0.13293841;0.046812017;0.035159223;0.048394334;0;0;0.49537557;0.05986892;0.14855115;0.10627187;0.15334198;0.011671749;0.02491877;0;0
kenjo.io;3140;1570;0;1570;0;0;0;0;0;0;0;0;0;0;0;0;0;0;72;1;3140;4650340;0;0;0.4404585;0.55954146;0.22112024;0.2819608;0.20283222;0.1663323;0.080442816;0.04731166;0.20176557;0.27887455;0.21378396;0.16377574;0.08858632;0.053213846;0.23635578;0.28439018;0.19421124;0.16834477;0.07403243;0.042665593;AD;2024-05-01;0.3713264;0.028212195;0.062022995;0.53843844;0.13384849;0.3036763;0.5624752;0.119396456;0.2665276;0.22282262;0.20630993;0.09847175;0.049523752;0.01543429;0.01635225;0.00020699651;0.0049543707;0.54565156;0.055217758;0.103966795;0.06870191;0.13623753;0.05114712;0.029196141;0.0054056183;0.0044755614
computrabajo.com;2152;582;0;0;0;0;0;1570;0;0;0;0;0;0;0;0;0;0;139;2;2152;271610;0.2704460966542751;582;0.34020233;0.65979767;0.34514105;0.27978995;0.17209257;0.10143621;0.06758106;0.033959158;0.24979822;0.3250174;0.20908183;0.122596554;0.05827593;0.03523007;0.39430135;0.25646996;0.15302032;0.0905256;0.07237893;0.033303857;AD;2024-05-01;0.32349038;0.05704918;0.112980306;0.5064801;0.07973659;0.24636698;0.67389643;0.11955206;0.2654133;0.2259445;0.19862032;0.09244784;0.052982494;0.018513596;0.022373438;0.0016466526;0.002505794;0.4955939;0.06805943;0.10417991;0.07764906;0.1175599;0.07404584;0.052735355;0.002067584;0.008109019
bizneo.com;2152;0;0;1570;582;0;0;0;0;0;0;0;0;0;0;0;0;0;139;2;2152;2550372;0;0;0.3904227;0.6095773;0.23868452;0.23791587;0.19808576;0.18370324;0.092046455;0.04956415;0.19632258;0.25250188;0.2125796;0.18993694;0.09359366;0.055065364;0.26581654;0.22857381;0.18880273;0.17971067;0.091055505;0.046040725;AD;2024-05-01;0.44270617;0.08965031;0.07557125;0.3920723;0.05110808;0.1410692;0.8078227;0.07986425;0.18463854;0.20215055;0.24355632;0.13435541;0.05354324;0.02053828;0.07439755;0.0021635853;0.004792276;0.42842975;0.08894023;0.103262074;0.10344154;0.17202954;0.062374134;0.032930735;0.0051413686;0.003450627

Traffic Sources

Price: 1 API units per request

The Traffic Sources request lets you analyze website traffic sources from various channels. You can request data for direct, referral, search, social, email, and paid traffic, providing a comprehensive view of how visitors reach your competitors' websites.

About the Traffic Analytics Traffic Journey report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com, subdomain.example.com, exa…
example.com, subdomain.example.com, example.com/subfolder/

Root domain, subdomain, or subfolder.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop, mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 1000. The available range is between 1 and 5000.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0.
The available range is between 0 and 10000.

traffic_channel direct, referral, search, social, mail,…
direct, referral, search, social, mail, display_ad

This parameter lets you filter traffic sources by a specific channel type. If this parameter isn't specified, data for all traffic channels is shown by default.

traffic_type organic, paid

This parameter allows you to retrieve organic or paid traffic. If this parameter isn't specified, data for all traffic types is shown by default.

sort_order traffic, traffic_diff, traffic_share

This parameter lets you sort the data. For descending order, append _desc; for ascending order, append _asc. If this parameter isn't specified, data is shown in descending order by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, from_target, display_date, coun…
target, from_target, display_date, country, device_type, traffic_share, traffic_diff, traffic channel, traffic_type, search_engine, prev_traffic, categories

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/sources

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/sources?target=medium.com&device_type=mobile&display_limit=5&display_offset=0&country=us&sort_order=traffic_diff&traffic_channel=referral&traffic_type=organic&display_date=2020-06-01&export_columns=target,from_target,display_date,country,traffic_share,traffic,channel&key=YOUR_API_KEY

Response example

Copy code

target;from_target;display_date;country;traffic_share;traffic;channel
medium.com;phlap.net;2020-06-01;US;0.00019134;7025;referral
medium.com;blackhatworld.com;2020-06-01;US;0.00006379;2342;referral
medium.com;crunchyroll.com;2020-06-01;US;0.00005102;1873;referral
medium.com;outline.com;2020-06-01;US;0.00005102;1873;referral
medium.com;uber.com;2020-06-01;US;0.00005102;1873;referral

Traffic Destinations

Price: 1 API units per request

The Traffic Destinations report provides a list of websites visited by users after leaving your competitors' domains. This helps you understand the online journey of your market audience.

About the Traffic Analytics Traffic Journey report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com examp…
example.com subdomain.example.com example.com/subfolder/

Root domain, subdomain, or subfolder.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 1000. The available range is between 1 and 5000.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0. There is no range for the parameter.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target display_date country device_type…
target display_date country device_type to_target traffic_share traffic prev_traffic categories

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

sort_order traffic traffic_diff traffic_share

This parameter lets you sort the data. For descending order, append _desc; for ascending order, append _asc. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/destinations

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/destinations?target=mail.ru&device_type=desktop&display_limit=5&display_offset=0&country=us&export_columns=target,display_date,country,device_type,to_target,traffic_share,traffic&display_date=2020-06-01&key=YOUR_API_KEY

Response example

Copy code

target;display_date;country;device_type;to_target;traffic_share;traffic
mail.ru;2020-06-01;US;desktop;ok.ru;0.14817627;237336
mail.ru;2020-06-01;US;desktop;turkishairlines.com;0.07261596;116310
mail.ru;2020-06-01;US;desktop;airastana.com;0.05397156;86447
mail.ru;2020-06-01;US;desktop;vazhno.ru;0.02943909;47153
mail.ru;2020-06-01;US;desktop;belavia.by;0.0206073;33007

Geo Distribution

Price: 1 API units per request

The Geo Distribution report provides a list of countries where traffic to your selected domains comes from. This data lets you gain insights into the geographic diversity and distribution of your market audience.

About the Traffic Analytics Geo Distribution report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com examp…
example.com subdomain.example.com example.com/subfolder/

Root domain, subdomain, or subfolder.

target_type domain subdomain subfolder

Type of the analyzed target. If this parameter isn't specified, the default value is domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 1000. The available range is between 1 and 5000.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0. There is no range for the parameter.

geo_type country subcontinent continent

Type of geographical coverage. If this parameter isn't specified, the country data is shown by default.

export_columns target display_date device_type geo tra…
target display_date device_type geo traffic global_traffic traffic_share users avg_visit_duration bounce_rate pages_per_visit desktop_share mobile_share

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

sort_order traffic traffic_share desktop_share mob…
traffic traffic_share desktop_share mobile_share avg_visit_duration pages_per_visit bounce_rate

This parameter lets you sort the data. For descending order, append _desc; for ascending order, append _asc. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/geo

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/geo?display_date=2020-01-01&device_type=desktop&display_limit=7&display_offset=0&target=ebay.com&target_type=domain&geo_type=country&export_columns=target,display_date,device_type,geo,traffic,avg_visit_duration&key=YOUR_API_KEY

Response example

Copy code

target;display_date;device_type;geo;traffic;avg_visit_duration
ebay.com;2020-01-01;desktop;us;192581931;706
ebay.com;2020-01-01;desktop;ru;7305169;970
ebay.com;2020-01-01;desktop;ca;6392463;819
ebay.com;2020-01-01;desktop;il;5099407;1048
ebay.com;2020-01-01;desktop;mx;4277849;669
ebay.com;2020-01-01;desktop;br;3811888;711
ebay.com;2020-01-01;desktop;gb;3641529;384

Subdomains

Price: 1 API units per request

The Subdomains report displays the traffic to the top subdomains of the selected website. This helps you identify the most popular sections of the website.

About the Traffic Analytics Subdomains report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com

Root domain or subdomain.

target_type domain subdomain

Type of the analyzed target. If this parameter isn't specified, the default value is domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 1000. The available range is between 1 and 5000.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0.
There is no range for the parameter.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns domain display_date country device_type…
domain display_date country device_type target_type subdomain traffic_share desktop_share mobile_share total_visits desktop_visits mobile_visits total_users desktop_users mobile_users

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

sort_order traffic desktop_share mobile_share

This parameter lets you sort the data. For descending order, append _desc; for ascending order, append _asc. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/subdomains

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/subdomains?target=amazon.com&export_columns=domain,display_date,subdomain&country=us&display_date=2019-07-01&device_type=desktop&display_limit=3&display_offset=3&key=YOUR_API_KEY

Response example

Copy code

domain;display_date;subdomain
amazon.com;2019-07-01;twitch.amazon.com
amazon.com;2019-07-01;sellercentral.amazon.com
amazon.com;2019-07-01;aws.amazon.com

Top Pages

Price: 1 API units per request

The Top Pages report displays the most popular pages of the chosen domains. This helps you understand which content resonates the most with your market audience.

About the Traffic Analytics Top Pages report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* domain.com

Root domain.

target_type domain subdomain subfolder

Type of the analyzed target. If this parameter isn't specified, the default value is domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 1000. The available range is between 1 and 5000.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0.
There is no range for the parameter.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, device_type, country, display_d…
target, device_type, country, display_date, page, traffic_share, desktop_share, mobile_share, users_by_target, traffic, avg_visit_duration, exits, entrance_traffic, direct, search (deprecated), referral, social (deprecated), paid (deprecated), unknown (deprecated), search_organic search_paid social_organic social_paid mail display_ad

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

sort_order users_by_target avg_visit_duration exit…
users_by_target avg_visit_duration exits traffic entrance_traffic traffic_share

This parameter lets you sort the data. For descending order, append _desc; for ascending order, append _asc. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/toppages

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/toppages?device_type=desktop&display_date=2020-06-01&country=us&display_limit=5&display_offset=0&target=amazon.com&target_type=domain&export_columns=page,display_date,desktop_share,mobile_share&key=YOUR_API_KEY

Response example

Copy code

page;display_date;desktop_share;mobile_share
amazon.com/s;2020-06-01;1;0
amazon.com;2020-06-01;0.2545288066748602;0.7454711933251398
amazon.com/gp/css/order-history;2020-06-01;1;0
amazon.com/s/ref=nb_sb_noss_2;2020-06-01;1;0
amazon.com/gp/product/handle-buy-box/ref=dp_start-bbf_1_glance;2020-06-01;1;0

Traffic Rank

Price: 1 API units per request

The Traffic Rank report provides a list of domains sorted by traffic in descending order. This lets you benchmark your site against other domains to understand your relative market position, identify key competitors, and develop strategies to improve your site's visibility and traffic.

About the Market Explorer All Domains report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 200. The available range is between 1 and 200.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0. There is no range for the parameter.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns display_date country device_type rank d…
display_date country device_type rank domain visits users desktop_share mobile_share desktop_visits mobile_visits time_on_site bounce_rate pages_per_visit

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/rank

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/rank?device_type=mobile&display_date=2020-05-01&country=us&display_limit=5&display_offset=0&export_columns=rank,domain&key=YOUR_API_KEY

Response example

Copy code

rank;domain
1;google.com
2;facebook.com
3;wikipedia.org
4;amazon.com
5;yahoo.com

Audience Insights

Price: 1 API units per request

The Audience Insights report provides data to better understand how audiences among your chosen domains overlap. This data can help you with targeting, segmentation, and ad placement.

About the One2Target Audience Overlap report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

targets* domain1.com, domain2.com, domain3.com

Array of domains separated by a comma. The maximum number of domains is 5.

selected_targets* domain1.com, domain2.com

Array of domains separated by a comma.
Indicate the domains from the targets parameter that you'd like to apply the segment operator to. The maximum number of domains depends on the number of domains in targets (up to 5).

segment contains excludes shares

An operator that regulates the relationship between targets and selected_targets:

Contains unites the audience of the selected websites.

Shares combines the audience who visited all the selected websites.

Excludes selects the audience who visited at least one of the targets websites, but didn't visit any websites from selected_targets.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 1000. The available range is between 1 and 5000.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0. There is no range for the parameter.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target overlap_score similarity_score t…
target overlap_score similarity_score target_users overlap_users categories is_adult

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/audience_insights

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/audience_insights?display_date=2020-02-01&device_type=desktop&country=us&segment=contains&targets=amazon.com,ebay.com,searchenginesland.com&selected_targets=amazon.com,ebay.com&export_columns=target,overlap_score,similarity_score,target_users,overlap_users&display_offset=5&display_limit=7&key=YOUR_API_KEY

Response example

Copy code

target;overlap_score;similarity_score;target_users;overlap_users
instagram.com;0.3688;0.4891;69429930;50399700
reddit.com;0.3467;0.4515;73201944;47379108
twitter.com;0.3467;0.4587;69915496;47372776
ebay.com;0.2448;0.3933;33448824;33448824
imdb.com;0.239;0.3621;43723270;32654776
apple.com;0.2326;0.3496;45222470;31789886
yahoo.com;0.2221;0.3242;50563124;30347980

Data Accuracy

Price: 1 API units per request

The Data Accuracy report displays a metric that gauges the accuracy of the data presented. This lets you assess the reliability of the insights derived from the data and ensure that your strategies are built on precise and dependable information.

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* domain.com

Root domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target display_date country device_type…
target display_date country device_type accuracy

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/accuracy

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/accuracy?display_date=2019-01-01&target=ebay.com&country=us&device_type=desktop&export_columns=target,display_date,country,device_type,accuracy&key=YOUR_API_KEY

Response example

Copy code

target;display_date;country;device_type;accuracy
ebay.com;2019-01-01;US;desktop;3

Subfolders

Price: 1 API units per request

The Subfolders report lists the top subfolders of your chosen domains. This helps you identify the most visited sections of their websites so you can understand user navigation patterns.

About the Traffic Analytics Subfolders report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com, subdomain.example.com

Root domain or subdomain.

target_type domain, subdomain

Type of the analyzed target. If this parameter isn't specified, the default value is domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

display_limit integer

Number of results to return. If this parameter isn't specified, the default value is 1000. The available range is between 1 and 5000.

display_offset integer

This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is 0.
There is no range for the parameter.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns display_date, subfolder, subdomain, tra…
display_date, subfolder, subdomain, traffic_share, users, unique_pageviews, entrances, exits, time_on_subfolder, pages_per_visit, bounce_rate, direct, search (deprecated), referral, social (deprecated), paid (deprecated), search_organic, search_paid, social_organic, social_paid, mail, display_ad

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

search_string string

This filter lets you get data for subfolders that contain the specified search term in their path.

sort_order traffic_share unique_pageviews users en…
traffic_share unique_pageviews users entrances exits time_on_subfolder pages_per_visit bounce_rate direct search referral social paid search_organic search_paid social_organic social_paid mail display_ad

This parameter lets you sort the data. For descending order, append _desc; for ascending order, append _asc. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/subfolders

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/subfolders?target=amazon.com&target_type=domain&display_limit=5&sort_order=unique_pageviews_desc&export_columns=users,unique_pageviews,entrances,exits&key=YOUR_API_KEY

Response example

Copy code

users;unique_pageviews;entrances;exits
108034494;442718812;139391428;214631237
117317596;400357027;88809293;119252855
57876899;181880099;26825058;41811998
59238134;160586116;27531044;30810362
46792998;150398115;21906685;36809256

Age and Sex Distribution

Price: 1 API units per request

The Age and Sex Distribution report provides data on the age and sex distribution for your chosen domain's audiences. This data helps you better understand the market's demographics and enhance your segmentation and targeting.

About the One2Target Demographics report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com

Root domain or subdomain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, display_date, country, device_t…
target, display_date, country, device_type, age, female_users, male_users, female_share, male_share

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/age_and_sex_distribution

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/age_and_sex_distribution?target=amazon.com&export_columns=age,female_users,male_users,female_share,male_share&key=YOUR_API_KEY

Response example

Copy code

age;female_users;male_users;female_share;male_share
18-24;44327990;97168741;0.04749;0.1041
25-34;122735052;269057548;0.13149;0.28825
35-44;73095910;160239759;0.07831;0.17167
45-54;36337936;79667169;0.03893;0.08535
55-64;12013080;26341037;0.01287;0.02822
65+;3892350;8531434;0.00417;0.00914

Household Distribution

Price: 1 API units per request

The Household Distribution report provides data on the distribution of the chosen domain's audiences by household size. This data helps you better understand the market's household demographics and enhance your segmentation and targeting.

About the One2Target Socioeconomics report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com

Root domain or subdomain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, display_date, country, device_t…
target, display_date, country, device_type, size, users, users_share

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/household_distribution

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/household_distribution?target=amazon.com&export_columns=size,users,users_share&key=YOUR_API_KEY

Response example

Copy code

size;users;users_share
1;119159479;0.12765938
2;216755165;0.23221678
3;196100018;0.21008825
4;188666644;0.20212464
5;111846800;0.11982507
6;55039594;0.058965687
7;23824865;0.025524344
8;11369735;0.012180763
9;5235293;0.0056087384
10+;5419740;0.005806342

Income Distribution

Price: 1 API units per request

The Income Distribution report provides data on the distribution of the chosen domain's audiences by income. This data helps you better understand the socioeconomic diversity of your market and tailor your messaging, promotions, and offers.

About the One2Target Socioeconomics report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com

Root domain or subdomain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, display_date, country, device_t…
target, display_date, country, device_type, income_type, users, users_share

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/income_distribution

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/income_distribution?target=amazon.com&export_columns=income_type,users,users_share&key=YOUR_API_KEY

Response example

Copy code

income_type;users;users_share
high;78982046;0.084616005
middle;236143146;0.25298774
low;618292149;0.66239625

Education Distribution

Price: 1 API units per request

The Education Distribution report provides data on the distribution of the chosen domain's audiences by education level. This data helps you understand their educational background, so you can tailor content and marketing strategies to better resonate with different education levels.

About the One2Target Socioeconomics report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com

Root domain or subdomain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, display_date, country, device_t…
target, display_date, country, device_type, education, users, users_share

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/education_distribution

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/education_distribution?target=amazon.com&export_columns=education,users,users_share&key=YOUR_API_KEY

Response example

Copy code

education;users;users_share
none_completed;31115401;0.03333493
school;467949632;0.5013295
university;383657211;0.4110243
postgraduate;50695096;0.054311287

Occupation Distribution

Price: 1 API units per request

The Occupation Distribution report provides data on the distribution of the chosen domain's audiences by occupation. This data lets you gain insights into the professional makeup of your audience so you can develop more targeted marketing strategies and create content that appeals to specific professional groups.

About the One2Target Socioeconomics report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com subdomain.example.com

Root domain or subdomain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, display_date, country, device_t…
target, display_date, country, device_type, occupation, users, users_share

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/occupation_distribution

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/occupation_distribution?target=amazon.com&export_columns=occupation,users,users_share&key=YOUR_API_KEY

Response example

Copy code

occupation;users;users_share
unemployed;142362045;0.15251704
parental_leave;4634344;0.0049649226
leave_of_absence;12847917;0.013764387
studies;65785665;0.0704783
part_time_work;110365158;0.11823774
full_time_work;398638431;0.42707416
homemaker;99072807;0.10613988
own_business;46837581;0.050178606
retired;52873389;0.05664496

Audience Interests

Price: 1 API units per request

The Audience Interests report provides data to better understand the interests of your market audience. This helps you tailor your content and marketing strategies to match their preferences and engage them more effectively.

About the One2Target Behavior report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com

Root domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop, mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, display_date, country, device_t…
target, display_date, country, device_type, category, users, users_score

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/audience_interests

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/audience_interests?target=amazon.com&export_columns=category,users,users_score&key=YOUR_API_KEY

Response example

Copy code

category;users;users_score
online_services;921033121;0.9867154258825707
mass_media;917265402;0.9826790167970272
publishing;887132366;0.9503970816831272
newspapers;814880850;0.8729930407695959
retail;772807972;0.8279197890185599
computer_software_and_development;698535570;0.7483507451917946
entertainment;658906903;0.7058960102376283
information_technology;653199899;0.6997820185103172

Social Media

Price: 1 API units per request

The Social Media report provides social media data of the chosen domain's audiences. This lets you analyze their engagement and activity on various social platforms. This data can help you optimize your social media strategies and improve your online presence.

About the One2Target Behavior report ›

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

target* example.com

Root domain.

display_date YYYY-MM-01

Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default.

The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.

device_type desktop, mobile

This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.

country AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,…
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default.

To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.

export_columns target, device_type, display_date, coun…
target, device_type, display_date, country, social_name, social_domain, users_score, users

This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

https://api.semrush.com/analytics/ta/api/v3/social_media

Request example

Copy code

https://api.semrush.com/analytics/ta/api/v3/social_media?target=amazon.com&export_columns=social_name,social_domain,users_score,users

Response example

Copy code

social_name;social_domain;users_score;users
YouTube;youtube.com;0.7474810387808435;697723757
Facebook;facebook.com;0.44912889370340137;419231904
Twitter;twitter.com;0.3635169623127236;339318869
Reddit;reddit.com;0.36153091057319436;337465022
Instagram;instagram.com;0.2945165976739555;274911625
TikTok;tiktok.com;0.20150881125651102;188095052
LinkedIn;linkedin.com;0.1261642745655982;117765946
Pinterest;pinterest.com;0.1086957264671911;101460220

API Usage

The API Usage request returns information about your monthly, daily, and hourly API units usage. This helps you monitor and optimize your API consumption.

Request parameters
Name Value/Type Description
key* API_KEY

Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

Copy code

http://api.semrush.com/analytics/ta/limits/key/

Request example

Copy code

http://api.semrush.com/analytics/ta/limits/key/API_KEY
Was this page helpful?