Reference

Jump to List Domain CategoriesList Domain Categories

Price: 20 API units per request

Get the industry categories assigned to a domain, ordered by relevance. The same category values are used in the categories filter across Traffic & Market endpoints. If a domain has no assigned categories, or the domain is unknown, the response returns an empty list. An empty response is not charged.

Cost: API units per request.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/domains/categories

Query parameters

domainRequired

Domain to look up. Accepts values both with the protocol (https://) and without it. The value is reduced to its root domain (e.g., https://blog.example.com/page is looked up as example.com).

Example: samplesite.com

Value/Type: string

format

Response format. Use json (default) or csv. Supported values: json, csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Industry categories assigned to the domain, ordered by relevance.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/domains/categories?domain=samplesite.com&format=json"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "samplesite.com",
      "effective_domain": "samplesite.com",
      "total": 1
  },
  "data": [
      {
          "category": "TRAVEL_AND_TOURISM"
      },
      {
          "category": "HOSPITALITY"
      },
      {
          "category": "RESTAURANTS"
      }
  ]
}
Response example
CSV
category
TRAVEL_AND_TOURISM
HOSPITALITY
RESTAURANTS

Jump to List DestinationsList Destinations

Price: 80 API units per line

The List Destinations report returns data on the most popular exit destinations. Use it to discover where your market audience goes after visiting a target.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/destinations

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: https://example.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER.

Example: ROOT_DOMAIN

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-01

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state.

Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state. Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Example: northern_africa

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion.

Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Example: US_CA

Value/Type: string

categories

Filter destinations by industry categories. Only results matching at least one category are included.

Supported values: ACCOUNTING_AND_AUDITING, ADULT, ADVERTISING_AND_MARKETING, AEROSPACE_AND_DEFENSE, AGRICULTURE, AIRLINES, APPAREL_AND_FASHION, ARCHITECTURE, AUTOMOTIVE, BANKING, BEAUTY_AND_COSMETICS, BIOTECH, CERAMICS_AND_POTTERY, CHEMICALS, CIVIL_ENGINEERING, COMICS_AND_ANIMATION, COMPUTER_AND_VIDEO_GAMES, COMPUTER_HARDWARE, COMPUTER_SOFTWARE_AND_DEVELOPMENT, COMPUTERS_AND_ELECTRONICS, CONSTRUCTION_AND_MAINTENANCE, CONSULTING, CONSUMER_ELECTRONICS, CRAFTS, CUSTOMER_SERVICES, DESIGN, DISTANCE_LEARNING, ECOLOGY_AND_ENVIRONMENT, EDUCATION, ENTERTAINMENT, EQUIPMENT_AND_SUPPLIES, EVENTS_SERVICES, FACILITIES_SERVICES, FARMS_AND_RANCHES, FINANCE, FISHERY, FOOD_AND_BEVERAGES, FOREIGN_LANGUAGE, FURNITURE, GAMBLING, GOVERNMENT, GRAPHIC_DESIGN, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, IMPORT_AND_EXPORT, INFORMATION_TECHNOLOGY, INSURANCE, INVESTMENT, JEWELRY_AND_LUXURY_PRODUCTS, LEGAL, LIBRARIES, MACHINERY, MAIL_AND_PACKAGE_DELIVERY, MANUFACTURING, MARITIME, MARKET_RESEARCH, MASS_MEDIA, MEDICAL_DEVICES_AND_EQUIPMENT, MENTAL_HEALTH, METALS_AND_MINING, MILITARY, MUSEUMS, MUSIC, NANOTECHNOLOGY, NEWSPAPERS, NONPROFIT_ORGANIZATIONS, OIL_AND_GAS, ONLINE_SERVICES, OUTSOURCING, PACKAGING_AND_CONTAINERS, PERFORMING_ARTS, PHARMACEUTICALS, PHOTOGRAPHY, PLASTICS_AND_POLYMERS, POLITICAL_ORGANIZATIONS, PRINTING, PUBLIC_POLICY, PUBLIC_RELATIONS, PUBLIC_SAFETY, PUBLIC_UTILITY, PUBLISHING, REAL_ESTATE, RECREATIONAL_FACILITIES, RECRUITMENT_AND_STAFFING, REFERENCE, RELIGION_AND_BELIEF, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SCIENCE, SECURITY_PRODUCTS_AND_SERVICES, SOCIAL_AND_CHARITABLE_ORGANIZATIONS, SPORTING_GOODS, SPORTS, TELECOM, TEXTILES_AND_NONWOVENS, TOBACCO, TRAINING_AND_CERTIFICATION, TRANSPORTATION_AND_LOGISTICS, TRAVEL_AND_TOURISM, TV_AND_MOVIES, VENTURE_CAPITAL, VETERINARY, VISUAL_ART, WAREHOUSING, WELLNESS, WHOLESALERS_AND_LIQUIDATORS, WINE_AND_SPIRITS, WRITING_AND_EDITING_SERVICES.

Example: INFORMATION_TECHNOLOGY,FINANCE

Value/Type: string[]

fields

Response fields to include. Default: all fields.

Supported values: entrances, entrances_share, categories.

Identity fields, such as destination_url, are always returned and not selectable.

Example: entrances,entrances_share,categories

Value/Type: string[]

order_by

Field name to sort by. Supported values: entrances, entrances_share. Default: entrances DESC.

Example: entrances

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Value/Type: integer

offset

Number of results to skip. Default: 0.

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of traffic destinations.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/destinations?url=example.com&scope=ROOT_DOMAIN&month=2024-01&device_type=DESKTOP&country=US&fields=entrances,entrances_share,categories&order_by=entrances&direction=DESC&limit=10"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "country": "US",
      "month": "2024-01",
      "device_type": "DESKTOP",
      "direction": "DESC",
      "limit": 10,
      "offset": 0,
      "order_by": "entrances",
      "scope": "ROOT_DOMAIN",
      "url": "example.com",
      "effective_url": "example.com",
      "total": 2
  },
  "data": [
      {
          "destination_url": "competitor.com",
          "entrances": 1250,
          "entrances_share": 0.453,
          "categories": ["TRAVEL_AND_TOURISM", "HOSPITALITY"]
      },
      {
          "destination_url": "news-site.com",
          "entrances": 850,
          "entrances_share": 0.308,
          "categories": ["MASS_MEDIA", "NEWSPAPERS"]
      }
  ]
}
Response example
CSV
destination_url;entrances;entrances_share;categories
competitor.com;1250;0.453;TRAVEL_AND_TOURISM,HOSPITALITY
news-site.com;850;0.308;MASS_MEDIA,NEWSPAPERS

