contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 5:00 PM (EST/EDT)

Monday - Friday

mobile-menu

Traffic Analytics

Version 3 divider Last updated: September 14, 2021

Traffic summary

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

Traffic sources

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

Traffic destinations

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

Geo distribution

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

Subdomains

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

Top pages

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

Domain rankings

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

Audience insights

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

Data accuracy

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

Subfolders

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

Age and sex distribution

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

Household distribution

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

Income distribution

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

Education distribution

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

Occupation distribution

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

Audience interests

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

Social media

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

API usage

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