Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Need help?
Telephone
United States
United States
Canada
United Kingdom
Spain
France
Italy
Germany
Australia
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
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.
Name | Value/Type | Description |
---|---|---|
key | API_KEY |
|
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
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
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. |
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
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
A list of sites visited by users after leaving the analyzed domain.
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
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
A list of countries where the visitors of the analyzed domain come from.
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
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
The top subdomains of an analyzed domain getting the most traffic.
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
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
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.
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
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
This report shows a list of domains sorted by traffic in descending order.
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
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
This report allows you to get data for better understanding of your target audience.
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
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
This report shows a metric that gauges the accuracy of the data presented.
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
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
The top subfolders of an analyzed domain getting the most traffic.
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
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
Distribution of the domain audience by age and sex.
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
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
Distribution of the domain audience by household.
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
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
Distribution of the domain audience by income.
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
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
Distribution of the domain audience by education.
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
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
Distribution of the domain audience by occupation.
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
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
This report allows you to get data for better understanding of your target audience interests.
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
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
This report allows you to get social media data of your target audience.
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
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.
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
Request example
http://api.semrush.com/analytics/ta/limits/key/:API_KEY