Jump to List PagesList Pages

Price: 20 API units per line

The List Pages report returns pages data for a target. Use it to identify the most visited pages.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/pages

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: https://samplesite.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER.

Example: ROOT_DOMAIN

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state.

Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state.

Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion.

Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Value/Type: string

path_contains

Path substring to filter pages.

Example: blog

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visits, entrances, entrances_share, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, bounces_per_visit, avg_visit_duration.

The page_url identity field is always returned and not selectable.

Example: visitors,visits,entrances

Value/Type: string[]

order_by

Field name to sort by.

Supported values: visitors, visits, entrances, entrances_share, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, bounces_per_visit, avg_visit_duration.

Default: entrances DESC.

Example: visitors

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Value/Type: integer

offset

Number of results to skip. Default: 0.

Value/Type: integer

format

Response format.

Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of pages with traffic metrics.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/pages?url=samplesite.com&scope=ROOT_DOMAIN&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visits,entrances&order_by=visitors&direction=DESC&limit=10"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "url": "samplesite.com",
      "scope": "ROOT_DOMAIN",
      "month": "2024-06",
      "country": "US",
      "device_type": "DESKTOP",
      "limit": 10,
      "offset": 0,
      "order_by": "visitors",
      "direction": "DESC",
      "effective_url": "samplesite.com",
      "total": 2
  },
  "data": [
      {
          "page_url": "https://samplesite.com/",
          "visitors": 15240,
          "visits": 28650,
          "entrances": 12540
      },
      {
          "page_url": "https://samplesite.com/blog",
          "visitors": 8920,
          "visits": 14350,
          "entrances": 7280
      }
  ]
}
Response example
CSV
page_url;visitors;visits;entrances
https://samplesite.com/;15240;28650;12540
https://samplesite.com/blog;8920;14350;7280

Jump to List RegionsList Regions

Price: 20 API units per line

The List Regions report returns traffic regions data for a target. Use it to understand which regions contribute the most traffic.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/regions

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: https://samplesite.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE.

Example: ROOT_DOMAIN

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

region_typeRequired

Type of regional grouping for the results. Supported values: COUNTRY, SUBREGION, STATE.

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visits, entrances, entrances_share, page_views_per_visit, bounces_per_visit, avg_visit_duration.

The region_code identity field is always returned and not selectable.

Example: visitors,visits,entrances

Value/Type: string[]

order_by

Field name to sort by.

Supported values: visitors, visits, entrances, entrances_share, page_views_per_visit, bounces_per_visit, avg_visit_duration.

Default: entrances DESC.

Example: visitors

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Value/Type: integer

offset

Number of results to skip. Default: 0.

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of regions with traffic metrics.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/regions?url=samplesite.com&scope=ROOT_DOMAIN&month=2024-06&region_type=COUNTRY&device_type=DESKTOP&fields=visitors,visits,entrances&order_by=visitors&direction=DESC&limit=10&offset=0"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "url": "samplesite.com",
      "scope": "ROOT_DOMAIN",
      "month": "2024-06",
      "region_type": "COUNTRY",
      "device_type": "DESKTOP",
      "order_by": "visitors",
      "direction": "DESC",
      "limit": 10,
      "offset": 0,
      "effective_url": "samplesite.com",
      "total": 2
  },
  "data": [
      {
          "region_code": "US",
          "visitors": 85420,
          "visits": 102300,
          "entrances": 48500
      },
      {
          "region_code": "GB",
          "visitors": 32180,
          "visits": 38900,
          "entrances": 18200
      }
  ]
}
Response example
CSV
region_code;visitors;visits;entrances
US;85420;102300;48500
GB;32180;38900;18200

Jump to List SourcesList Sources

Price: 80 API units per line

The List Sources report returns a detailed breakdown of traffic sources with entrance counts and shares. Use it to understand how visitors reach a website and analyze traffic distribution across sources.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/sources

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: https://example.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER.

Example: ROOT_DOMAIN

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-01

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state.

Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN M49 geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state.

Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion.

Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Value/Type: string

channel

Traffic channel to filter by. Default: ALL.

Supported values: DIRECT, SEARCH_ORGANIC, SEARCH_PAID, SOCIAL_ORGANIC, SOCIAL_PAID, REFERRAL, MAIL, DISPLAY_AD, AI_ASSISTANTS, ALL.

Value/Type: string

categories

Filter sources by industry categories. Only results matching at least one category are included.

