Semrush Developers

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	2020-06-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.
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)

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

Request example

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

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

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	2023-05-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)

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

Request example

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

Response example

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

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 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	2023-05-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)

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

Request example

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

Response example

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

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	2023-05-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)

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

Request example

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

Response example

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

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*	human_resources	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	2023-05-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 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.
display_limit	integer	The number of results returned. If the parameter isn't specified, the default value will be `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 the parameter isn't specified, the default value will be `0`. The available range is between `0` and `10000`.

* Fields marked by an asterisk (*) are required

Endpoint (GET)

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

Request example

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

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

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	2020-06-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.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-07-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.
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)

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

Request example

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

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

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	2020-06-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.
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)

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

Request example

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

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

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	2020-07-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2021-01-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.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
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)

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

Request example

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

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

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	2020-06-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.
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)

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

Request example

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

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

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	2020-06-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.
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)

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

Request example

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

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

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	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data for the last report is shown by default.
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)

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

Request example

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

Response example

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

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)

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

Request example

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

.Trends API reference

Traffic Summary

Request parameters

Daily Traffic

Request parameters

Weekly Traffic

Request parameters

Purchase Conversion

Request parameters

Industry Categories

Request parameters

Traffic Sources

Request parameters

Traffic Destinations

Request parameters

Geo Distribution

Request parameters

Subdomains

Request parameters

Top Pages

Request parameters

Traffic Rank

Request parameters

Audience Insights

Request parameters

Data Accuracy

Request parameters

Subfolders

Request parameters

Age and Sex Distribution

Request parameters

Household Distribution

Request parameters

Income Distribution

Request parameters

Education Distribution

Request parameters

Occupation Distribution

Request parameters

Audience Interests

Request parameters

Social Media

Request parameters

API Usage

Request parameters