contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 6: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 desktop_visits mobil…
target rank visits desktop_visits mobile_visits users desktop_users mobile_users desktop_hits mobile_hits direct referral social search paid 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

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_hits desktop_hits mobile_hits 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,total_hits&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;total_hits
amazon.com;2019-07-01;twitch.amazon.com;24274866
amazon.com;2019-07-01;sellercentral.amazon.com;50300062
amazon.com;2019-07-01;aws.amazon.com;14274172

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

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

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

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