Supported values: ACCOUNTING_AND_AUDITING, ADULT, ADVERTISING_AND_MARKETING, AEROSPACE_AND_DEFENSE, AGRICULTURE, AIRLINES, APPAREL_AND_FASHION, ARCHITECTURE, AUTOMOTIVE, BANKING, BEAUTY_AND_COSMETICS, BIOTECH, CERAMICS_AND_POTTERY, CHEMICALS, CIVIL_ENGINEERING, COMICS_AND_ANIMATION, COMPUTER_AND_VIDEO_GAMES, COMPUTER_HARDWARE, COMPUTER_SOFTWARE_AND_DEVELOPMENT, COMPUTERS_AND_ELECTRONICS, CONSTRUCTION_AND_MAINTENANCE, CONSULTING, CONSUMER_ELECTRONICS, CRAFTS, CUSTOMER_SERVICES, DESIGN, DISTANCE_LEARNING, ECOLOGY_AND_ENVIRONMENT, EDUCATION, ENTERTAINMENT, EQUIPMENT_AND_SUPPLIES, EVENTS_SERVICES, FACILITIES_SERVICES, FARMS_AND_RANCHES, FINANCE, FISHERY, FOOD_AND_BEVERAGES, FOREIGN_LANGUAGE, FURNITURE, GAMBLING, GOVERNMENT, GRAPHIC_DESIGN, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, IMPORT_AND_EXPORT, INFORMATION_TECHNOLOGY, INSURANCE, INVESTMENT, JEWELRY_AND_LUXURY_PRODUCTS, LEGAL, LIBRARIES, MACHINERY, MAIL_AND_PACKAGE_DELIVERY, MANUFACTURING, MARITIME, MARKET_RESEARCH, MASS_MEDIA, MEDICAL_DEVICES_AND_EQUIPMENT, MENTAL_HEALTH, METALS_AND_MINING, MILITARY, MUSEUMS, MUSIC, NANOTECHNOLOGY, NEWSPAPERS, NONPROFIT_ORGANIZATIONS, OIL_AND_GAS, ONLINE_SERVICES, OUTSOURCING, PACKAGING_AND_CONTAINERS, PERFORMING_ARTS, PHARMACEUTICALS, PHOTOGRAPHY, PLASTICS_AND_POLYMERS, POLITICAL_ORGANIZATIONS, PRINTING, PUBLIC_POLICY, PUBLIC_RELATIONS, PUBLIC_SAFETY, PUBLIC_UTILITY, PUBLISHING, REAL_ESTATE, RECREATIONAL_FACILITIES, RECRUITMENT_AND_STAFFING, REFERENCE, RELIGION_AND_BELIEF, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SCIENCE, SECURITY_PRODUCTS_AND_SERVICES, SOCIAL_AND_CHARITABLE_ORGANIZATIONS, SPORTING_GOODS, SPORTS, TELECOM, TEXTILES_AND_NONWOVENS, TOBACCO, TRAINING_AND_CERTIFICATION, TRANSPORTATION_AND_LOGISTICS, TRAVEL_AND_TOURISM, TV_AND_MOVIES, VENTURE_CAPITAL, VETERINARY, VISUAL_ART, WAREHOUSING, WELLNESS, WHOLESALERS_AND_LIQUIDATORS, WINE_AND_SPIRITS, WRITING_AND_EDITING_SERVICES.

Example: INFORMATION_TECHNOLOGY,FINANCE

Value/Type: string[]

fields

Response fields to include. Default: all fields.

Supported values: entrances, entrances_share, categories.

Identity fields, such as source_url, source_display_name, and channel, are always returned and not selectable.

Example: entrances,entrances_share,categories

Value/Type: string[]

order_by

Field name to sort by. Supported values: entrances, entrances_share. Default: entrances DESC.

Example: entrances

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Example: 100

Value/Type: integer

offset

Number of results to skip. Default: 0.

Example: 0

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Example: json

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of traffic sources.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/sources?url=example.com&scope=ROOT_DOMAIN&month=2024-01&device_type=DESKTOP&country=US&fields=entrances,entrances_share,categories&order_by=entrances&direction=DESC&limit=10"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "url": "example.com",
      "scope": "ROOT_DOMAIN",
      "month": "2024-01",
      "device_type": "DESKTOP",
      "country": "US",
      "channel": "ALL",
      "direction": "DESC",
      "order_by": "entrances",
      "limit": 10,
      "offset": 0,
      "effective_url": "example.com",
      "total": 2,
      "total_count": 2
  },
  "data": [
      {
          "source_url": "google.com",
          "source_display_name": "Google",
          "channel": "SEARCH_ORGANIC",
          "entrances": 45230,
          "entrances_share": 0.425,
          "categories": ["ONLINE_SERVICES", "INFORMATION_TECHNOLOGY"]
      },
      {
          "source_url": "reddit.com",
          "source_display_name": "Reddit",
          "channel": "REFERRAL",
          "entrances": 28150,
          "entrances_share": 0.263,
          "categories": ["MASS_MEDIA", "ONLINE_SERVICES"]
      }
  ]
}
Response example
CSV
source_url;source_display_name;channel;entrances;entrances_share;categories
google.com;Google;SEARCH_ORGANIC;45230;0.425;ONLINE_SERVICES,INFORMATION_TECHNOLOGY
reddit.com;Reddit;REFERRAL;28150;0.263;MASS_MEDIA,ONLINE_SERVICES

Jump to List SubdomainsList Subdomains

Price: 20 API units per line

The List Subdomains report returns detailed traffic metrics for each subdomain, including visitor counts, page views, and traffic sources. Use it to discover how traffic is distributed across the subdomains of a target.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/subdomains

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: example.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN.

Example: ROOT_DOMAIN

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-01

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state.

Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state.

Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion.

Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visits, entrances, entrances_share, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, page_views_per_visit, bounces_per_visit, avg_visit_duration.

The subdomain_url identity field is always returned and not selectable.

Example: visitors,visits,avg_visit_duration

Value/Type: string[]

order_by

Field name to sort by. Supported values: visitors, visits, entrances, entrances_share, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, page_views_per_visit, bounces_per_visit, avg_visit_duration. Default: entrances DESC.

Example: visitors

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Example: 10

Value/Type: integer

offset

Number of results to skip. Default: 0.

Example: 0

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of subdomain traffic metrics.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/subdomains?url=example.com&scope=ROOT_DOMAIN&month=2024-01&device_type=DESKTOP&country=US&fields=visitors,visits,avg_visit_duration&order_by=visitors&direction=DESC&limit=10&offset=0"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "url": "example.com",
      "scope": "ROOT_DOMAIN",
      "month": "2024-01",
      "device_type": "DESKTOP",
      "country": "US",
      "direction": "DESC",
      "order_by": "visitors",
      "limit": 10,
      "offset": 0,
      "effective_url": "example.com",
      "total": 2
  },
  "data": [
      {
          "subdomain_url": "news.example.com",
          "visitors": 45230,
          "visits": 62150,
          "avg_visit_duration": 185
      },
      {
          "subdomain_url": "blog.example.com",
          "visitors": 32150,
          "visits": 41200,
          "avg_visit_duration": 156
      }
  ]
}
Response example
CSV
subdomain_url;visitors;visits;avg_visit_duration
news.example.com;45230;62150;185
blog.example.com;32150;41200;156

Jump to List SubfoldersList Subfolders

Price: 20 API units per line

The List Subfolders report returns traffic data for the subfolders of a target domain. Use it to understand how traffic is distributed across different sections of a website.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/subfolders

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: https://samplesite.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER.

Example: ROOT_DOMAIN

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Example: DESKTOP

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state.

Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state.

Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Example: northern_europe

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion. Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Example: US_CA

