Semrush Developers

Price: 1 API units per line

This report allows you to get the main estimated traffic metrics for multiple domains on a monthly basis for desktop and mobile users in 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, avg. visit duration, and bounce rate.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
targets	example1.com, subdomain.example2.com, e… example1.com, subdomain.example2.com, example3.com/subfolder/	An array of domains, subdomains, and subfolders separated by commas. Required parameter. The maximum number of targets is limited to 200.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
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	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target	example.com subdomain.example.com examp… example.com subdomain.example.com example.com/subfolder/	A root domain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 1000. The available range is between 1 and 5000.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 0. The available range is between 0 and 10000.
traffic_channel	direct referral search social mail disp… direct referral search social mail display_ad	The traffic channel type filter. This parameter allows you to filter traffic sources by a specific channel type. If this parameter is not specified, no data will be shown.
traffic_type	organic paid	The traffic type filter. This parameter allows you to retrieve organic or paid traffic. If the traffic type is not specified, no data will be shown.
sort_order	traffic traffic_diff traffic_share	A sort by parameter. For descending order append _desc, for ascending order append _asc. If this parameter is not specified, descending order will be set 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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
export_columns	target from_target display_date country… target from_target display_date country device_type traffic_share traffic_diff traffic channel traffic_type search_engine prev_traffic categories	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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 domain.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target	example.com subdomain.example.com examp… example.com subdomain.example.com example.com/subfolder/	A root domain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 1000. The available range is between 1 and 5000.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
export_columns	target display_date country device_type… target display_date country device_type to_target traffic_share traffic prev_traffic categories	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.
sort_order	traffic traffic_diff traffic_share	A sort by parameter. For descending order append _desc, for ascending order append _asc. If this parameter is not specified, descending order will be set 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 domain come from.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target	example.com subdomain.example.com examp… example.com subdomain.example.com example.com/subfolder/	A root domain. Required parameter.
target_type	domain subdomain subfolder	The target domain type.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 1000. The available range is between 1 and 5000.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 0. There is no range for the parameter.
geo_type	country subcontinent continent	A type of geographical coverage. If this parameter is not specified, 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	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.
sort_order	traffic traffic_share desktop_share mob… traffic traffic_share desktop_share mobile_share avg_visit_duration pages_per_visit bounce_rate	A sort by parameter. For descending order append _desc, for ascending order append _asc. If this parameter is not specified, descending order will be set 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 an analyzed domain getting the most traffic.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target	example.com subdomain.example.com	Required parameter.
target_type	domain subdomain	A type of the analyzed target.
display_date	2020-07-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 1000. The available range is between 1 and 5000.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
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	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.
sort_order	traffic desktop_share mobile_share	A sort by parameter. For descending order append _desc, for ascending order append _asc. If this parameter is not specified, descending order will be set 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 an analyzed domain are the most popular among users, as well as what backlinks lead users to that domain.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target	domain.com	A root domain. Required parameter. Required parameter.
target_type	domain subdomain subfolder	The target domain type.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 1000. The available range is between 1 and 5000.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
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	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.
sort_order	users_by_target avg_visit_duration exit… users_by_target avg_visit_duration exits traffic entrance_traffic traffic_share	A sort by parameter. For descending order append _desc, for ascending order append _asc. If this parameter is not specified, descending order will be set 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	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
display_date	2020-07-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 200. The available range is between 1 and 200.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
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	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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 allows you to get data for better understanding of your target audience.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target	domain1.com, domain2.com, domain3.com	An array of domains separated by a comma. Required parameter. The maximum number of domains is limited to 5.
selected_targets	domain1.com, domain2.com	A pick from the targets you apply a segment operator to.
segment	contains excludes shares	An operator that regulates a relationship between targets and selected_targets.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 1000. The available range is between 1 and 5000.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
export_columns	target overlap_score similarity_score t… target overlap_score similarity_score target_users overlap_users categories is_adult	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target	domain.com	A root domain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop mobile	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
export_columns	target display_date country device_type… target display_date country device_type accuracy	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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 an analyzed domain getting the most traffic.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
target	example.com subdomain.example.com	A root domain or subdomain.
target_type	domain subdomain	A type of the analyzed target.
display_date	2021-01-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month by default.
device_type	desktop	The device filter. This parameter allows you to choose whether to retrieve desktop or mobile data, or both. If the parameter is not specified, data for all devices will be shown.
display_limit	integer	The number of results returned. If this parameter is not specified, the default value will be 1000. The available range is between 1 and 5000.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. If this parameter is not specified, the default value will be 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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data is shown by default.
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	A list of required columns separated by a comma. If this parameter is not specified, all columns will be shown.
search_string	string	A filter that allows retrieving 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	A sort by parameter. For descending order append _desc, for ascending order append _asc. If this parameter is not specified, descending order will be set 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

Distribution of the domain audience by age and sex.

Request parameters

Name	Value/Type	Description
target	example.com subdomain.example.com	A root domain or a subdomain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data is shown for the previous month.
device_type	desktop mobile	This parameter allows you to choose whether to retrieve desktop or mobile data. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data will be shown.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, age, female_users, male_users, female_share, male_share	A list of columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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

Distribution of the domain audience by household.

Request parameters

Name	Value/Type	Description
target	example.com subdomain.example.com	A root domain or a subdomain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data for the last report will be shown.
device_type	desktop mobile	This parameter allows you to choose whether to retrieve desktop or mobile data. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data will be shown.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, size, users, users_share	A list of columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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

Distribution of the domain audience by income.

Request parameters

Name	Value/Type	Description
target	example.com subdomain.example.com	A root domain or a subdomain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data for the last report will be shown.
device_type	desktop mobile	This parameter allows you to choose whether to retrieve desktop or mobile data. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data will be shown.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, income_type, users, users_share	A list of columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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

Distribution of the domain audience by education.

Request parameters

Name	Value/Type	Description
target	example.com subdomain.example.com	A root domain or a subdomain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data for the last report will be shown.
device_type	desktop mobile	This parameter allows you to choose whether to retrieve desktop or mobile data. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data will be shown.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, education, users, users_share	A list of columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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

Distribution of the domain audience by occupation.

Request parameters

Name	Value/Type	Description
target	example.com subdomain.example.com	A root domain or a subdomain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data for the last report will be shown.
device_type	desktop mobile	This parameter allows you to choose whether to retrieve desktop or mobile data. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data will be shown.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, occupation, users, users_share	A list of columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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 allows you to get data for better understanding of your target audience interests.

Request parameters

Name	Value/Type	Description
target	example.com	A root domain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data for the last report will be shown.
device_type	desktop, mobile	This parameter allows you to choose whether to retrieve desktop or mobile data. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data will be shown.
export_columns	target, display_date, country, device_t… target, display_date, country, device_type, category, users, users_score	A list of columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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 allows you to get social media data of your target audience.

Request parameters

Name	Value/Type	Description
target	example.com	A root domain. Required parameter.
display_date	2020-06-01	The date in YYYY-MM-01 format. If the display_date parameter is not specified, data for the last report will be shown.
device_type	desktop, mobile	This parameter allows you to choose whether to retrieve desktop or mobile data. If the parameter is not specified, data for all devices will be shown.
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 allows you to filter traffic data for a particular country. If the parameter is not specified, global data will be shown.
export_columns	target, device_type, display_date, coun… target, device_type, display_date, country, social_name, social_domain, users_score, users	A list of columns separated by a comma. If this parameter is not specified, all columns will be shown.

* 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

Returns information about the user's monthly, daily, and hourly API units usage.

Request parameters

Name	Value/Type	Description
key	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.

* 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