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
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
domain
Domain from the request.
Example: samplesite.com
Value/Type: string
effective_domain
Root domain resolved from the request domain.
Example: samplesite.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
1 when the response has categories, 0 when the list is empty. Used for billing; not the number of category rows.
Value/Type: integer
data
Industry categories assigned to the domain, ordered by relevance.
Value/Type: object[]
category
Industry category assigned to the domain.
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: TRAVEL_AND_TOURISM
Value/Type: string
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/traffic-market/v1/domains/categories?domain=samplesite.com&format=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"
}
]
}category
TRAVEL_AND_TOURISM
HOSPITALITY
RESTAURANTSJump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
order_by
Field the results are sorted by.
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
subregion
Geographic subregion filter applied (if any).
Value/Type: string
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
categories
Industry categories from the request categories filter.
Example: INFORMATION_TECHNOLOGY
Value/Type: string[]
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
effective_url
Normalized target URL resolved from the request url and scope.
Example: example.com
Value/Type: string
url
The url value sent in the request.
Example: example.com
Value/Type: string
data
Array of traffic destinations.
Value/Type: object[]
destination_url
The destination URL.
Value/Type: string
entrances
Number of entrances to this destination.
Value/Type: integer
entrances_share
Share of entrance visits to this destination among all destination entrances from the target (ratio, 0.0 to 1.0).
Value/Type: number
categories
Industry categories for this destination.
Example: ["TRAVEL_AND_TOURISM","HOSPITALITY"]
Value/Type: string[]
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"{
"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"]
}
]
}destination_url;entrances;entrances_share;categories
competitor.com;1250;0.453;TRAVEL_AND_TOURISM,HOSPITALITY
news-site.com;850;0.308;MASS_MEDIA,NEWSPAPERSJump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
order_by
Field the results are sorted by.
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
subregion
Geographic subregion filter applied (if any).
Value/Type: string
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
path_contains
Path substring used to filter pages.
Example: blog
Value/Type: string
effective_url
Normalized target URL resolved from the request url and scope.
Example: samplesite.com
Value/Type: string
url
The url value sent in the request.
Example: samplesite.com
Value/Type: string
data
Array of pages with traffic metrics.
Value/Type: object[]
page_url
The URL of the page.
Example: https://samplesite.com/blog/post-1
Value/Type: string
visitors
Number of unique visitors (unique browsers) to the page.
Value/Type: integer
visits
Number of visits (sessions) to the page. A visit is a series of page views by a single visitor on the same website. A visit ends when the visitor leaves the website or after 30 minutes of inactivity.
Value/Type: integer
entrances
Number of entrances to the page.
Value/Type: integer
entrances_share
Share of entrances among all target entrances (ratio, 0.0 to 1.0).
Value/Type: number
entrances_direct
Number of direct entrances.
Value/Type: integer
entrances_search_organic
Number of organic search entrances.
Value/Type: integer
entrances_search_paid
Number of paid search entrances.
Value/Type: integer
entrances_social_organic
Number of organic social entrances.
Value/Type: integer
entrances_social_paid
Number of paid social entrances.
Value/Type: integer
entrances_referral
Number of referral entrances.
Value/Type: integer
entrances_mail
Number of email entrances.
Value/Type: integer
entrances_display_ad
Number of display ad entrances.
Value/Type: integer
entrances_ai_assistants
Number of AI assistant entrances.
Value/Type: integer
exits
Number of exits from the page.
Value/Type: integer
bounces_per_visit
Bounce rate: Share of visits consisting of a single page view (ratio, 0.0 to 1.0).
Value/Type: number
avg_visit_duration
Average visit duration in seconds.
Value/Type: integer
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"{
"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
}
]
}page_url;visitors;visits;entrances
https://samplesite.com/;15240;28650;12540
https://samplesite.com/blog;8920;14350;7280Jump 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
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
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
order_by
Field the results are sorted by.
Value/Type: string
region_type
Type of regional grouping applied to the results.
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
effective_url
Normalized target URL resolved from the request url and scope.
Example: samplesite.com
Value/Type: string
url
The url value sent in the request.
Example: samplesite.com
Value/Type: string
data
Array of regions with traffic metrics.
Value/Type: object[]
region_code
Fully qualified region code. Format depends on region_type: country code (for example, US), subregion (for example, western_europe), or US state (for example, US_CA).
Example: US
Value/Type: string
visitors
Number of unique visitors (unique browsers) from the region.
Value/Type: integer
visits
Number of visits (sessions) from the region. A visit is a series of page views by a single visitor on the same website. A visit ends when the visitor leaves the website or after 30 minutes of inactivity.
Value/Type: integer
entrances
Number of entrance visits from the region.
Value/Type: integer
entrances_share
Share of entrance visits from the region among all target entrances (ratio, 0.0 to 1.0).
Example: 0.485
Value/Type: number
page_views_per_visit
Average page views per visit.
Value/Type: number
bounces_per_visit
Bounce rate: Share of visits consisting of a single page view (ratio, 0.0 to 1.0).
Value/Type: number
avg_visit_duration
Average visit duration in seconds.
Value/Type: integer
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®ion_type=COUNTRY&device_type=DESKTOP&fields=visitors,visits,entrances&order_by=visitors&direction=DESC&limit=10&offset=0"{
"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
}
]
}region_code;visitors;visits;entrances
US;85420;102300;48500
GB;32180;38900;18200Jump 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
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
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
effective_url
Normalized target URL resolved from the request url and scope.
Example: example.com
Value/Type: string
url
The url value sent in the request.
Example: example.com
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
subregion
Geographic subregion filter applied (if any).
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
channel
Traffic channel filter applied (if any).
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
order_by
Field the results are sorted by.
Example: entrances
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
total
Number of rows returned in data.
Value/Type: integer
categories
Industry categories from the request categories filter.
Example: INFORMATION_TECHNOLOGY
Value/Type: string[]
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
data
Array of traffic sources.
Value/Type: object[]
source_url
URL of the traffic source.
Example: google.com
Value/Type: string
source_display_name
Human-readable name of the source.
Example: Google
Value/Type: string
channel
Traffic channel (for example, SEARCH_ORGANIC, REFERRAL, DIRECT).
Example: SEARCH_ORGANIC
Value/Type: string
entrances
Number of entrance visits from this source.
Example: 45230
Value/Type: integer
entrances_share
Share of entrance visits from this source among all entrances (ratio, 0.0 to 1.0).
Example: 0.425
Value/Type: number
categories
Industry categories of the source.
Example: ["ONLINE_SERVICES","INFORMATION_TECHNOLOGY"]
Value/Type: string[]
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"{
"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"]
}
]
}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_SERVICESJump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Example: 2024-01
Value/Type: string
device_type
Device type filter applied (if any).
Example: DESKTOP
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
limit
Maximum number of rows requested.
Example: 10
Value/Type: integer
offset
Number of rows skipped.
Example: 0
Value/Type: integer
order_by
Field the results are sorted by.
Example: visitors
Value/Type: string
request_id
Unique request identifier.
Example: 4fb1773ec2a8d61a0407f464599f897c
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
status_code
HTTP status code.
Example: 200
Value/Type: integer
subregion
Geographic subregion filter applied (if any).
Value/Type: string
success
Whether the request succeeded.
Example: true
Value/Type: boolean
total
Number of rows returned in data.
Example: 2
Value/Type: integer
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
effective_url
Normalized target URL resolved from the request url and scope.
Example: example.com
Value/Type: string
url
The url value sent in the request.
Example: example.com
Value/Type: string
data
Array of subdomain traffic metrics.
Value/Type: object[]
subdomain_url
Subdomain URL.
Example: news.example.com
Value/Type: string
visitors
Number of unique visitors (unique browsers).
Example: 45230
Value/Type: integer
visits
Number of visits (sessions). A visit is a series of page views by a single visitor on the same website. A visit ends when the visitor leaves the website or after 30 minutes of inactivity.
Example: 62150
Value/Type: integer
entrances
Total number of session entrances.
Example: 58900
Value/Type: integer
entrances_share
Share of total entrances as a decimal.
Example: 0.47
Value/Type: number
entrances_direct
Entrances from direct traffic.
Example: 12450
Value/Type: integer
entrances_search_organic
Entrances from organic search.
Example: 28600
Value/Type: integer
entrances_search_paid
Entrances from paid search.
Example: 8320
Value/Type: integer
entrances_social_organic
Entrances from organic social.
Example: 5200
Value/Type: integer
entrances_social_paid
Entrances from paid social.
Example: 2100
Value/Type: integer
entrances_referral
Entrances from referral traffic.
Example: 4850
Value/Type: integer
entrances_mail
Entrances from email.
Example: 1280
Value/Type: integer
entrances_display_ad
Entrances from display ads.
Example: 890
Value/Type: integer
entrances_ai_assistants
Entrances from AI assistants.
Example: 150
Value/Type: integer
exits
Total number of session exits.
Example: 41200
Value/Type: integer
page_views_per_visit
Average page views per visit.
Example: 3.42
Value/Type: number
bounces_per_visit
Bounce rate: Share of visits consisting of a single page view (ratio, 0.0 to 1.0).
Example: 0.38
Value/Type: number
avg_visit_duration
Average visit duration in seconds.
Example: 185
Value/Type: integer
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"{
"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
}
]
}subdomain_url;visitors;visits;avg_visit_duration
news.example.com;45230;62150;185
blog.example.com;32150;41200;156Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Example: 2024-06
Value/Type: string
device_type
Device type filter applied (if any).
Example: DESKTOP
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
order_by
Field the results are sorted by.
Example: visitors
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
subregion
Geographic subregion filter applied (if any).
Value/Type: string
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
path_contains
Path substring used to filter subfolders.
Example: products
Value/Type: string
effective_url
Normalized target URL resolved from the request url and scope.
Example: samplesite.com
Value/Type: string
url
The url value sent in the request.
Example: samplesite.com
Value/Type: string
data
Array of subfolders with traffic metrics.
Value/Type: object[]
subfolder_url
URL of the subfolder (for example, example.com/subfolder/, example.com/subfolder2/).
Example: https://samplesite.com/products/
Value/Type: string
visitors
Number of unique visitors (unique browsers) that visited the subfolder.
Value/Type: integer
visits
Number of visits (sessions) to the subfolder. A visit is a series of page views by a single visitor on the same website. A visit ends when the visitor leaves the website or after 30 minutes of inactivity.
Value/Type: integer
entrances
Number of entrance visits where the visitor’s first page view was within the subfolder.
Value/Type: integer
entrances_share
Share of entrance visits among all target entrances (ratio, 0.0 to 1.0).
Value/Type: number
entrances_direct
Number of entrance visits via direct navigation (typed URL, bookmark, etc.).
Value/Type: integer
entrances_search_organic
Number of entrance visits via organic (unpaid) search.
Value/Type: integer
entrances_search_paid
Number of entrance visits via paid search ads (Google Ads, Bing Ads, etc.).
Value/Type: integer
entrances_social_organic
Number of entrance visits via unpaid social media links.
Value/Type: integer
entrances_social_paid
Number of entrance visits via paid social media ads.
Value/Type: integer
entrances_referral
Number of entrance visits via links on other websites.
Value/Type: integer
entrances_mail
Number of entrance visits via email campaigns.
Value/Type: integer
entrances_display_ad
Number of entrance visits via display advertising (banners, etc.).
Value/Type: integer
entrances_ai_assistants
Number of entrance visits via AI assistant services (ChatGPT, Copilot, etc.).
Value/Type: integer
exits
Number of exit visits where the visitor’s last page view was within the subfolder before leaving the website. The counterpart to entrances: measures how often the subfolder is the final destination in a browsing session.
Value/Type: integer
page_views_per_visit
Average number of page views per visit.
Value/Type: number
bounces_per_visit
Bounce rate: Share of visits consisting of a single page view (ratio, 0.0 to 1.0).
Value/Type: number
avg_visit_duration
Average visit duration in seconds.
Value/Type: integer
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"{
"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
}
]
}subfolder_url;visitors;visits;entrances
https://samplesite.com/products/;8250;12400;5890
https://samplesite.com/blog/;5120;7340;3450Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
date_from
Start date of the range requested.
Example: 2024-01
Value/Type: string
date_to
End date of the range requested.
Example: 2024-12
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
subregion
Geographic subregion filter applied (if any).
Value/Type: string
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
effective_url
Normalized target URL resolved from the request url and scope.
Example: samplesite.com
Value/Type: string
include_forecast
Whether the response includes forecasted data.
Value/Type: boolean
url
The url value sent in the request.
Example: samplesite.com
Value/Type: string
data
Daily traffic trend data points.
Value/Type: object[]
date_from
Start of the date period. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
Example: 2024-01-01T00:00:00Z
Value/Type: string
date_to
End of the date period. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
Example: 2024-01-01T23:59:59Z
Value/Type: string
is_forecast
Whether this data point is a forecast.
Value/Type: boolean
metrics
The traffic metrics for this period.
Value/Type: object
visitors
Number of unique visitors (unique browsers) in the period.
Value/Type: integer
visits
Number of visits (sessions) in the period. A visit is a series of page views by a single visitor on the same website. A visit ends when the visitor leaves the website or after 30 minutes of inactivity.
Value/Type: integer
entrances
Number of entrance visits in the period.
Value/Type: integer
entrances_direct
Entrances via direct navigation.
Value/Type: integer
entrances_search_organic
Entrances via organic search.
Value/Type: integer
entrances_search_paid
Entrances via paid search.
Value/Type: integer
entrances_social_organic
Entrances via unpaid social media.
Value/Type: integer
entrances_social_paid
Entrances via paid social media.
Value/Type: integer
entrances_referral
Entrances via referral links.
Value/Type: integer
entrances_mail
Entrances via email campaigns.
Value/Type: integer
entrances_display_ad
Entrances via display advertising.
Value/Type: integer
entrances_ai_assistants
Entrances via AI assistant services.
Value/Type: integer
exits
Number of exit visits in the period.
Value/Type: integer
page_views_per_visit
Average page views per visit.
Value/Type: number
bounces_per_visit
Bounce rate: Share of visits consisting of a single page view (ratio, 0.0 to 1.0).
Value/Type: number
purchases_per_visit
Average purchases per visit.
Value/Type: number
avg_visit_duration
Average visit duration in seconds.
Value/Type: integer
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"{
"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
}
}
]
}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;148Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
date_from
Start date of the range requested.
Example: 2024-01
Value/Type: string
date_to
End date of the range requested.
Example: 2024-12
Value/Type: string
device_type
Device type filter applied (if any).
Example: DESKTOP
Value/Type: string
request_id
Unique request identifier.
Example: 4fb1773ec2a8d61a0407f464599f897c
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
subregion
Geographic subregion filter applied (if any).
Value/Type: string
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
effective_url
Normalized target URL resolved from the request url and scope.
Example: samplesite.com
Value/Type: string
include_forecast
Whether the response includes forecasted data.
Value/Type: boolean
url
The url value sent in the request.
Example: samplesite.com
Value/Type: string
data
Monthly traffic trend data points.
Value/Type: object[]
date_from
Start of the date period. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
Example: 2024-01-01T00:00:00Z
Value/Type: string
date_to
End of the date period. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
Example: 2024-01-31T23:59:59Z
Value/Type: string
is_forecast
Whether this data point is a forecast.
Example: false
Value/Type: boolean
metrics
Value/Type: object
visitors
Number of unique visitors (unique browsers).
Example: 8200
Value/Type: integer
visits
Number of visits (sessions). A visit is a series of page views by a single visitor on the same website. A visit ends when the visitor leaves the website or after 30 minutes of inactivity.
Example: 9500
Value/Type: integer
entrances
Total number of entrances to the website.
Example: 12500
Value/Type: integer
entrances_direct
Direct entrances.
Example: 3200
Value/Type: integer
entrances_search_organic
Entrances from organic search.
Example: 4500
Value/Type: integer
entrances_search_paid
Entrances from paid search.
Example: 1200
Value/Type: integer
entrances_social_organic
Entrances from organic social media.
Example: 550
Value/Type: integer
entrances_social_paid
Entrances from paid social media.
Example: 340
Value/Type: integer
entrances_referral
Entrances from referral sources.
Example: 2100
Value/Type: integer
entrances_mail
Entrances from email.
Example: 125
Value/Type: integer
entrances_display_ad
Entrances from display advertising.
Example: 890
Value/Type: integer
entrances_ai_assistants
Entrances from AI assistants.
Example: 145
Value/Type: integer
exits
Total number of exits from the website.
Example: 11800
Value/Type: integer
page_views_per_visit
Average page views per visit.
Example: 3.2
Value/Type: number
bounces_per_visit
Bounce rate: Share of visits consisting of a single page view (ratio, 0.0 to 1.0).
Example: 0.42
Value/Type: number
purchases_per_visit
Average purchases per visit.
Example: 0.08
Value/Type: number
avg_visit_duration
Average visit duration in seconds.
Example: 245
Value/Type: integer
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"{
"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
}
}
]
}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.3Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
date_from
Start date of the range requested.
Example: 2024-01
Value/Type: string
date_to
End date of the range requested.
Example: 2024-12
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
scope
URL scope analyzed.
Example: ROOT_DOMAIN
Value/Type: string
state
US state filter applied (if any).
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
subregion
Geographic subregion filter applied (if any).
Value/Type: string
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
effective_url
Normalized target URL resolved from the request url and scope.
Example: example.com
Value/Type: string
include_forecast
Whether the response includes forecasted data.
Value/Type: boolean
url
The url value sent in the request.
Example: example.com
Value/Type: string
data
Weekly traffic trend data points.
Value/Type: object[]
date_from
Start of the date period. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
Example: 2024-01-01T00:00:00Z
Value/Type: string
date_to
End of the date period. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
Example: 2024-01-07T23:59:59Z
Value/Type: string
is_forecast
Whether this data point is a forecast.
Value/Type: boolean
metrics
Traffic metrics for this period.
Value/Type: object
visitors
Number of unique visitors (unique browsers) in the period.
Value/Type: integer
visits
Number of visits (sessions) in the period. A visit is a series of page views by a single visitor on the same website. A visit ends when the visitor leaves the website or after 30 minutes of inactivity.
Value/Type: integer
entrances
Number of entrance visits in the period.
Value/Type: integer
entrances_direct
Entrances via direct navigation.
Value/Type: integer
entrances_search_organic
Entrances via organic search.
Value/Type: integer
entrances_search_paid
Entrances via paid search.
Value/Type: integer
entrances_social_organic
Entrances via unpaid social media.
Value/Type: integer
entrances_social_paid
Entrances via paid social media.
Value/Type: integer
entrances_referral
Entrances via referral links.
Value/Type: integer
entrances_mail
Entrances via email campaigns.
Value/Type: integer
entrances_display_ad
Entrances via display advertising.
Value/Type: integer
entrances_ai_assistants
Entrances via AI assistant services.
Value/Type: integer
exits
Number of exit visits in the period.
Value/Type: integer
page_views_per_visit
Average page views per visit.
Value/Type: number
bounces_per_visit
Bounce rate: Share of visits consisting of a single page view (ratio, 0.0 to 1.0).
Value/Type: number
purchases_per_visit
Average purchases per visit.
Value/Type: number
avg_visit_duration
Average visit duration in seconds.
Value/Type: integer
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"{
"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
}
}
]
}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;251Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
domain
Domain analyzed.
Example: example.com
Value/Type: string
effective_domain
Root domain resolved from the request domain.
Example: example.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
data
Age and sex distribution data items.
Value/Type: object[]
age_sex_group
The age and sex demographic group. Possible values: MALE_18_24, MALE_25_34, MALE_35_44, MALE_45_54, MALE_55_64, MALE_65_PLUS, FEMALE_18_24, FEMALE_25_34, FEMALE_35_44, FEMALE_45_54, FEMALE_55_64, FEMALE_65_PLUS.
Example: MALE_18_24
Value/Type: string
visitors
Number of unique visitors (unique browsers) in this age and sex group.
Value/Type: integer
visitors_share
Share of visitors in this age and sex group among all target visitors (ratio, 0.0 to 1.0).
Example: 0.12
Value/Type: number
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"{
"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
}
]
}age_sex_group;visitors;visitors_share
MALE_18_24;42000;0.12
FEMALE_25_34;56000;0.16
MALE_35_44;49000;0.14Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Example: DESKTOP
Value/Type: string
domain
Target domain analyzed.
Example: example.com
Value/Type: string
effective_domain
Root domain resolved from the request domain.
Example: example.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
data
Education level distribution data. Each object represents one education level category.
Value/Type: object[]
education_level
Education level. Possible values: NONE_COMPLETED, SCHOOL, UNIVERSITY, POSTGRADUATE.
Example: UNIVERSITY
Value/Type: string
visitors
Number of unique visitors (unique browsers) in this education level.
Value/Type: integer
visitors_share
Share of visitors in this education level among all target visitors (ratio, 0.0 to 1.0).
Example: 0.3245
Value/Type: number
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"{
"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
}
]
}education_level;visitors;visitors_share
UNIVERSITY;129800;0.3245
POSTGRADUATE;92480;0.2312
SCHOOL;161120;0.4028
NONE_COMPLETED;16600;0.0415Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
domain
Domain analyzed.
Example: samplesite.com
Value/Type: string
effective_domain
Root domain resolved from the request domain.
Example: samplesite.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
data
Household size distribution data.
Value/Type: object[]
household_size
Household size category. Possible values: SIZE_1, SIZE_2, SIZE_3, SIZE_4, SIZE_5, SIZE_6, SIZE_7, SIZE_8, SIZE_9, SIZE_10_PLUS.
Value/Type: string
visitors
Number of unique visitors (unique browsers) in this household size.
Value/Type: integer
visitors_share
Share of visitors in this household size among all target visitors (ratio, 0.0 to 1.0).
Value/Type: number
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"{
"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
}
]
}household_size;visitors;visitors_share
SIZE_1;126000;0.28
SIZE_2;99000;0.22
SIZE_3;85500;0.19Jump 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
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
domain
Target domain analyzed.
Example: example.com
Value/Type: string
month
Month analyzed.
Value/Type: string
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
device_type
Device type filter applied (if any).
Example: DESKTOP
Value/Type: string
effective_domain
Root domain resolved from the request domain.
Example: example.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
data
Income distribution data.
Value/Type: object[]
income_level
Household income level category. Possible values: LOW, MIDDLE, HIGH.
Example: LOW
Value/Type: string
visitors
Number of unique visitors (unique browsers) in this income level.
Value/Type: integer
visitors_share
Share of visitors in this income level among all target visitors (ratio, 0.0 to 1.0).
Value/Type: number
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"{
"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
}
]
}income_level;visitors;visitors_share
LOW;42000;0.28
MIDDLE;82500;0.55
HIGH;25500;0.17Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if specified).
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
domain
Domain analyzed.
Example: example.com
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
order_by
Field the results are sorted by.
Value/Type: string
effective_domain
Root domain resolved from the request domain.
Example: example.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
total_count
Total number of interest categories matching the request, ignoring limit and offset.
Value/Type: integer
data
Interest category distribution data.
Value/Type: object[]
category
Interest category (e.g., ACCOUNTING_AND_AUDITING, ADVERTISING_AND_MARKETING, AEROSPACE_AND_DEFENSE).
Value/Type: string
visitors
Number of unique visitors (unique browsers) in this interest category.
Value/Type: integer
visitors_share
Share of visitors in this interest category among all target visitors (ratio, 0.0 to 1.0).
Value/Type: number
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"{
"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
}
]
}category;visitors;visitors_share
ADVERTISING_AND_MARKETING;42500;0.3214
COMPUTERS_AND_ELECTRONICS;28300;0.2145Jump 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
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
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Example: DESKTOP
Value/Type: string
domain
Domain analyzed.
Example: example.com
Value/Type: string
effective_domain
Root domain resolved from the request domain.
Example: example.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
total
Number of rows returned in data.
Value/Type: integer
data
Occupational status distribution data.
Value/Type: object[]
occupational_status
Occupational status category. Possible values: FULL_TIME_WORK, PART_TIME_WORK, OWN_BUSINESS, HOMEMAKER, STUDIES, PARENTAL_LEAVE, LEAVE_OF_ABSENCE, RETIRED, UNEMPLOYED.
Value/Type: string
visitors
Number of unique visitors (unique browsers) in this occupational status.
Value/Type: integer
visitors_share
Share of visitors in this occupational status among all target visitors (ratio, 0.0 to 1.0).
Example: 0.3245
Value/Type: number
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"{
"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
}
]
}occupational_status;visitors;visitors_share
FULL_TIME_WORK;152040;0.5430
PART_TIME_WORK;60060;0.2145
STUDIES;33628;0.1201
RETIRED;18816;0.0672Jump 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
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
effective_domain
Root domain resolved from the request domain.
Example: example.com
Value/Type: string
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
domain
Target domain analyzed.
Example: example.com
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
order_by
Field the results are sorted by.
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
total
Number of rows returned in data.
Value/Type: integer
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
data
Array of social media platforms with traffic distribution data.
Value/Type: object[]
social_media_name
The name of the social media platform.
Example: Facebook
Value/Type: string
root_domain
The root domain of the social media platform.
Example: facebook.com
Value/Type: string
visitors
Number of unique visitors (unique browsers) from the target audience who also visited this social media platform.
Example: 125680
Value/Type: integer
visitors_share
Share of the target audience who also visited this social media platform (ratio, 0.0 to 1.0).
Example: 0.385
Value/Type: number
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"{
"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
}
]
}social_media_name;root_domain;visitors;visitors_share
Facebook;facebook.com;125680;0.385
Instagram;instagram.com;98420;0.302Jump 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
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
request_id
Unique request identifier.
Value/Type: string
status_code
HTTP status code.
Value/Type: integer
success
Whether the request succeeded.
Value/Type: boolean
domains
Root domains analyzed.
Example: example.com
Value/Type: string[]
effective_domains
Root domains resolved from the request domains.
Example: example.com
Value/Type: string[]
selected_domains
Root domains on which the operation was applied.
Value/Type: string[]
operation
Set operation applied to the audiences.
Example: UNION
Value/Type: string
month
Month analyzed.
Value/Type: string
device_type
Device type filter applied (if any).
Value/Type: string
country
Country code used to filter the results, if specified.
Example: US
Value/Type: string
direction
Sort direction applied to the results.
Example: DESC
Value/Type: string
order_by
Field the results are sorted by.
Value/Type: string
limit
Maximum number of rows requested.
Value/Type: integer
offset
Number of rows skipped.
Value/Type: integer
total
Number of rows returned in data.
Value/Type: integer
categories
Industry categories from the request categories filter.
Example: INFORMATION_TECHNOLOGY
Value/Type: string[]
total_count
Total number of rows matching the request, ignoring limit and offset.
Value/Type: integer
data
Array of visited domain records.
Value/Type: object[]
root_domain
The domain name (for example, example.com).
Value/Type: string
visitors
Number of unique visitors (unique browsers) that visited the domain.
Value/Type: integer
intersection_visitors
Total number of unique visitors who visit both this domain and the audience built from the selected request targets using the specified set operation.
Value/Type: integer
intersection_visitors_share
Share of overlap relative to the union of this domain and the target audience:
intersection_visitors / union_visitors, where
union_visitors = visitors + audience_visitors − intersection_visitors.
audience_visitors is the size of the audience built from the request targets and set operation. It’s the same for every row and is not returned as a field.
Value/Type: number
categories
Industry categories of the domain (for example, FINANCE, INFORMATION_TECHNOLOGY).
Value/Type: string[]
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"{
"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"]
}
]
}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,FINANCELast updated: November 20, 2026