Semrush · Seo Aeo

Semrush / Trends: Traffic Sources

The Traffic Sources request lets you analyze website traffic sources from various channels. You can request data for direct, referral, search, social, email, and paid traffic, providing a comprehensive view of how visitors reach your competitors' websites. Even if a response is empty, the cost of one request will still be deducted from your API units. About the Traffic Distribution dashboards › Semrush charges 1 API unit per request from the separate Trends unit balance. Needs the Trends Premium plan only. Semrush answers CSV with semicolons.

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

country query · optional
The country code parameter lets you filter traffic data for a particular country. If the parameter isn't specified, global data is shown by default. To define a country code, use the ISO 3166-1 code reference , column Alpha-2 code . Example: "US"
device_type query · optional
This parameter lets you choose whether to retrieve desktop or mobile data. If the parameter isn't specified, data for all devices is shown by default.
display_date query · optional
Date in the YYYY-MM-01 format. If the display_date parameter isn't specified, data from the previous month is shown by default. The minimum value is 2017-01-01 and the maximum is the beginning of the previous month. For example, if today is June 19, 2024, you can use 2024-05-01 . Example: "2025-08-01"
display_limit query · optional
Number of results returned per request. If this parameter isn't specified, the default value is 1000 . Maximum value is 5000 . This limit applies per request only. To retrieve additional results, use this parameter together with display_offset .
display_offset query · optional
This parameter lets you skip a specified number of results before sending a report. Used for pagination together with display_limit . If this parameter isn't specified, the default value is 0 . Maximum value is 10000 .
export_columns query · optional
This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default. Allowed columns: target, from_target, display_date, country, device_type, traffic_share, traffic_diff, traffic, channel, traffic_type, search_engine, prev_traffic, categories
sort_order query · optional
This parameter lets you sort the data. For descending order, append _desc ; for ascending order, append _asc . If this parameter isn't specified, data is shown in descending order by default. Allowed bases: traffic, traffic_diff, traffic_share
target query · required
Root domain, subdomain, or subfolder. Example: "golang.org"
traffic_channel query · optional
This parameter lets you filter traffic sources by a specific channel type. If this parameter isn't specified, data for all traffic channels is shown by default.
traffic_type query · optional
This parameter allows you to retrieve organic or paid traffic. If this parameter isn't specified, data for all traffic types is shown by default.

No allowlisted official documentation or pricing reference is available.