How to Integrate Semrush with Your Headless CMS

What is Semrush?

Semrush is an SEO and digital marketing platform used by SEO teams, content marketers, agencies, and growth teams to research keywords, track rankings, audit sites, and analyze competitors. Its API exposes reports such as keyword volume, CPC, competition, domain organic rankings, backlinks, and traffic estimates. Teams often use Semrush as the search intelligence layer behind editorial planning, content briefs, technical SEO checks, and reporting.

Why integrate Semrush with a headless CMS?

SEO work often breaks down at the handoff. A strategist finds a target keyword in Semrush, an editor writes the page somewhere else, a developer ships it, and then someone updates a spreadsheet with the published URL. Two weeks later, nobody knows whether the page used the right keyword, which internal links were planned, or whether Semrush ranking data ever made it back to the content team.

Architecture overview

A typical Sanity and Semrush integration starts when an editor publishes an article, landing page, or product page in Sanity Studio. A Sanity webhook fires on the publish mutation and sends the document ID to a Sanity Function or your own webhook listener. The Function uses @sanity/client and GROQ to fetch the exact SEO fields needed from the Content Lake, for example title, slug, focusKeyword, targetDatabase, locale, canonicalUrl, and referenced topic clusters. It then calls Semrush's HTTP API, such as the Keyword Overview report with type=phrase_this for keyword volume and competition, or a Domain Analytics report for the published domain. The Function parses the Semrush response, writes selected metrics back to Sanity as structured fields, and your frontend renders the page from the same content source. Editors see current search data in Sanity Studio, developers use the same structured fields on the website, and SEO teams can refresh metrics on publish or on a controlled schedule.

Common use cases

Step-by-step integration

1. 1

   Set up Semrush API access

   Create or use a Semrush account with API access, then get your API key from the Semrush API settings. Check your available API units, choose the regional database you need, such as us, uk, de, or fr, and confirm which reports your plan can call.

2. 2

   Install the Sanity client

   Semrush's public API is HTTP-based, so you don't need an official Node SDK for the basic reports. In your Function or webhook service, install @sanity/client and use fetch for Semrush requests.

3. 3

   Model SEO fields in Sanity Studio

   Add fields such as seo.focusKeyword, seo.secondaryKeywords, seo.targetDatabase, seo.metaTitle, seo.metaDescription, seo.canonicalUrl, and seo.semrushMetrics. Keep Semrush metrics in their own object so editors can tell the difference between human-written fields and synced report data.

4. 4

   Create the publish trigger

   Create a Sanity webhook filtered to the document types you want, such as article, landingPage, or productPage. Trigger only on publish mutations to avoid spending Semrush API units on every draft keystroke.

5. 5

   Call Semrush and write results back

   In a Sanity Function or webhook listener, use GROQ to fetch the published document, call the Semrush API report you need, parse the response, and patch the document with selected metrics such as search volume, CPC, competition, and trend.

6. 6

   Test with real pages and API limits

   Publish one test page with a focus keyword, verify the webhook payload, inspect the Semrush response, and confirm the metrics appear in Sanity Studio. Then add rate limiting or scheduled refreshes so you don't burn API units on low-value updates.

How Sanity + Semrush works

CMS approaches to Semrush

Keep building

Explore related integrations to complete your content stack.