ToolzerHubAnswer

Is the Semrush API free? Units, plans and traffic data

No: Semrush's Standard API needs a paid plan plus units, and its traffic API is a separate buy. Our Semrush API reads a domain's free profile for 1 credit.

4 min read

Short answer

  • The Semrush API is not free. The Standard API needs an eligible paid plan, and its units are bought separately, starting from zero.
  • Traffic data sits in the Trends API, a separate purchase with its own units and no free trial. Domain Overview costs 10 units per line.
  • Our Semrush API returns the public profile Semrush shows for a domain: visits, authority, backlinks and AI referrals, at 1 credit a call.
On this page

No. Semrush's Standard API needs a paid plan, and the units each request spends are bought on top of it. Traffic numbers come from a second product, the Trends API, sold separately with no free trial. For the profile Semrush shows anyone on its free website pages, our Semrush API returns it as JSON at 1 credit per domain.

What the Semrush API is for

The Semrush API gives SEO reports to accounts that already pay for Semrush. Its access page says to "Upgrade to the SEO Business plan to buy API units". Units start at zero after you upgrade and are sold in packages; Domain Overview costs 10 units per line for live data and 50 for historical. Traffic reports are in the Trends API, which you buy separately, with its own units and a default limit of 10,000 requests a month. If your team already pays for Semrush, its API is the full dataset.

Semrush profiles with ToolzerHub

We make ToolzerHub. Our Semrush API has three routes, each 1 credit a call:

  • /v1/semrush/website: a domain's profile, with ranks, visits, search traffic, backlinks, competitors and AI referrals
  • /v1/semrush/competitors: the rivals Semrush names for a domain, with the same metrics
  • /v1/semrush/trending: the 100 most visited sites for a country and industry
bash
export TOOLZERHUB_API_KEY=your_key
curl -H "x-api-key: $TOOLZERHUB_API_KEY" \
  "https://api.toolzerhub.com/v1/semrush/website?domain=vercel.com"

The response for vercel.com, trimmed to a few panels:

json
{
  "domain": "vercel.com",
  "authority_score": {"value": 67},
  "engagement": {
    "as_of": "2026-09-01",
    "visits": {"value": 91706607, "change_percent": 0.4149}
  },
  "search_traffic": {"organic": {"value": 1674557}, "paid": {"value": 17016}},
  "backlinks": {"referring_domains": {"value": 1099877}},
  "ai_traffic": {"items": [
    {"source": "chatgpt.com", "traffic": 632314},
    {"source": "claude.ai", "traffic": 229505},
    {"source": "gemini.google.com", "traffic": 204896}
  ]}
}

These are Semrush's estimates from its public website pages, and most panels carry history. ai_traffic lists Semrush's top five AI referrers, so a source missing from it is not zero. Semrush publishes free pages for some domains only; for the rest data is null.

Compare AI referrals across competitors

The script takes a list of domains and writes one row each: visits, authority score, organic and paid search traffic, referring domains, and visits from chatgpt.com, claude.ai and gemini.google.com. Install requests (pip install requests) and save it as semrush_compare.py.

python
import csv
import os
import sys
import time

import requests

URL = "https://api.toolzerhub.com/v1/semrush/website"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
FIELDS = ["domain", "month", "visits", "authority_score", "organic_traffic", "paid_traffic",
          "referring_domains", "chatgpt.com", "claude.ai", "gemini.google.com"]


def website(domain, tries=3):
    # Retry rate limits, server errors and dropped connections.
    for attempt in range(tries):
        last = attempt == tries - 1
        try:
            r = requests.get(URL, headers=HEADERS, params={"domain": domain}, timeout=120)
        except requests.RequestException:
            if last:
                raise
            time.sleep(5 * (attempt + 1))
            continue
        if r.status_code in (429, 500, 502, 503, 504) and not last:
            time.sleep(5 * (attempt + 1))
            continue
        r.raise_for_status()
        return r.json()["data"]


def value(obj, *path):
    for key in path:
        obj = (obj or {}).get(key)
    return obj


def main(domains, out="semrush_compare.csv"):
    with open(out, "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=FIELDS)
        writer.writeheader()
        for domain in filter(None, (d.strip() for d in domains.split(","))):
            site = website(domain)
            if not site:
                print(f"{domain}: no Semrush page")
                continue
            ai = {i["source"]: i["traffic"] for i in value(site, "ai_traffic", "items") or []}
            row = {
                "domain": domain, "month": value(site, "engagement", "as_of"),
                "visits": value(site, "engagement", "visits", "value"),
                "authority_score": value(site, "authority_score", "value"),
                "organic_traffic": value(site, "search_traffic", "organic", "value"),
                "paid_traffic": value(site, "search_traffic", "paid", "value"),
                "referring_domains": value(site, "backlinks", "referring_domains", "value"),
                **{source: ai.get(source) for source in FIELDS[-3:]},
            }
            writer.writerow(row)
            print(f"{domain}: {row['visits']:,} visits in {row['month']}, authority {row['authority_score']}; "
                  + ", ".join(f"{s} {ai.get(s)}" for s in FIELDS[-3:]))


if __name__ == "__main__":
    if len(sys.argv) < 2:
        sys.exit('usage: python semrush_compare.py "stripe.com,adyen.com" [out.csv]')
    if not HEADERS["x-api-key"]:
        sys.exit("set TOOLZERHUB_API_KEY first")
    main(*sys.argv[1:])

What 8 developer tools showed

python semrush_compare.py "stripe.com,vercel.com,notion.so,figma.com,cursor.com,postman.com,twilio.com,netlify.com" made 8 calls in 15 seconds. Visits are for the latest month Semrush shows.

Domain Visits chatgpt.com claude.ai gemini.google.com Three as share of visits
stripe.com 232,542,245 1,268,580 538,735 Not in top 5 0.78%
figma.com 184,917,886 768,456 631,305 42,987 0.78%
vercel.com 91,706,607 632,314 229,505 204,896 1.16%
netlify.com 40,091,969 319,606 116,527 295,862 1.83%
notion.so 37,639,091 148,952 4,297 16,990 0.45%
cursor.com 35,493,690 152,668 11,612 55,145 0.62%
twilio.com 9,601,005 94,977 3,154 17,097 1.20%
postman.com 5,537,280 84,486 15,931 8,715 1.97%

ChatGPT sends the most of the three to all eight, but the gap varies. Figma gets 82% as many visits from claude.ai as from chatgpt.com, and Netlify gets 93% as many from Gemini. None of the eight gets 2% of its visits from the three assistants combined.

What it costs

A domain is 1 credit, so a monthly check of 20 competitors is 20 credits. The 100 free credits a month cover that; $19 buys 10,000 credits that never expire, and plans for higher volume cover weekly checks across whole markets. Set your key and the first comparison is a CSV in seconds.

For software reviews, see the Capterra reviews API. For a competitor's catalog, see Shopify products.json.

We are not affiliated with Semrush.

Get this data from your own code

The Semrush API returns it as JSON with one x-api-key header. 100 free credits monthly.