Value/Type: string

path_contains

Path substring to filter subfolders by (for example, products to match /products/, /products/electronics/, etc.).

Example: products

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visits, entrances, entrances_share, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, page_views_per_visit, bounces_per_visit, avg_visit_duration.

The subfolder_url identity field is always returned and not selectable.

Example: visitors,visits,entrances

Value/Type: string[]

order_by

Field name to sort by.

Supported values: visitors, visits, entrances, entrances_share, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, page_views_per_visit, bounces_per_visit, avg_visit_duration. Default: entrances DESC.

Example: visitors

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Example: 100

Value/Type: integer

offset

Number of results to skip. Default: 0.

Example: 0

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Example: json

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of subfolders with traffic metrics.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/subfolders?url=samplesite.com&scope=ROOT_DOMAIN&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visits,entrances&order_by=visitors&direction=DESC&limit=10"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "country": "US",
      "month": "2024-06",
      "device_type": "DESKTOP",
      "scope": "ROOT_DOMAIN",
      "url": "samplesite.com",
      "direction": "DESC",
      "order_by": "visitors",
      "limit": 10,
      "offset": 0,
      "effective_url": "samplesite.com",
      "total": 2
  },
  "data": [
      {
          "subfolder_url": "https://samplesite.com/products/",
          "visitors": 8250,
          "visits": 12400,
          "entrances": 5890
      },
      {
          "subfolder_url": "https://samplesite.com/blog/",
          "visitors": 5120,
          "visits": 7340,
          "entrances": 3450
      }
  ]
}
Response example
CSV
subfolder_url;visitors;visits;entrances
https://samplesite.com/products/;8250;12400;5890
https://samplesite.com/blog/;5120;7340;3450

Jump to Get Trend DailyGet Trend Daily

Price: 200 API units per line

The Get Trend Daily report returns traffic metrics for a target over a date range, grouped by day. Use it to monitor traffic fluctuations, identify trends, and compare performance across time.

Data is updated daily with a 4-day delay.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/trend/daily

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: https://samplesite.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE.

Example: ROOT_DOMAIN

Value/Type: string

date_fromRequired

Start of the range. Format: YYYY-MM. Must not be earlier than 2017-01. The maximum range is 12 months.

Example: 2024-01

Value/Type: string

date_toRequired

End of the range. Format: YYYY-MM. The maximum range is 12 months.

Example: 2024-12

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state.

Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state.

Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion.

Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visits, entrances, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, page_views_per_visit, bounces_per_visit, purchases_per_visit, avg_visit_duration.

The date_from, date_to, and is_forecast identity fields are always returned and not selectable.

Example: visitors,visits,bounces_per_visit

Value/Type: string[]

include_forecast

Whether to include forecasted data in the response.

Value/Type: boolean

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Daily traffic trend data points.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/trend/daily?url=samplesite.com&scope=ROOT_DOMAIN&date_from=2024-01&date_to=2024-12&device_type=DESKTOP&country=US"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "url": "samplesite.com",
      "scope": "ROOT_DOMAIN",
      "date_from": "2024-01",
      "date_to": "2024-12",
      "device_type": "DESKTOP",
      "country": "US",
      "effective_url": "samplesite.com",
      "include_forecast": false,
      "total": 2
  },
  "data": [
      {
          "date_from": "2024-01-01T00:00:00Z",
          "date_to": "2024-01-01T23:59:59Z",
          "is_forecast": false,
          "metrics": {
              "visitors": 45230,
              "visits": 67450,
              "entrances": 12340,
              "entrances_direct": 5620,
              "entrances_search_organic": 4230,
              "entrances_search_paid": 1890,
              "entrances_social_organic": 290,
              "entrances_social_paid": 160,
              "entrances_referral": 170,
              "entrances_mail": 0,
              "entrances_display_ad": 0,
              "entrances_ai_assistants": 0,
              "exits": 11200,
              "page_views_per_visit": 2.14,
              "bounces_per_visit": 0.28,
              "purchases_per_visit": 0.05,
              "avg_visit_duration": 142
          }
      },
      {
          "date_from": "2024-01-02T00:00:00Z",
          "date_to": "2024-01-02T23:59:59Z",
          "is_forecast": false,
          "metrics": {
              "visitors": 48910,
              "visits": 71230,
              "entrances": 13450,
              "entrances_direct": 6100,
              "entrances_search_organic": 4560,
              "entrances_search_paid": 2010,
              "entrances_social_organic": 320,
              "entrances_social_paid": 180,
              "entrances_referral": 190,
              "entrances_mail": 0,
              "entrances_display_ad": 0,
              "entrances_ai_assistants": 0,
              "exits": 12100,
              "page_views_per_visit": 2.22,
              "bounces_per_visit": 0.26,
              "purchases_per_visit": 0.06,
              "avg_visit_duration": 148
          }
      }
  ]
}
Response example
CSV
date_from;date_to;is_forecast;visitors;visits;entrances;entrances_direct;entrances_search_organic;entrances_search_paid;entrances_social_organic;entrances_social_paid;entrances_referral;entrances_mail;entrances_display_ad;entrances_ai_assistants;exits;page_views_per_visit;bounces_per_visit;purchases_per_visit;avg_visit_duration
2024-01-01T00:00:00Z;2024-01-01T23:59:59Z;false;45230;67450;12340;5620;4230;1890;290;160;170;0;0;0;11200;2.14;0.28;0.05;142
2024-01-02T00:00:00Z;2024-01-02T23:59:59Z;false;48910;71230;13450;6100;4560;2010;320;180;190;0;0;0;12100;2.22;0.26;0.06;148

Jump to Get Trend MonthlyGet Trend Monthly

Price: 200 API units per line

The Get Trend Monthly report returns traffic metrics for a target over a date range, grouped by month. Use it to identify trends and compare performance across months.

Requesting data for the current (incomplete) month will result in an error.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/trend/monthly

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: https://samplesite.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE.

Example: ROOT_DOMAIN

Value/Type: string

date_fromRequired

Start of the range. Format: YYYY-MM. Must not be earlier than 2017-01. The maximum range is 12 months.

Example: 2024-01

Value/Type: string

date_toRequired

End of the range. Format: YYYY-MM. The maximum range is 12 months.

