Knowledge Base
API
.Trends API

.Trends API

The .Trends API allows you to pull raw Semrush .Trends data directly into your own in-house systems, interfaces, or spreadsheets. Here are just a few ways you can leverage it to benefit your business:

  • Keep an eye on the market and your competitors’ achievements;
  • Evaluate new markets and potential partners and investment opportunities;
  • Quickly qualify leads;
  • Get extra data on prospects for your sales team;
  • Empower your SaaS offering with Semrush data.

The .Trends API is available at two levels:

  1. .Trends Basic API: Offers access to broad traffic summaries that include website traffic metrics and user behavior data
  2. .Trends Premium API: Offers everything included in the .Trends Basic API, along with 16 additional data types that allow you to dig deeper into market dynamics, competitor strategies, and web traffic flows 

Please note: In addition to these two models, custom packages and pricing are available when you contact a sales representative by phone or email at [email protected]

.Trends API Subscription Plans

Semrush .Trends API comes in two subscription plans based on the level of data supplied:

  • .Trends Basic: provides only traffic and user behavior data. 
  • .Trends Premium: provides traffic and user behavior data + 16 additional data types.   

.Trends Basic API

The .Trends Basic API provides estimates of a website's traffic and visitor behavior. These include monthly visits, unique visits, pages per visit, average visit duration, mobile vs. desktop traffic %, bounce rate, and a domain's category.

In the same way as the platform, the Traffic Analytics Overview report can compare up to 5 domains at a time. You can pull this data for up to 200 domains in a single request using the Summary reports. This data gives you a quick look into the general level of interaction between a website and its visitors.

.Trends Premium API

The .Trends Premium API (full details in the API documentation) offers 16 distinct reports in addition to the Traffic Overview data from the .Trends Basic API:

  • Daily Traffic: The volume of website visitors tracked on a daily basis.
  • Weekly Traffic: The volume of website visitors tracked on a weekly basis.
  • Purchase Conversion: The percentage of visitors who complete a desired action, such as making a purchase.
  • Industry Categories: The various industry sectors from which website visitors originate.
  • Traffic Sources: The website traffic broken down into direct, referral, organic search, paid search, organic social, paid social, email, and display advertising.
  • Traffic Destinations: Where users are going after visiting the domain you are looking at.
  • Subdomain Traffic: The subdomains of the website that are responsible for acquiring the most traffic.
  • Subfolder Traffic: The subfolders of the website that are getting the most traffic.
  • Geographic Distribution: The countries, regions, or subcontinents where a website gets most of its visitors.
  • Top Pages: The number of unique page views, unique visitors, entrances, and traffic sources for up to a site’s top 1000 pages based on traffic.
  • Traffic Rank: Top websites in the target location for the target period sorted by traffic.
  • Audience Insights: Additional visited domains, shared audience %, and shared audience for the domains you entered.
  • Age and Sex Distribution: The number and share of male and female users and their distribution by age.
  • Household Size, Income, Education, and Occupation Distributions:
    • Household Size Distribution: A breakdown of the domain’s audience by the household size.
    • Income Distribution: The number and share of the users with low, middle, or high income.
    • Education Distribution: The number and share of the users that have postgraduate, university/college, school or have not completed education.
    • Occupation Distribution: A breakdown of the domain’s audience by employment status.
  • Audience Interests: The key interests of your target audience based on the categories of domains visited.
  • Social Media Preferences: The social media platforms visited most often by the market audience.

This data will show you more in-depth details of a website’s traffic, as well as up-to-date insights through daily and weekly data, allowing for a more comprehensive study of a domain’s traffic and nuanced views of the traffic trends. 

You can analyze traffic by source (direct, referral, organic search, paid search, organic social, paid social, email, and display advertising) and geographic location - including the top social network sites and search engines sending traffic to a site. This will tell you where a domain’s predominant market comes from online.

Subdomains will give insight into how a domain structures its website to attract visitors, and traffic destinations will show you what sites these people visit most often directly after the queried site.

With all this information, you could create a fantastic dashboard to study and compare websites, analyze their strategies, and react fast to competitor activity.

Please read the Semrush .Trends user manual for more information on all of the data included in these API packages. 

How to Buy The .Trends API?

You can access our .Trends API on the ‘Subscription info’ page if interested. Go to the bottom of the page, choose your plan, and click ‘Buy .Trends API’.*

The Subscription info page with the .Trends API section highlighted.

*Please note that .Trends API is available only to paid Semrush users.

After the purchase, you’ll receive your API key via email.

You can also contact [email protected] anytime, and we’ll provide you with a quote that fits your needs.

.Trends API Limits

The .Trends API is offered on a quarterly subscription. Each month, customers receive 10,000 .Trends API units, which are refreshed monthly.

This API does not use API units associated with the standard Semrush API for Business subscriptions.

You can always upgrade your plan from Basic to Premium or increase your limits by choosing the corresponding option on the ‘Subscription info’ page and leaving the email associated with your Semrush account.

What can .Trends API data be integrated with?

Data from the .Trends API can easily be integrated with:

  • Business Intelligence Software (like Tableau, Dundas BI, Domo, etc.)
  • Data visualization tools like Looker Studio
  • Spreadsheets such as Microsoft Excel
  • Custom dashboards
  • SAAS products
  • And more!

Official .Trends API documentation for developers and end-users can be found here.

Frequently Asked Question

You can access .Trends API data as soon as it’s available inside the Semrush .Trends interface. Each week we provide data for the previous week. The complete dataset for the prior month becomes available by the 10th day of the current month.
The traffic data in .Trends goes back as far as 2017. Age and Sex audience data in  .Trends goes back to April 2020, while Socioeconomic data goes back to April 2022.
We don't send notifications when new data is available. To check it, go to the Semrush .Trends interface. The data available in the .Trends interface is also available through the .Trends API.
To find the list of the .Trends API error codes, please refer to this document.

To access the .Trends API, you'll need to purchase a Semrush subscription. You can find Semrush subscription options on the Plans & Pricing page.

To purchase more .Trends API units, go to the Subscription info page.

If you don't have access to the .Trends API, contact the Sales team using the Sales Inquiry form, and the team will provide you with a quote that fits your needs.

You can request .Trends API data whenever you want as long as you have .Trends API units. Your limits renew automatically each month, but you can buy more at any time on the Subscription info page.
Semrush .Trends processes raw clickstream data through the proprietary machine learning algorithm to generate traffic estimates. To learn more about the process, refer to How Semrush Turns Traffic Data Into Traffic Intelligence.
You can access .Trends API data as soon as it's available in the Semrush .Trends interface. Each week, Semrush provides data for the previous week. The complete dataset for the prior month becomes available by the 10th day of the current month.
Yes, you can increase your per-hour limit for .Trends API if you have less than 20,000 API units per month. By default, the limit is set to 10,000 requests per hour. Once you have 20,000 units or more each month, your hourly limit will increase to 20,000 requests per hour. To access the higher limit, you need to add an extra 10,000 API units to your subscription. You can check the number of API Units and buy more on the Subscription info page.
Semrush doesn't offer a free .Trends API trial. If you have questions about using the .Trends API or would like learn more about it, check out the How the .Trends API works video or contact the Sales team using the Sales Inquiry form.
Semrush stores data for three months after any significant algorithm update. We can provide this data by request. Contact our customer support if you have questions.
Frequently asked questions Show more
Manual Show more
Recently viewed