Trends API reference
Jump to Traffic SummaryTraffic Summary
Price: 1 API units per line
The Traffic Summary method provides estimated traffic metrics for domains of your choice. You can request data for traffic rank, visits, unique visitors, pages per visit, average visit duration, and bounce rate. About the Traffic Analytics dashboard ›
If a response is empty, no API units will be deducted. If you request data for several domains and only get data for some of them, you’d be charged only for the data returned.
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetsRequired
Array of domains, subdomains, and subfolders separated by commas. The maximum number of targets is 200.
Value/Type: example1.com, subdomain.example2.com, example3.com/subfolder/
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop mobile
country
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.
Value/Type: 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
export_columns
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, the default columns will be sent (target, rank, visits, desktop_visits, mobile_visits, users, desktop_users, mobile_users).
Value/Type: target, rank, visits, categories, desktop_visits, mobile_visits, users, desktop_users, mobile_users, direct, referral, social, search, paid, search_organic, search_paid, social_organic, social_paid, mail, display_ad, ai_assistants, ai_search, unknown_channel, 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, desktop_hits, mobile_hits
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_KEYtarget;visits;users
golang.org;4491179;1400453
blog.golang.org;402104;204891
tour.golang.org/welcome/;10131;11628Jump to Daily TrafficDaily Traffic
Price: 1 API units per request
The Daily Traffic report provides a day-by-day breakdown of traffic to your selected domains. This detailed view lets you monitor daily fluctuations, identify trends, and quickly respond to changes in user behavior.
If a response is empty, no API units will be deducted.
About the Traffic Analytics dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example1.com, subdomain.example2.com, example3.com/subfolder/
display_date
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.
Value/Type: YYYY-MM-01
target_type
Type of the analyzed target. If this parameter isn’t specified, the default value is domain.
Value/Type: domain, subdomain, subfolder
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
include_forecasted_items
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.
Value/Type: boolean
export_columns
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.
Value/Type: display_date, country, device_type, target, rank, visits, users, hits, direct, search_organic, search_paid, social_organic, social_paid, referral, mail, display_ad, ai_assistants, ai_search, time_on_site, pages_per_visit, bounce_rate, desktop_share, mobile_share, is_forecasted
https://api.semrush.com/analytics/ta/api/v3/summary_by_day?key=YOUR_API_KEY&target=amazon.comdisplay_date;country;device_type;target;rank;visits;users;hits;direct;search_organic;search_paid;social_organic;social_paid;referral;mail;display_ad;ai_assistants;ai_search;time_on_site;pages_per_visit;bounce_rate;desktop_share;mobile_share;is_forecasted
2025-08-31;GLOBAL;all;amazon.com;0;81503642;55980389;531755802;60439536;12542552;98247;1616270;20466;6151430;517794;33213;80826;3308;678;6.5243;0.4349;0.38861737;0.61138263;false
2025-08-30;GLOBAL;all;amazon.com;0;83479974;56721688;578403597;62383146;12662038;52476;1556629;25431;6278725;413136;25319;82365;709;687;6.9287;0.424;0.39057638;0.60942362;false
2025-08-29;GLOBAL;all;amazon.com;0;89151759;59685027;613598166;67227562;12724719;82402;1503120;25512;6907341;575260;4171;99601;2071;712;6.8826;0.4149;0.44174532;0.55825468;false
2025-08-28;GLOBAL;all;amazon.com;0;88621634;59201523;601545588;66649190;13053389;69802;1708036;45990;6450360;544503;8668;90710;986;708;6.7878;0.4121;0.45507794;0.54492206;false
2025-08-27;GLOBAL;all;amazon.com;0;89950167;61088453;607527314;67372885;13045385;64901;1820955;38158;6886373;571725;53818;93941;2026;705;6.754;0.4172;0.46149977;0.53850023;false
2025-08-26;GLOBAL;all;amazon.com;0;92361904;62464797;633819507;69116484;13898656;96299;1720722;54683;6775962;591644;7215;99723;516;702;6.8623;0.4092;0.45991019;0.54008981;false
2025-08-25;GLOBAL;all;amazon.com;0;95139436;63386128;653658940;71757985;13611162;82553;1876870;25261;7028181;625381;26618;103760;1665;690;6.8705;0.4029;0.4574611;0.5425389;false
2025-08-24;GLOBAL;all;amazon.com;0;83698534;57214552;582407852;62414346;12754345;104102;1702855;25499;6033803;563552;17335;80781;1916;691;6.9584;0.4107;0.40384407;0.59615593;false
2025-08-23;GLOBAL;all;amazon.com;0;83319172;56806562;581495685;61778578;13100137;72880;1586460;36291;6034730;592697;49130;67422;847;705;6.9791;0.4195;0.39347183;0.60652817;false
2025-08-22;GLOBAL;all;amazon.com;0;88903419;59787939;610780014;66744976;12615637;125765;1577546;27936;7187853;530309;5202;87501;694;705;6.8702;0.4166;0.44145066;0.55854934;false
2025-08-21;GLOBAL;all;amazon.com;0;88261596;59490783;615585921;65640794;13032947;84105;1624031;31191;7129625;590516;29777;97329;1281;702;6.9746;0.4017;0.47911361;0.52088639;false
2025-08-20;GLOBAL;all;amazon.com;0;89255366;59950043;612660556;66249316;13265373;108565;1848025;20316;7001120;624090;30087;106933;1541;710;6.8641;0.4049;0.48505367;0.51494633;false
2025-08-19;GLOBAL;all;amazon.com;0;89895056;59767940;627621991;66468433;13368508;137202;1807638;25518;7301460;648212;40189;96659;1237;715;6.9817;0.4058;0.47006113;0.52993887;false
2025-08-18;GLOBAL;all;amazon.com;0;90618660;60125357;634278950;67945233;13128625;98621;1533150;26892;7057425;723184;4469;99265;1796;734;6.9994;0.4018;0.47589065;0.52410935;false
2025-08-17;GLOBAL;all;amazon.com;0;79516055;54022747;556734472;58545658;12347495;80371;1633346;42022;6277636;480268;17632;90054;1573;722;7.0015;0.4144;0.41475303;0.58524697;false
2025-08-16;GLOBAL;all;amazon.com;0;77120655;52731616;537429981;57422623;11738439;91293;1481836;25895;5801831;485634;8750;63187;1167;715;6.9687;0.4242;0.41023879;0.58976121;false
2025-08-15;GLOBAL;all;amazon.com;0;83281747;55950182;578054033;62269586;12267904;96247;1546998;23983;6378829;593144;26666;76164;2226;722;6.9409;0.4154;0.45587826;0.54412174;false
2025-08-14;GLOBAL;all;amazon.com;0;87304832;58524008;618918814;65021595;12989631;97335;1744599;29085;6706828;597064;24718;92116;1861;727;7.0892;0.4151;0.47414116;0.52585884;false
2025-08-13;GLOBAL;all;amazon.com;0;89683898;59412606;622943440;67216988;12962154;91213;1815908;22886;6763983;636010;72716;99623;2417;719;6.946;0.4058;0.47967085;0.52032915;false
2025-08-12;GLOBAL;all;amazon.com;0;88529295;58946739;630117213;65814769;13442780;80638;1610817;27808;6798531;609457;55526;87152;1817;731;7.1176;0.4115;0.47008145;0.52991855;false
2025-08-11;GLOBAL;all;amazon.com;0;95090622;63053029;673499383;70891736;14532695;97648;1723681;29030;6992594;640387;76875;103611;2365;724;7.0827;0.4059;0.46369791;0.53630209;false
2025-08-10;GLOBAL;all;amazon.com;0;84688670;58086363;574347307;62101113;13730591;86875;1801362;40980;6261259;530423;65770;67345;2952;700;6.7819;0.4293;0.40067211;0.59932789;false
2025-08-09;GLOBAL;all;amazon.com;0;78939371;54223066;535974381;58017810;12571845;62018;1613117;19115;6084515;482129;13962;74005;855;714;6.7897;0.423;0.41643622;0.58356378;false
2025-08-08;GLOBAL;all;amazon.com;0;86082806;58163627;566892995;64644938;12944947;77614;1454681;22266;6246143;575801;19659;94123;2634;719;6.5854;0.4162;0.46238095;0.53761905;false
2025-08-07;GLOBAL;all;amazon.com;0;90468605;60956722;614690618;68040707;13291923;81662;1513441;20642;6829550;583253;10826;94729;1872;722;6.7945;0.4149;0.46443143;0.53556857;false
2025-08-06;GLOBAL;all;amazon.com;0;90794091;61061773;632660510;67568023;13583605;96520;1748096;32803;7054655;584659;27061;96483;2186;718;6.9681;0.4062;0.47179112;0.52820888;false
2025-08-05;GLOBAL;all;amazon.com;0;99237378;65690468;661872334;74221760;14725261;104466;1934686;23157;7438179;640885;44565;102359;2060;733;6.6696;0.4237;0.43868395;0.56131605;false
2025-08-04;GLOBAL;all;amazon.com;0;101348260;67571672;671519970;76134852;15019140;122141;1774651;34511;7472625;646483;38213;102754;2890;719;6.6259;0.4218;0.43481306;0.56518694;false
2025-08-03;GLOBAL;all;amazon.com;0;78732662;54621657;523645260;58651819;12290523;92918;1614680;18841;5527113;456639;3594;75380;1155;722;6.6509;0.4264;0.42438011;0.57561989;false
2025-08-02;GLOBAL;all;amazon.com;0;78947566;53871900;528551921;58760598;12422909;104889;1478578;39303;5580765;469796;13388;75483;1857;705;6.695;0.43;0.41371611;0.58628389;false
2025-08-01;GLOBAL;all;amazon.com;0;84927191;57327283;550306510;64131217;12560489;90510;1455131;20524;5989642;584143;4733;89387;1415;715;6.4797;0.4208;0.44988158;0.55011842;falseJump to Weekly TrafficWeekly Traffic
Price: 1 API units per request
The Weekly Traffic report offers a week-by-week analysis of traffic to your chosen domains. By examining this data, you can understand broader trends, compare week-to-week performance, and make strategic decisions based on weekly traffic patterns.
If a response is empty, no API units will be deducted.
About the Traffic Analytics dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example1.com, subdomain.example2.com, example3.com/subfolder/
display_date
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.
Value/Type: YYYY-MM-01
target_type
Type of the analyzed target. If this parameter isn’t specified, the default value is domain.
Value/Type: domain, subdomain, subfolder
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
include_forecasted_items
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.
Value/Type: boolean
export_columns
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.
Value/Type: display_date, country, device_type, target, rank, visits, users, hits, direct, search_organic, search_paid, social_organic, social_paid, referral, mail, display_ad, ai_assistants, ai_search, time_on_site, pages_per_visit, bounce_rate, desktop_share, mobile_share, is_forecasted
https://api.semrush.com/analytics/ta/api/v3/summary_by_week?key=YOUR_API_KEY&target=amazon.comdisplay_date;country;device_type;target;rank;visits;users;hits;direct;search_organic;search_paid;social_organic;social_paid;referral;mail;display_ad;ai_assistants;ai_search;time_on_site;pages_per_visit;bounce_rate;desktop_share;mobile_share;is_forecasted
2025-08-25;GLOBAL;all;amazon.com;0;620227136;235565992;4220426790;464959224;91541309;546726;11802993;235502;46480533;3839504;159020;651043;11282;698;6.8046;0.416;0.43777211;0.56222789;false
2025-08-18;GLOBAL;all;amazon.com;0;615692483;231541315;4277798665;458712363;91473395;733284;11689206;194778;47810011;4252092;179953;638025;9376;709;6.9479;0.4084;0.45154267;0.54845733;false
2025-08-11;GLOBAL;all;amazon.com;0;603448377;225920810;4237659278;449648534;90470820;641958;11620293;200268;45880514;4077303;280660;614766;13261;723;7.0224;0.4128;0.45383129;0.54616871;false
2025-08-04;GLOBAL;all;amazon.com;0;631590511;240102236;4258167362;470748382;95874454;631379;11841015;193475;47390538;4043741;220060;632018;15449;718;6.742;0.4193;0.44188288;0.55811712;false
2025-07-28;GLOBAL;all;amazon.com;0;616725385;233061869;4165117586;460257172;92896328;597006;11644068;188534;46298996;4080618;81847;668804;12012;713;6.7536;0.417;0.44343993;0.55656007;falseJump to Purchase ConversionPurchase Conversion
Price: 1 API units per request
The Purchase Conversion report provides monthly conversion metrics for a domain in the CSV format, showing the percentage of sessions ending in a purchase. With this data, you can gain insights on your markets, prospects, or partners purchase conversions.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Traffic Analytics dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com
display_date
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.
Value/Type: YYYY-MM-01
device_typeRequired
The parameter specifies the type of device data to retrieve. Currently, only desktop is supported.
Value/Type: desktop
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, conversion
https://api.semrush.com/analytics/ta/api/v3/purchase_conversion?key=YOUR_API_KEY&target=amazon.com&device_type=desktoptarget;display_date;device_type;country;conversion
amazon.com;2024-06-01;desktop;GLOBAL;0.04269275Jump to Industry CategoriesIndustry Categories
Price: 500 API units per request
The Industry Categories report provides a list of all domains within specific industry categories. With this data, you can gain insights on domains that fit within unique industry categories to better understand their distinctive features and trends.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Market Overview dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
categoryRequired
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 Overview business categories.
Value/Type: CATEGORY_NAME
display_date
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.
Value/Type: YYYY-MM-01
export_columns
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.
Value/Type: 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, ai_assistants_traffic, ai_search_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
country
The country code parameter lets you check traffic data filtered for a particular country.
To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
Value/Type: 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
display_limit
The number of results returned.
The available range is between 1 and 5000.
Value/Type: integer
display_offset
This parameter lets you skip a specified number of results before sending a report.
The available range is between 0 and 10000.
Value/Type: integer
https://api.semrush.com/analytics/ta/api/v3/categories?category=human_resources&country=AD&display_limit=10&display_offset=0&key=API_KEYdomain_name;total_traffic;direct_traffic;referral_traffic;search_organic_traffic;search_paid_traffic;social_organic_traffic;social_paid_traffic;email_traffic;display_ad_traffic;ai_assistants_traffic;ai_search_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
infojobs.net;3747;3201;0;498;48;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;557;12;20481;950276;0.22471310381638646;842;0.5033082713007495;0.4966917286992505;0.0635540485940727;0.142916416216611;0.1012652292680893;0.2566300808505076;0.25628781157689673;0.1793464134938228;0.0712847416551473;0.12897934047830864;0.10474805003335315;0.23382559312495182;0.2596337406610193;0.20152853404721963;0.05989433237636434;0.15615021331937087;0.09740326281643148;0.2823971743323794;0.25069654187052776;0.1534584752849262;AD;2025-08-01;0.42662336511982984;0.06487720435191033;0.09207280850476009;0.4164266220234999;0.07984802921808809;0.352850719774797;0.5673012510071149;0.16398071093435498;0.2507384743911964;0.2202129667331927;0.1951549411979235;0.09105982719110839;0.04232530299380221;0.015299297481893865;0.0038049931340960966;0.004048653356321493;0.013374832586110481;0.44040491650672875;0.08157643826042447;0.13990237601605268;0.08158891265532577;0.13851179244726156;0.05003485721735259;0.05696950972146805;0.0049273478738728485;0.006083849301513037
cvdesignr.com;1274;1274;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;49;1;1274;0;1;1274;0.46861016353744733;0.5313898364625527;0.3034071882285763;0.2707381356571302;0.16189557216472006;0.1479203551948002;0.0711698422037523;0.04486890655102101;0.3439799067188099;0.25441948863788;0.15660062603124034;0.13358936098531915;0.06836528703778481;0.043045330588965605;0.2675501097640822;0.28562771481438504;0.16645309595338392;0.1607910695765916;0.07345732538724312;0.046120684504314155;AD;2025-08-01;0.5762435230338665;0.03540143766713938;0.02562836524729461;0.3627266740516996;0.042910629716934906;0.7461193741840678;0.2109699960989973;0.247675404178787;0.2588792013921167;0.20083771250129417;0.1470345174992567;0.07523370684304363;0.03839641132143269;0.016845840791283814;0.002826233815394279;0.003261624814149856;0.009009346843241074;0.4243147054582965;0.13213861229098606;0.11575031710629163;0.07273020512142787;0.17628079365912325;0.0456323940889464;0.01684269990212138;0.008472066478835704;0.007838205893971297
indeed.com;1216;495;180;403;138;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;600;14;14518;668975;0.14967105263157895;182;0.6292951177434405;0.3707048822565594;0.2656016377272692;0.28732510188705224;0.1771650529085293;0.13346406342569272;0.08711951682189917;0.049324627229557404;0.2701263738829902;0.27585049579139437;0.17119158526518974;0.1354612721526295;0.0930433093991276;0.05432696350866859;0.24740612750615548;0.30865343286502145;0.19851465136800253;0.13248302368271447;0.07223069404878607;0.04071207052931996;AD;2025-08-01;0.4242302805967677;0.026973789627145663;0.07459601087346358;0.47419991890262303;0.11468075071425525;0.40070322407727255;0.48461602520847225;0.15523985004485552;0.24944750753163458;0.21162015653223032;0.19092745612551548;0.10347687159988177;0.04941023568247514;0.02084222328778156;0.004326069040008701;0.004411620285104008;0.010298009870513046;0.4679428872865654;0.09190008083307716;0.11276591441783396;0.08221280909876659;0.13078269668460327;0.05064980189234081;0.047200818807942295;0.01262539569050028;0.003919595288370233
glassdoor.ca;636;501;45;45;0;0;0;45;0;0;0;0;0;0;0;0;0;0;0;0;96;2;4062;509721;0.2830188679245283;180;0.5251392705918101;0.4748607294081898;0.3046615357966952;0.2474786599997614;0.16168522973552044;0.1556435533413799;0.08366707470304806;0.04686394642359496;0.2815330222955453;0.24621740962438218;0.16272138181904888;0.16391169905950403;0.09189218205419523;0.05372430514732441;0.33042375152518727;0.24900222467418445;0.16054791637993462;0.14642341008774262;0.07444528581554274;0.03915741151740834;AD;2025-08-01;0.4094471961111117;0.023573686377725847;0.08658616525097831;0.4803929522601841;0.1109958935274771;0.44288758952859364;0.4461165169439293;0.14988550491778677;0.24814434512569508;0.21883546186323447;0.18480749574208366;0.10246602439308347;0.04796046956830963;0.029787907356343794;0.003657748453730852;0.004309220005747773;0.010145822573984626;0.4367370169924618;0.09638271446002007;0.12671431446125514;0.08841238776912161;0.11406576792966715;0.05539238703048021;0.05997762324400793;0.01888404761800403;0.0034337404949820747
factorialhr.com;375;141;188;0;0;46;0;0;0;0;0;0;0;0;0;0;46;0;0;0;140;3;2302;63309;0.248;93;0.4920220965899465;0.5079779034100534;0.22717154389445784;0.25608902704310416;0.16861914538763717;0.16699827413872506;0.10818330848198526;0.07293870105409046;0.21272165174655025;0.2316220544924215;0.16568699669505885;0.18184690749011323;0.12366098292356036;0.08446140665229582;0.24076324313797495;0.2779201835694135;0.1725283044297836;0.15293673297701024;0.09390003799731327;0.061951497888504486;AD;2025-08-01;0.4457685910196616;0.028076870184726287;0.05814025043072534;0.4680142883648868;0.08659899255555421;0.4015797651788751;0.5118212422655707;0.16338433628431925;0.2531827428292915;0.21092824398117618;0.1915884392412431;0.09533098448485573;0.04606259782234823;0.01994032932227698;0.002902592523303697;0.004683063185571419;0.011996670325613822;0.5200475757281263;0.07170349800615995;0.12439381017928362;0.051136200162883116;0.1346942006605446;0.05279103116413083;0.03090196613971962;0.00924923325597201;0.005082484703179977
francetravail.fr;318;144;0;174;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;82;2;4100;198796;0;0;0.4136635011396807;0.5863364988603192;0.2411175461360209;0.32103196862093386;0.15728277868110882;0.15596095765291815;0.07713276140663734;0.04747398750238097;0.22915885353861504;0.3007421050073759;0.16338340665413892;0.1657343243006457;0.08478042435528244;0.056200886143941864;0.24935651367405573;0.3354645507353286;0.1529176767573953;0.14886037570852478;0.07181638991518896;0.04158449320950648;AD;2025-08-01;0.3056058127807894;0.021164525868685356;0.10834098403162892;0.5648886773188964;0.1109560653471434;0.5987703065128911;0.29027362813996554;0.22480786504269948;0.2544628788910965;0.21880135864992348;0.16198301071625848;0.07393749237521968;0.0382525873699655;0.014871471700855307;0.002439916169911836;0.0031245607457367937;0.007318858338333152;0.4426049664724875;0.07604132360036227;0.14628764210017237;0.1281977913806472;0.11524891818027282;0.029873467239140465;0.04308291285807443;0.01637596889262957;0.0022870092762134926
myintegrho.com;293;247;0;46;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;254;6;882;32197;0.2901023890784983;85;0.40994627970571573;0.5900537202942842;0.06898071632835842;0.16774957674482324;0.11416856892438523;0.2636982552746355;0.22808390668558998;0.15731897604220776;0.07343740315492196;0.15438563296871366;0.11185627365839293;0.28888500360026154;0.2195874008040799;0.15184828581363013;0.07059658659613655;0.17516626997720522;0.1113195585363983;0.255450671166909;0.22861625379721465;0.15885065992613617;AD;2025-08-01;0.4472840947969054;0.02261106909591357;0.051339892143125204;0.47876494396405583;0.10207200053163629;0.2830590916818872;0.6148689077864765;0.1798024881873006;0.24050533790018364;0.18676303208725917;0.21398565446398538;0.08811050945571335;0.05278901525112475;0.024766414272166384;0.001014381601283406;0.006224483332043338;0.006038683448940163;0.4459139790702209;0.1044778630101066;0.10637365581029658;0.07718849290069088;0.12860307344636157;0.051583582475439566;0.06309864133402883;0.021301667925442722;0.0014590440274125942
connecteam.com;270;270;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;27;1;324;15444;0.9;243;0.5641231032912379;0.43587689670876206;0.26031536938971783;0.2559045832706064;0.1693169207418441;0.1581695670844328;0.09526551273743673;0.06102804677596211;0.25524101494122203;0.23783960518371292;0.1679234968281058;0.16946178522333222;0.10310538334531169;0.06642871447831514;0.26631134864303513;0.27514259083425613;0.17101762122866632;0.14477332243161284;0.08726778804584925;0.05548732881658023;AD;2025-08-01;0.4792007248538483;0.03314716550121466;0.06350127373440455;0.4241508359105326;0.10601800544707424;0.3696260867200422;0.5243559078328834;0.1401149044511755;0.2591599266831159;0.20590207317262113;0.18290033227311042;0.11007148588647447;0.05722173356482155;0.02377879228386986;0.004217889353599128;0.0058678011274791745;0.010765061203732721;0.45891546853575854;0.07692745513964461;0.1294813448609467;0.05464240090576149;0.13533049575694234;0.08549526658935132;0.04494619079655327;0.009846796631067085;0.004414580783974572
computrabajo.com;266;0;0;204;62;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;266;5;1347;48994;0.23308270676691728;62;0.33970544388676255;0.6602945561132375;0.2173468098787662;0.30326806072325546;0.14246872898418642;0.1367470935512116;0.12959089725751138;0.07057840960506889;0.25007553497479473;0.2724945133591014;0.13938086729552848;0.13240032992818523;0.1269228202384856;0.07872593420390457;0.20418286176194458;0.3180005155878112;0.144493411149157;0.13870864775924496;0.12895730412114423;0.06565725962069792;AD;2025-08-01;0.32063534297197704;0.039078303569297555;0.11676792928553312;0.5235184241731922;0.09805186327714718;0.3789244884430071;0.5230236482798458;0.1343659370889292;0.2538455988918666;0.21904490356560535;0.18370489796593134;0.10476624132764907;0.053941307957936266;0.022359389114868605;0.004583958845307095;0.004054547915838891;0.019333217326067395;0.5169659037193365;0.06471673151354818;0.10339017235876112;0.07179825051717911;0.12129953872395283;0.06260264164669999;0.046381088838440644;0.006266881513753074;0.006578791168328385
oysterhr.com;230;230;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;46;1;828;1840;0;0;0.4485300359377503;0.5514699640622497;0.29810284201535653;0.2935505071895583;0.15918831627540106;0.13754764537267136;0.07079133350903416;0.040819355637978526;0.271815539854524;0.2703967716776401;0.16179001140435617;0.1585024312574128;0.0861839265790473;0.05131131922701968;0.32179405595100313;0.3124736487106032;0.15719893864308038;0.11995684681947083;0.05749652903738857;0.031079980838453883;AD;2025-08-01;0.4642849994490837;0.031124124458700372;0.06371178242615173;0.4408790936660642;0.10418240758640852;0.38860030781976806;0.5072172845938235;0.13962923168200406;0.2727433674589853;0.1966502820758117;0.19746359079844555;0.10560899656234474;0.052235056840450114;0.02062344237735622;0.002853641046032682;0.0030680785386526755;0.009124312619916823;0.490538122346932;0.09021601929020598;0.12135446690013142;0.03866645296835905;0.12977827508682763;0.05925104660945876;0.05287342820615763;0.012312350553565955;0.005009838038361679Jump to Traffic SourcesTraffic Sources
Price: 1 API units per request
The Traffic Sources request lets you analyze website traffic sources from various channels. You can request data for direct, referral, search, social, email, and paid traffic, providing a comprehensive view of how visitors reach your competitors’ websites.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Traffic Distribution dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com, example.com/subfolder/
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 1000. The available range is between 1 and 5000.
Value/Type: integer
display_offset
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.
Value/Type: integer
traffic_channel
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.
Value/Type: direct, referral, search, social, mail, display_ad, ai_assistants, ai_search
traffic_type
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.
Value/Type: organic, paid
sort_order
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.
Value/Type: traffic, traffic_diff, traffic_share
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, from_target, display_date, country, device_type, traffic_share, traffic_diff, traffic, channel, traffic_type, search_engine, prev_traffic, categories
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_KEYtarget;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;referralJump to Traffic DestinationsTraffic Destinations
Price: 1 API units per request
The Traffic Destinations report provides a list of websites visited by users after leaving your competitors’ domains. This helps you understand the online journey of your market audience.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Traffic Distribution dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com, example.com/subfolder/
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 1000. The available range is between 1 and 5000.
Value/Type: integer
display_offset
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.
Value/Type: integer
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, to_target, traffic_share, traffic, prev_traffic, categories
sort_order
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.
Value/Type: traffic, traffic_diff, traffic_share
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_KEYtarget;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;33007Jump to Geo DistributionGeo Distribution
Price: 1 API units per request
The Geo Distribution report provides a list of countries where traffic to your selected domains comes from. This data lets you gain insights into the geographic diversity and distribution of your market audience.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Regional Trends dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com, example.com/subfolder/
target_type
Type of the analyzed target. If this parameter isn’t specified, the default value is domain.
Value/Type: domain, subdomain, subfolder
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 1000. The available range is between 1 and 5000.
Value/Type: integer
display_offset
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.
Value/Type: integer
geo_type
Type of geographical coverage.
If the value of the parameter is set to either continent or subcontinent, the geo column will be populated with corresponding region codes. Refer to Geo type codes to find the list of supported region codes.
If this parameter isn’t specified, the country data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
Value/Type: country, subcontinent, continent
export_columns
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.
Value/Type: target, display_date, device_type, geo, traffic, global_traffic, traffic_share, users, avg_visit_duration, bounce_rate, pages_per_visit, desktop_share, mobile_share
sort_order
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.
Value/Type: traffic, traffic_share, desktop_share, mobile_share, avg_visit_duration, pages_per_visit, bounce_rate
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_KEYtarget;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;384Jump to SubdomainsSubdomains
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.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Subfolders & Subdomains dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com
target_type
Type of the analyzed target. If this parameter isn’t specified, the default value is domain.
Value/Type: domain, subdomain
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 1000. The available range is between 1 and 5000.
Value/Type: integer
display_offset
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.
Value/Type: integer
country
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.
Value/Type: 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
export_columns
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, except for target_type.
Value/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, total_hits, desktop_hits, mobile_hits
sort_order
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.
Value/Type: traffic desktop_share mobile_share
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_KEYdomain;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.comJump to Top PagesTop Pages
Price: 1 API units per request
The Top Pages report displays the most popular pages of the chosen domains. This helps you understand which content resonates the most with your market audience.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Pages and Categories dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: domain.com
target_type
Type of the analyzed target. If this parameter isn’t specified, the default value is domain.
Value/Type: domain, subdomain, subfolder
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 1000. The available range is between 1 and 5000.
Value/Type: integer
display_offset
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.
Value/Type: integer
country
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.
Value/Type: 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
export_columns
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.
Value/Type: 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, ai_assistants, ai_search
sort_order
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.
Value/Type: users_by_target, avg_visit_duration, exits, traffic, entrance_traffic, traffic_share
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_KEYpage;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;0Jump to Traffic RankTraffic Rank
Price: 1 API units per request
The Traffic Rank report provides a list of domains sorted by traffic in descending order. This lets you benchmark your site against other domains to understand your relative market position, identify key competitors, and develop strategies to improve your site’s visibility and traffic.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Market Overview dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 200. The available range is between 1 and 200.
Value/Type: integer
display_offset
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.
Value/Type: integer
country
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.
Value/Type: 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
export_columns
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.
Value/Type: 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
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_KEYrank;domain
1;google.com
2;facebook.com
3;wikipedia.org
4;amazon.com
5;yahoo.comJump to Audience InsightsAudience Insights
Price: 1 API units per request
The Audience Insights report provides data to better understand how audiences among your chosen domains overlap. This data can help you with targeting, segmentation, and ad placement.
Even if a response is empty, the cost of one request will still be deducted from your API units.
This request data reflects the Visited domains section in the Audience Overlap dashboard. About the Audience Overlap dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetsRequired
5.Value/Type: domain1.com, domain2.com, domain3.com
selected_targetsRequired
Array of domains separated by a comma. These are the domains selected from the targets parameter for analysis.
The maximum number of domains depends on the number of domains in targets (up to 5).
Value/Type: domain1.com, domain2.com
segment
An operator that defines the audience scope:
contains unites the audience of the selected_targets.
shares combines the audience who visited all the selected_targets.
excludes selects the audience who visited other selected_targets domains but not the one you exclude.
Value/Type: contains, excludes, shares
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 1000. The available range is between 1 and 5000.
Value/Type: integer
display_offset
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.
Value/Type: integer
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, overlap_score, similarity_score, target_users, overlap_users, categories, is_adult
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_KEYtarget;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;30347980Jump to Data AccuracyData Accuracy
Price: 1 API units per request
The Data Accuracy report displays a metric that gauges the accuracy of the data presented. This lets you assess the reliability of the insights derived from the data and ensure that your strategies are built on precise and dependable information.
Even if a response is empty, the cost of one request will still be deducted from your API units.
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: domain.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, accuracy
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_KEYtarget;display_date;country;device_type;accuracy
ebay.com;2019-01-01;US;desktop;3Jump to SubfoldersSubfolders
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.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Subfolders & Subdomains dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com
target_type
Type of the analyzed target. If this parameter isn’t specified, the default value is domain.
Value/Type: domain, subdomain
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop
display_limit
Number of results to return. If this parameter isn’t specified, the default value is 1000. The available range is between 1 and 5000.
Value/Type: integer
display_offset
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.
Value/Type: integer
country
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.
Value/Type: 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
export_columns
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.
Value/Type: 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, ai_assistants, ai_search
search_string
This filter lets you get data for subfolders that contain the specified search term in their path.
Value/Type: string
sort_order
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.
Value/Type: 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, ai_assistants, ai_search
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_KEYusers;unique_pageviews;entrances;exits
108034494;442718812;139391428;214631237
117317596;400357027;88809293;119252855
57876899;181880099;26825058;41811998
59238134;160586116;27531044;30810362
46792998;150398115;21906685;36809256Jump to Age and Sex DistributionAge and Sex Distribution
Price: 1 API units per request
The Age and Sex Distribution report provides data on the age and sex distribution for your chosen domain’s audiences. This data helps you better understand the market’s demographics and enhance your segmentation and targeting.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Demographics dashboard ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, age, female_users, male_users, female_share, male_share
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_KEYage;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.00914Jump to Household DistributionHousehold Distribution
Price: 1 API units per request
The Household Distribution report provides data on the distribution of the chosen domain’s audiences by household size. This data helps you better understand the market’s household demographics and enhance your segmentation and targeting.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Audience Profile dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, size, users, users_share
https://api.semrush.com/analytics/ta/api/v3/household_distribution?target=amazon.com&export_columns=size,users,users_share&key=YOUR_API_KEYsize;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.005806342Jump to Income DistributionIncome Distribution
Price: 1 API units per request
The Income Distribution report provides data on the distribution of the chosen domain’s audiences by income. This data helps you better understand the socioeconomic diversity of your market and tailor your messaging, promotions, and offers.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Audience Profile dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, income_type, users, users_share
https://api.semrush.com/analytics/ta/api/v3/income_distribution?target=amazon.com&export_columns=income_type,users,users_share&key=YOUR_API_KEYincome_type;users;users_share
high;78982046;0.084616005
middle;236143146;0.25298774
low;618292149;0.66239625Jump to Education DistributionEducation Distribution
Price: 1 API units per request
The Education Distribution report provides data on the distribution of the chosen domain’s audiences by education level. This data helps you understand their educational background, so you can tailor content and marketing strategies to better resonate with different education levels.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Audience Profile dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, education, users, users_share
https://api.semrush.com/analytics/ta/api/v3/education_distribution?target=amazon.com&export_columns=education,users,users_share&key=YOUR_API_KEYeducation;users;users_share
none_completed;31115401;0.03333493
school;467949632;0.5013295
university;383657211;0.4110243
postgraduate;50695096;0.054311287Jump to Occupation DistributionOccupation Distribution
Price: 1 API units per request
The Occupation Distribution report provides data on the distribution of the chosen domain’s audiences by occupation. This data lets you gain insights into the professional makeup of your audience so you can develop more targeted marketing strategies and create content that appeals to specific professional groups.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Audience Profile dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com, subdomain.example.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2020-04-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, occupation, users, users_share
https://api.semrush.com/analytics/ta/api/v3/occupation_distribution?target=amazon.com&export_columns=occupation,users,users_share&key=YOUR_API_KEYoccupation;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.05664496Jump to Audience InterestsAudience Interests
Price: 1 API units per request
The Audience Interests report provides data to better understand the interests of your market audience. This helps you tailor your content and marketing strategies to match their preferences and engage them more effectively.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Audience Profile dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, display_date, country, device_type, category, users, users_score
https://api.semrush.com/analytics/ta/api/v3/audience_interests?target=amazon.com&export_columns=category,users,users_score&key=YOUR_API_KEYcategory;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.6997820185103172Jump to Social MediaSocial Media
Price: 1 API units per request
The Social Media report provides social media data of the chosen domain’s audiences. This lets you analyze their engagement and activity on various social platforms. This data can help you optimize your social media strategies and improve your online presence.
Even if a response is empty, the cost of one request will still be deducted from your API units.
About the Audience Profile dashboards ›
Jump to EndpointEndpoint
Request Parameters
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
targetRequired
Value/Type: example.com
display_date
Date in the YYYY-MM-01 format. If the display_date parameter isn’t specified, data from the previous month is shown by default.
The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01.
Value/Type: YYYY-MM-01
device_type
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.
Value/Type: desktop, mobile
country
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.
Value/Type: 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
export_columns
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.
Value/Type: target, device_type, display_date, country, social_name, social_domain, users_score, users
https://api.semrush.com/analytics/ta/api/v3/social_media?target=amazon.com&export_columns=social_name,social_domain,users_score,users&key=YOUR_API_KEYsocial_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;101460220Last updated: January 30, 2026