Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Need help?
Telephone
United States
United States
Canada
United Kingdom
Spain
France
Italy
Germany
Australia
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
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.
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 |
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)
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
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.
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 |
target_type | domain, subdomain, subfolder | Type of the analyzed target. If this parameter isn't specified, the default value is |
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 |
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)
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
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.
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 The minimum value is |
target_type | domain, subdomain, subfolder | Type of the analyzed target. If this parameter isn't specified, the default value is |
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 |
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)
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
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.
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 |
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)
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
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.
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, 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 |
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 |
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 |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
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.
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 |
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 |
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 |
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 |
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)
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
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.
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 |
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 |
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 |
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 |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
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.
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 |
display_date | 2020-06-01 | Date in the |
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 |
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 |
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 |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
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.
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 |
display_date | 2020-07-01 | Date in the |
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 |
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 |
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 |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
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.
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 |
display_date | 2020-06-01 | Date in the |
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 |
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 |
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 |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
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.
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 |
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 |
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 |
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)
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
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.
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 |
selected_targets | domain1.com, domain2.com | Array of domains separated by a comma. |
segment | contains excludes shares | An operator that regulates the relationship between 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 |
display_date | 2020-06-01 | Date in the |
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 |
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 |
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)
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
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.
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 |
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)
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
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.
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 |
display_date | 2021-01-01 | Date in the |
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 |
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 |
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 |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
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.
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 |
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)
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
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.
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 |
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)
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
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.
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 |
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)
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
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.
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 |
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)
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
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.
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 |
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)
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
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.
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 |
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)
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
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.
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 |
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)
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.
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)
Request example
http://api.semrush.com/analytics/ta/limits/key/API_KEY