Example: 2024-12

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state.

Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state.

Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion.

Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visits, entrances, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, page_views_per_visit, bounces_per_visit, purchases_per_visit, avg_visit_duration.

The date_from, date_to, and is_forecast identity fields are always returned and not selectable.

Example: visitors,visits,entrances,page_views_per_visit

Value/Type: string[]

include_forecast

Whether to include forecasted data in the response.

Example: true

Value/Type: boolean

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Monthly traffic trend data points.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/trend/monthly?url=samplesite.com&scope=ROOT_DOMAIN&date_from=2024-01&date_to=2024-12&device_type=DESKTOP&country=US&fields=visitors,visits,entrances,page_views_per_visit&include_forecast=true"
Response example
JSON
{
  "meta": {
      "country": "US",
      "date_from": "2024-01",
      "date_to": "2024-12",
      "device_type": "DESKTOP",
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "scope": "ROOT_DOMAIN",
      "status_code": 200,
      "success": true,
      "effective_url": "samplesite.com",
      "include_forecast": true,
      "total": 3,
      "url": "samplesite.com"
  },
  "data": [
      {
          "date_from": "2024-01-01T00:00:00Z",
          "date_to": "2024-01-31T23:59:59Z",
          "is_forecast": false,
          "metrics": {
              "visitors": 8200,
              "visits": 9500,
              "entrances": 12500,
              "page_views_per_visit": 3.2
          }
      },
      {
          "date_from": "2024-06-01T00:00:00Z",
          "date_to": "2024-06-30T23:59:59Z",
          "is_forecast": false,
          "metrics": {
              "visitors": 9100,
              "visits": 10800,
              "entrances": 14200,
              "page_views_per_visit": 3.4
          }
      },
      {
          "date_from": "2024-12-01T00:00:00Z",
          "date_to": "2024-12-31T23:59:59Z",
          "is_forecast": true,
          "metrics": {
              "visitors": 8900,
              "visits": 10500,
              "entrances": 13800,
              "page_views_per_visit": 3.3
          }
      }
  ]
}
Response example
CSV
date_from;date_to;is_forecast;visitors;visits;entrances;page_views_per_visit
2024-01-01T00:00:00Z;2024-01-31T23:59:59Z;false;8200;9500;12500;3.2
2024-06-01T00:00:00Z;2024-06-30T23:59:59Z;false;9100;10800;14200;3.4
2024-12-01T00:00:00Z;2024-12-31T23:59:59Z;true;8900;10500;13800;3.3

Jump to Get Trend WeeklyGet Trend Weekly

Price: 200 API units per line

The Get Trend Weekly report returns traffic metrics for a target over a date range, grouped by week. Use it to monitor traffic fluctuations and identify trends across weeks.

Only complete Monday–Sunday weeks are included. Each week is attributed to the month in which it ends (Sunday). Requesting a month with no complete weeks results in an error.

Data is updated every Thursday for the preceding week.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/traffic/trend/weekly

Query parameters

urlRequired

Target URL to query. The length must not exceed 2000 characters. Accepts values both with the protocol (https://) and without it.

Example: example.com

Value/Type: string

scopeRequired

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE.

Example: ROOT_DOMAIN

Value/Type: string

date_fromRequired

Start of the range. Format: YYYY-MM. Must not be earlier than 2017-01. The maximum range is 12 months.

Weeks are attributed to the month in which they end (Sunday). A complete week that starts in the previous month and ends in this month is included. A week that starts in this month and ends in the next month is attributed to the next month and is not included here.

Example: for date_from=2024-02 and date_to=2024-02, the week of January 29–February 4 is included as a full week because it ends in February.

Example: 2024-01

Value/Type: string

date_toRequired

End of the range. Format: YYYY-MM. The maximum range is 12 months. Week attribution follows the same end-of-week (Sunday) rule as date_from.

Example: 2024-12

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Mutually exclusive with subregion and state. Default: worldwide if no region parameter is set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

subregion

Geographic subregion to filter by, using the UN geoscheme name in snake_case (for example, northern_africa, western_europe). Mutually exclusive with country and state. Default: worldwide if no region parameter is set.

Supported values: northern_africa, eastern_africa, middle_africa, southern_africa, western_africa, northern_america, central_america, south_america, caribbean, eastern_asia, central_asia, south_eastern_asia, southern_asia, western_asia, northern_europe, eastern_europe, southern_europe, western_europe, australia_and_new_zealand, melanesia, micronesia, polynesia.

Value/Type: string

state

US state to filter by, using the ISO 3166-2

code with the country prefix (for example, US_CA, US_NY). Mutually exclusive with country and subregion. Default: worldwide if no region parameter is set.

Supported values: US_AK, US_AL, US_AR, US_AZ, US_CA, US_CO, US_CT, US_DC, US_DE, US_FL, US_GA, US_HI, US_IA, US_ID, US_IL, US_IN, US_KS, US_KY, US_LA, US_MA, US_MD, US_ME, US_MI, US_MN, US_MO, US_MS, US_MT, US_NC, US_ND, US_NE, US_NH, US_NJ, US_NM, US_NV, US_NY, US_OH, US_OK, US_OR, US_PA, US_RI, US_SC, US_SD, US_TN, US_TX, US_UT, US_VA, US_VT, US_WA, US_WI, US_WV, US_WY.

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visits, entrances, entrances_direct, entrances_search_organic, entrances_search_paid, entrances_social_organic, entrances_social_paid, entrances_referral, entrances_mail, entrances_display_ad, entrances_ai_assistants, exits, page_views_per_visit, bounces_per_visit, purchases_per_visit, avg_visit_duration.

The date_from, date_to, and is_forecast identity fields are always returned and not selectable.

Example: visitors,visits,page_views_per_visit,avg_visit_duration

Value/Type: string[]

include_forecast

Whether to include forecasted data in the response.

Value/Type: boolean

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Weekly traffic trend data points.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/traffic/trend/weekly?url=example.com&scope=ROOT_DOMAIN&date_from=2024-01&date_to=2024-12&device_type=DESKTOP&fields=visitors,visits,page_views_per_visit,avg_visit_duration"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "url": "example.com",
      "scope": "ROOT_DOMAIN",
      "date_from": "2024-01",
      "date_to": "2024-12",
      "device_type": "DESKTOP",
      "effective_url": "example.com",
      "include_forecast": false,
      "total": 2
  },
  "data": [
      {
          "date_from": "2024-01-01T00:00:00Z",
          "date_to": "2024-01-07T23:59:59Z",
          "is_forecast": false,
          "metrics": {
              "visitors": 15000,
              "visits": 18500,
              "page_views_per_visit": 3.4,
              "avg_visit_duration": 245
          }
      },
      {
          "date_from": "2024-01-08T00:00:00Z",
          "date_to": "2024-01-14T23:59:59Z",
          "is_forecast": false,
          "metrics": {
              "visitors": 16200,
              "visits": 19800,
              "page_views_per_visit": 3.5,
              "avg_visit_duration": 251
          }
      }
  ]
}
Response example
CSV
date_from;date_to;is_forecast;visitors;visits;page_views_per_visit;avg_visit_duration
2024-01-01T00:00:00Z;2024-01-07T23:59:59Z;false;15000;18500;3.4;245
2024-01-08T00:00:00Z;2024-01-14T23:59:59Z;false;16200;19800;3.5;251

