Semrush Developers

Price: 1 API units per line

This report lets you get the main estimated traffic metrics for multiple websites on a monthly basis for desktop and mobile users in the CSV format. To gain insights on your markets, prospects, or partners, enter your target domain, use filters, and get key traffic data: traffic rank, visits, unique visitors, pages per visit, average visit duration, and bounce rate.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
targets*	example1.com, subdomain.example2.com, e… example1.com, subdomain.example2.com, example3.com/subfolder/	Array of domains, subdomains, and subfolders separated by commas. The maximum number of targets is 200.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data from the previous month is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target rank visits categories desktop_v… 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 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	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This report lets you analyze website traffic sources from various channels including direct, referral, search, social, and paid traffic.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com, subdomain.example.com, exa… example.com, subdomain.example.com, example.com/subfolder/	Root domain, subdomain, or subfolder.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data from the previous month is shown by default.
device_type	desktop, mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `1000`. The available range is between `1` and `5000`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. The available range is between `0` and `10000`.
traffic_channel	direct, referral, search, social, mail,… direct, referral, search, social, mail, display_ad	This parameter lets you filter traffic sources by a specific channel type. If this parameter isn't specified, data for all traffic channels is shown by default.
traffic_type	organic, paid	This parameter allows you to retrieve organic or paid traffic. If this parameter isn't specified, data for all traffic types is shown by default.
sort_order	traffic, traffic_diff, traffic_share	This parameter lets you sort the data. For descending order, append `_desc`; for ascending order, append `_asc`. If this parameter isn't specified, data is shown in descending order by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, from_target, display_date, coun… target, from_target, display_date, country, device_type, traffic_share, traffic_diff, traffic channel, traffic_type, search_engine, prev_traffic, categories	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

A list of sites visited by users after leaving the analyzed target.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com examp… example.com subdomain.example.com example.com/subfolder/	Root domain, subdomain, or subfolder.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `1000`. The available range is between `1` and `5000`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. There is no range for the parameter.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target display_date country device_type… target display_date country device_type to_target traffic_share traffic prev_traffic categories	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.
sort_order	traffic traffic_diff traffic_share	This parameter lets you sort the data. For descending order, append `_desc`; for ascending order, append `_asc`. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

A list of countries where the visitors of the analyzed target come from.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com examp… example.com subdomain.example.com example.com/subfolder/	Root domain, subdomain, or subfolder.
target_type	domain subdomain subfolder	Type of the analyzed target. If this parameter isn't specified, the default value is `domain`.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `1000`. The available range is between `1` and `5000`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. There is no range for the parameter.
geo_type	country subcontinent continent	Type of geographical coverage. If this parameter isn't specified, the country data is shown by default.
export_columns	target display_date device_type geo tra… target display_date device_type geo traffic global_traffic traffic_share users avg_visit_duration bounce_rate pages_per_visit desktop_share mobile_share	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.
sort_order	traffic traffic_share desktop_share mob… traffic traffic_share desktop_share mobile_share avg_visit_duration pages_per_visit bounce_rate	This parameter lets you sort the data. For descending order, append `_desc`; for ascending order, append `_asc`. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

The top subdomains of the analyzed target that get the most traffic.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com	Root domain or subdomain.
target_type	domain subdomain	Type of the analyzed target. If this parameter isn't specified, the default value is `domain`.
display_date	2020-07-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data from the previous month is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `1000`. The available range is between `1` and `5000`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. There is no range for the parameter.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	domain display_date country device_type… domain display_date country device_type target_type subdomain traffic_share desktop_share mobile_share total_visits desktop_visits mobile_visits total_users desktop_users mobile_users	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.
sort_order	traffic desktop_share mobile_share	This parameter lets you sort the data. For descending order, append `_desc`; for ascending order, append `_asc`. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This report shows you what pages of the analyzed target are most popular among users.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	domain.com	Root domain.
target_type	domain subdomain subfolder	Type of the analyzed target. If this parameter isn't specified, the default value is `domain`.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data from the previous month is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `1000`. The available range is between `1` and `5000`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. There is no range for the parameter.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target device_type country display_date… 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 referral social paid unknown search_organic search_paid social_organic social_paid mail display_ad	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.
sort_order	users_by_target avg_visit_duration exit… users_by_target avg_visit_duration exits traffic entrance_traffic traffic_share	This parameter lets you sort the data. For descending order, append `_desc`; for ascending order, append `_asc`. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This report shows a list of domains sorted by traffic in descending order.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
display_date	2020-07-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `200`. The available range is between `1` and `200`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. There is no range for the parameter.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	display_date country device_type rank d… display_date country device_type rank domain visits users desktop_share mobile_share desktop_visits mobile_visits time_on_site bounce_rate pages_per_visit	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This report lets you get data to better understand your target audience.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
targets*	domain1.com, domain2.com, domain3.com	Array of domains separated by a comma. The maximum number of domains is `5`.
selected_targets	domain1.com, domain2.com	Array of domains separated by a comma. Indicate the domains from the `targets` parameter that you'd like to apply the segment operator to. The maximum number of domains depends on the number of domains in `targets` (up to 5).
segment	contains excludes shares	An operator that regulates the relationship between `targets` and `selected_targets`: Contains unites the audience of the selected websites. Shares combines the audience who visited all the selected websites. Excludes selects the audience who visited at least one of the `targets` websites, but didn't visit any websites from `selected_targets`.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `1000`. The available range is between `1` and `5000`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. There is no range for the parameter.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target overlap_score similarity_score t… target overlap_score similarity_score target_users overlap_users categories is_adult	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This report shows a metric that gauges the accuracy of the data presented.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	domain.com	Root domain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target display_date country device_type… target display_date country device_type accuracy	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