Jump to List Audience Age And Sex DistributionList Audience Age And Sex Distribution

Price: 20 API units per request

Returns the age and sex distribution of the audience for a target. Use it to understand the demographic composition of your target audience by age groups and sex.

Data is updated between the 7th and 10th of each month.

Cost: API units per request.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/age-and-sex-distribution

Query parameters

domainRequired

Domain to analyze.

Example: example.com

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visitors_share.

The age_sex_group identity field is always returned and not selectable.

Example: visitors,visitors_share

Value/Type: string[]

format

Response format. Use json (default) or csv. Supported values: json, csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Age and sex distribution data items.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/age-and-sex-distribution?domain=example.com&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visitors_share"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "example.com",
      "effective_domain": "example.com",
      "month": "2024-06",
      "country": "US",
      "device_type": "DESKTOP",
      "total": 3
  },
  "data": [
      {
          "age_sex_group": "MALE_18_24",
          "visitors": 42000,
          "visitors_share": 0.12
      },
      {
          "age_sex_group": "FEMALE_25_34",
          "visitors": 56000,
          "visitors_share": 0.16
      },
      {
          "age_sex_group": "MALE_35_44",
          "visitors": 49000,
          "visitors_share": 0.14
      }
  ]
}
Response example
CSV
age_sex_group;visitors;visitors_share
MALE_18_24;42000;0.12
FEMALE_25_34;56000;0.16
MALE_35_44;49000;0.14

Jump to List Audience Education DistributionList Audience Education Distribution

Price: 20 API units per request

The List Audience Education Distribution report returns education level data for a target’s audience. Use it to understand the educational background of your audience.

Data is updated between the 7th and 10th of each month.

Cost: API units per request.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/education-distribution

Query parameters

domainRequired

Domain to analyze.

Example: example.com

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visitors_share.

The education_level identity field is always returned and not selectable.

Example: visitors,visitors_share

Value/Type: string[]

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Education level distribution data. Each object represents one education level category.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/education-distribution?domain=example.com&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visitors_share"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "example.com",
      "effective_domain": "example.com",
      "month": "2024-06",
      "device_type": "DESKTOP",
      "country": "US",
      "total": 4
  },
  "data": [
      {
          "education_level": "UNIVERSITY",
          "visitors": 129800,
          "visitors_share": 0.3245
      },
      {
          "education_level": "POSTGRADUATE",
          "visitors": 92480,
          "visitors_share": 0.2312
      },
      {
          "education_level": "SCHOOL",
          "visitors": 161120,
          "visitors_share": 0.4028
      },
      {
          "education_level": "NONE_COMPLETED",
          "visitors": 16600,
          "visitors_share": 0.0415
      }
  ]
}
Response example
CSV
education_level;visitors;visitors_share
UNIVERSITY;129800;0.3245
POSTGRADUATE;92480;0.2312
SCHOOL;161120;0.4028
NONE_COMPLETED;16600;0.0415

Jump to List Audience Household DistributionList Audience Household Distribution

Price: 20 API units per request

Understand the household composition of your target audience by viewing the distribution of household sizes among visitors.

Data is updated between the 7th and 10th of each month.

Cost: API units per request.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/household-distribution

Query parameters

domainRequired

Domain to analyze.

Example: samplesite.com

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visitors_share.

The household_size identity field is always returned and not selectable.

Value/Type: string[]

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Household size distribution data.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/household-distribution?domain=samplesite.com&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visitors_share"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "samplesite.com",
      "effective_domain": "samplesite.com",
      "month": "2024-06",
      "device_type": "DESKTOP",
      "country": "US",
      "total": 3
  },
  "data": [
      {
          "household_size": "SIZE_1",
          "visitors": 126000,
          "visitors_share": 0.28
      },
      {
          "household_size": "SIZE_2",
          "visitors": 99000,
          "visitors_share": 0.22
      },
      {
          "household_size": "SIZE_3",
          "visitors": 85500,
          "visitors_share": 0.19
      }
  ]
}
Response example
CSV
household_size;visitors;visitors_share
SIZE_1;126000;0.28
SIZE_2;99000;0.22
SIZE_3;85500;0.19

Jump to List Audience Income DistributionList Audience Income Distribution

Price: 20 API units per request

Analyze the household income distribution of your target audience. Understand which income levels (LOW, MIDDLE, HIGH) comprise your visitors.

Data is updated between the 7th and 10th of each month.

Cost: API units per request.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/income-distribution

Query parameters

domainRequired

Domain to analyze.

Example: example.com

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visitors_share.

The income_level identity field is always returned and not selectable.

Example: visitors,visitors_share

Value/Type: string[]

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Income distribution data.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/income-distribution?domain=example.com&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visitors_share"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "example.com",
      "effective_domain": "example.com",
      "month": "2024-06",
      "country": "US",
      "device_type": "DESKTOP",
      "total": 3
  },
  "data": [
      {
          "income_level": "LOW",
          "visitors": 42000,
          "visitors_share": 0.28
      },
      {
          "income_level": "MIDDLE",
          "visitors": 82500,
          "visitors_share": 0.55
      },
      {
          "income_level": "HIGH",
          "visitors": 25500,
          "visitors_share": 0.17
      }
  ]
}
Response example
CSV
income_level;visitors;visitors_share
LOW;42000;0.28
MIDDLE;82500;0.55
HIGH;25500;0.17

Jump to List Audience InterestsList Audience Interests

Price: 20 API units per line

Returns the share of the target audience in each interest category. Use this to understand what topics engage your audience.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/interests

Query parameters

domainRequired

Domain to analyze.

Example: example.com

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visitors_share.

The category identity field is always returned and not selectable.

Example: visitors,visitors_share

Value/Type: string[]

order_by

Field name to sort by.

Supported values: visitors, visitors_share. Default: visitors DESC.

Example: visitors

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Value/Type: integer

offset

Number of results to skip. Default: 0.

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Interest category distribution data.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/interests?domain=example.com&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visitors_share&order_by=visitors&direction=DESC&limit=10&offset=0"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "example.com",
      "effective_domain": "example.com",
      "month": "2024-06",
      "device_type": "DESKTOP",
      "country": "US",
      "order_by": "visitors",
      "direction": "DESC",
      "limit": 10,
      "offset": 0,
      "total": 2,
      "total_count": 87
  },
  "data": [
      {
          "category": "ADVERTISING_AND_MARKETING",
          "visitors": 42500,
          "visitors_share": 0.3214
      },
      {
          "category": "COMPUTERS_AND_ELECTRONICS",
          "visitors": 28300,
          "visitors_share": 0.2145
      }
  ]
}
Response example
CSV
category;visitors;visitors_share
ADVERTISING_AND_MARKETING;42500;0.3214
COMPUTERS_AND_ELECTRONICS;28300;0.2145

Jump to List Audience Occupation DistributionList Audience Occupation Distribution

Price: 20 API units per request

Understand the occupational status distribution of your target audience. Returns a breakdown of visitors by occupational status (FULL_TIME_WORK, PART_TIME_WORK, OWN_BUSINESS, HOMEMAKER, STUDIES, PARENTAL_LEAVE, LEAVE_OF_ABSENCE, RETIRED, UNEMPLOYED).

Data is updated between the 7th and 10th of each month.

Cost: API units per request.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/occupation-distribution

Query parameters

domainRequired

Domain to analyze.

Example: example.com

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-06

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased. Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

fields

Metric fields to include in the response. Default: all fields.

Supported values: visitors, visitors_share.

The occupational_status identity field is always returned and not selectable.

Example: visitors,visitors_share

Value/Type: string[]

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Occupational status distribution data.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/occupation-distribution?domain=example.com&month=2024-06&device_type=DESKTOP&country=US&fields=visitors,visitors_share"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "example.com",
      "effective_domain": "example.com",
      "month": "2024-06",
      "country": "US",
      "device_type": "DESKTOP",
      "total": 4
  },
  "data": [
      {
          "occupational_status": "FULL_TIME_WORK",
          "visitors": 152040,
          "visitors_share": 0.5430
      },
      {
          "occupational_status": "PART_TIME_WORK",
          "visitors": 60060,
          "visitors_share": 0.2145
      },
      {
          "occupational_status": "STUDIES",
          "visitors": 33628,
          "visitors_share": 0.1201
      },
      {
          "occupational_status": "RETIRED",
          "visitors": 18816,
          "visitors_share": 0.0672
      }
  ]
}
Response example
CSV
occupational_status;visitors;visitors_share
FULL_TIME_WORK;152040;0.5430
PART_TIME_WORK;60060;0.2145
STUDIES;33628;0.1201
RETIRED;18816;0.0672

Jump to List Audience Social MediaList Audience Social Media

Price: 20 API units per line

The List Audience Social Media report returns traffic distribution data by social media platform for a target. Use it to understand which social media platforms your target audience visits.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/social-media

Query parameters

domainRequired

Target domain to analyze.

Example: example.com

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-08

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased.

Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

fields

Response fields to include. Default: all fields.

Supported values: visitors, visitors_share, root_domain.

The social_media_name identity field is always returned and not selectable.

Example: visitors,visitors_share

Value/Type: string[]

order_by

Field name to sort by. Supported values: visitors, visitors_share. Default: visitors DESC.

Example: visitors

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Value/Type: integer

offset

Number of results to skip. Default: 0.

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of social media platforms with traffic distribution data.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/social-media?domain=example.com&month=2024-08&device_type=DESKTOP&country=US&fields=visitors,visitors_share,root_domain&order_by=visitors&direction=DESC&limit=10"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domain": "example.com",
      "effective_domain": "example.com",
      "month": "2024-08",
      "device_type": "DESKTOP",
      "country": "US",
      "direction": "DESC",
      "order_by": "visitors",
      "limit": 10,
      "offset": 0,
      "total": 2,
      "total_count": 2
  },
  "data": [
      {
          "social_media_name": "Facebook",
          "root_domain": "facebook.com",
          "visitors": 125680,
          "visitors_share": 0.385
      },
      {
          "social_media_name": "Instagram",
          "root_domain": "instagram.com",
          "visitors": 98420,
          "visitors_share": 0.302
      }
  ]
}
Response example
CSV
social_media_name;root_domain;visitors;visitors_share
Facebook;facebook.com;125680;0.385
Instagram;instagram.com;98420;0.302

Jump to List Audience Visited DomainsList Audience Visited Domains

Price: 80 API units per line

Returns domains visited by the audience defined by the provided targets and criteria. Use it to discover audience overlap and find new market opportunities by analyzing what other sites your audience visits.

Data is updated between the 7th and 10th of each month.

Cost: API units per line returned.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/traffic-market/v1/audience/visited-domains

Query parameters

domain

Root domains to analyze.

Example: example.com

Value/Type: string[]

selected_domainsRequired

Root domains on which to apply the operation. The domains must be unique and correspond to those provided in domain. For DIFFERENCE, the number of selected domains must be less than the total in domain. For INTERSECTION, at least two selected domains are required.

Value/Type: string[]

operation

Set operation to apply to the target audiences. Default: UNION. Supported values: UNION, INTERSECTION, DIFFERENCE.

Example: UNION

Value/Type: string

monthRequired

Month to analyze. Format: YYYY-MM.