The top subfolders of the analyzed target getting the most traffic.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com, subdomain.example.com	Root domain or subdomain.
target_type	domain, subdomain	Type of the analyzed target. If this parameter isn't specified, the default value is `domain`.
display_date	2021-01-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data from the previous month is shown by default.
device_type	desktop	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_limit	integer	Number of results to return. If this parameter isn't specified, the default value is `1000`. The available range is between `1` and `5000`.
display_offset	integer	This parameter lets you skip a specified number of results before sending a report. If this parameter isn't specified, the default value is `0`. There is no range for the parameter.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	display_date subfolder subdomain traffi… display_date subfolder subdomain traffic_share users unique_pageviews entrances exits time_on_subfolder pages_per_visit bounce_rate direct search referral social paid search_organic search_paid social_organic social_paid mail display_ad	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.
search_string	string	This filter lets you get data for subfolders that contain the specified search term in their path.
sort_order	traffic_share unique_pageviews users en… traffic_share unique_pageviews users entrances exits time_on_subfolder pages_per_visit bounce_rate direct search referral social paid search_organic search_paid social_organic social_paid mail display_ad	This parameter lets you sort the data. For descending order, append `_desc`; for ascending order, append `_asc`. If this parameter isn't specified, data is shown in descending order by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This call lets you get data on the distribution of the target's audience by age and sex.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com	Root domain or subdomain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, age, female_users, male_users, female_share, male_share	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This call lets you get data on the distribution of the target's audience by household.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com	Root domain or subdomain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, size, users, users_share	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This call lets you get data on the distribution of the target's audience by income.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com	Root domain or subdomain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, income_type, users, users_share	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This call lets you get data on the distribution of the target's audience by education.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com	Root domain or subdomain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, the last report data is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, education, users, users_share	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This call lets you get data on the distribution of the target's audience by occupation.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com subdomain.example.com	Root domain or subdomain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data from the previous month is shown by default.
device_type	desktop mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, occupation, users, users_share	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This report lets you get data to better understand the interests of your target's audience.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com	Root domain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data from the previous month is shown by default.
device_type	desktop, mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, category, users, users_score	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

Price: 1 API units per request

This report lets you get the social media data of your target's audience.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.
target*	example.com	Root domain.
display_date	2020-06-01	Date in the `YYYY-MM-01` format. If the `display_date` parameter isn't specified, data for the last report is shown by default.
device_type	desktop, mobile	This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
country	AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ,… AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW	The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference, column Alpha-2 code.
export_columns	target, device_type, display_date, coun… target, device_type, display_date, country, social_name, social_domain, users_score, users	This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Response example

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

This call returns information about your monthly, daily, and hourly API units usage.

Request parameters

Name	Value/Type	Description
key*	API_KEY	Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units.

* Fields marked by an asterisk (*) are required

Endpoint

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

Request example

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

Traffic Analytics

Traffic summary

Request parameters

Traffic sources

Request parameters

Traffic destinations

Request parameters

Geo distribution

Request parameters

Subdomains

Request parameters

Top pages

Request parameters

Domain rankings

Request parameters

Audience insights

Request parameters

Data accuracy

Request parameters

Subfolders

Request parameters

Age and sex distribution

Request parameters

Household distribution

Request parameters

Income distribution

Request parameters

Education distribution

Request parameters

Occupation distribution

Request parameters

Audience interests

Request parameters

Request parameters

API usage

Request parameters

Traffic Analytics

Traffic summary

Request parameters

Traffic sources

Request parameters

Traffic destinations

Request parameters

Geo distribution

Request parameters

Subdomains

Request parameters

Top pages

Request parameters

Domain rankings

Request parameters

Audience insights

Request parameters

Data accuracy

Request parameters

Subfolders

Request parameters

Age and sex distribution

Request parameters

Household distribution

Request parameters

Income distribution

Request parameters

Education distribution

Request parameters

Occupation distribution

Request parameters

Audience interests

Request parameters

Social media

Request parameters

API usage

Request parameters