Example: 2024-01

Value/Type: string

device_type

Device type to filter by. Default: ALL when the parameter is omitted. Supported values: DESKTOP, MOBILE.

Value/Type: string

country

Country to filter by, using the ISO 3166-1 alpha-2 code, uppercased.

Default: worldwide if not set.

Supported values: AD, AE, AF, AG, AI, AL, AM, 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, YE, YT, ZA, ZM, ZW.

Example: US

Value/Type: string

categories

Filter domains by industry categories. Only domains matching at least one category are included.

Supported values: ACCOUNTING_AND_AUDITING, ADULT, ADVERTISING_AND_MARKETING, AEROSPACE_AND_DEFENSE, AGRICULTURE, AIRLINES, APPAREL_AND_FASHION, ARCHITECTURE, AUTOMOTIVE, BANKING, BEAUTY_AND_COSMETICS, BIOTECH, CERAMICS_AND_POTTERY, CHEMICALS, CIVIL_ENGINEERING, COMICS_AND_ANIMATION, COMPUTER_AND_VIDEO_GAMES, COMPUTER_HARDWARE, COMPUTER_SOFTWARE_AND_DEVELOPMENT, COMPUTERS_AND_ELECTRONICS, CONSTRUCTION_AND_MAINTENANCE, CONSULTING, CONSUMER_ELECTRONICS, CRAFTS, CUSTOMER_SERVICES, DESIGN, DISTANCE_LEARNING, ECOLOGY_AND_ENVIRONMENT, EDUCATION, ENTERTAINMENT, EQUIPMENT_AND_SUPPLIES, EVENTS_SERVICES, FACILITIES_SERVICES, FARMS_AND_RANCHES, FINANCE, FISHERY, FOOD_AND_BEVERAGES, FOREIGN_LANGUAGE, FURNITURE, GAMBLING, GOVERNMENT, GRAPHIC_DESIGN, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, IMPORT_AND_EXPORT, INFORMATION_TECHNOLOGY, INSURANCE, INVESTMENT, JEWELRY_AND_LUXURY_PRODUCTS, LEGAL, LIBRARIES, MACHINERY, MAIL_AND_PACKAGE_DELIVERY, MANUFACTURING, MARITIME, MARKET_RESEARCH, MASS_MEDIA, MEDICAL_DEVICES_AND_EQUIPMENT, MENTAL_HEALTH, METALS_AND_MINING, MILITARY, MUSEUMS, MUSIC, NANOTECHNOLOGY, NEWSPAPERS, NONPROFIT_ORGANIZATIONS, OIL_AND_GAS, ONLINE_SERVICES, OUTSOURCING, PACKAGING_AND_CONTAINERS, PERFORMING_ARTS, PHARMACEUTICALS, PHOTOGRAPHY, PLASTICS_AND_POLYMERS, POLITICAL_ORGANIZATIONS, PRINTING, PUBLIC_POLICY, PUBLIC_RELATIONS, PUBLIC_SAFETY, PUBLIC_UTILITY, PUBLISHING, REAL_ESTATE, RECREATIONAL_FACILITIES, RECRUITMENT_AND_STAFFING, REFERENCE, RELIGION_AND_BELIEF, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SCIENCE, SECURITY_PRODUCTS_AND_SERVICES, SOCIAL_AND_CHARITABLE_ORGANIZATIONS, SPORTING_GOODS, SPORTS, TELECOM, TEXTILES_AND_NONWOVENS, TOBACCO, TRAINING_AND_CERTIFICATION, TRANSPORTATION_AND_LOGISTICS, TRAVEL_AND_TOURISM, TV_AND_MOVIES, VENTURE_CAPITAL, VETERINARY, VISUAL_ART, WAREHOUSING, WELLNESS, WHOLESALERS_AND_LIQUIDATORS, WINE_AND_SPIRITS, WRITING_AND_EDITING_SERVICES.

Example: INFORMATION_TECHNOLOGY,FINANCE

Value/Type: string[]

fields

Response fields to include. Default: all fields.

Supported values: visitors, intersection_visitors, intersection_visitors_share, categories.

The root_domain identity field is always returned and not selectable.

Example: visitors,intersection_visitors,intersection_visitors_share,categories

Value/Type: string[]

order_by

Field name to sort by. Supported values: visitors, intersection_visitors, intersection_visitors_share. Default: intersection_visitors_share DESC.

Example: intersection_visitors

Value/Type: string

direction

Sort direction. Supported values: ASC, DESC.

Example: DESC

Value/Type: string

limit

Maximum number of results to return. Default: 1000. Maximum: 5000.

Value/Type: integer

offset

Number of results to skip. Default: 0.

Value/Type: integer

format

Response format. Supported values: json (default), csv.

Value/Type: string

Response Parameters

meta

Response metadata.

Value/Type: object

data

Array of visited domain records.

Value/Type: object[]

Request example
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/audience/visited-domains?domain=example.com&selected_domains=example.com&operation=UNION&month=2024-01&limit=10"
Response example
JSON
{
  "meta": {
      "request_id": "4fb1773ec2a8d61a0407f464599f897c",
      "status_code": 200,
      "success": true,
      "domains": ["example.com"],
      "effective_domains": ["example.com"],
      "selected_domains": ["example.com"],
      "operation": "UNION",
      "month": "2024-01",
      "limit": 10,
      "offset": 0,
      "total": 2,
      "total_count": 523
  },
  "data": [
      {
          "root_domain": "analytics.com",
          "visitors": 3480000,
          "intersection_visitors": 612000,
          "intersection_visitors_share": 0.14,
          "categories": ["INFORMATION_TECHNOLOGY"]
      },
      {
          "root_domain": "competitor.com",
          "visitors": 5230000,
          "intersection_visitors": 721000,
          "intersection_visitors_share": 0.12,
          "categories": ["INFORMATION_TECHNOLOGY", "FINANCE"]
      }
  ]
}
Response example
CSV
root_domain;visitors;intersection_visitors;intersection_visitors_share;categories
analytics.com;3480000;612000;0.14;INFORMATION_TECHNOLOGY
competitor.com;5230000;721000;0.12;INFORMATION_TECHNOLOGY,FINANCE

Last updated: November 20, 2026

Was this page helpful?