SEMrush

5 production-ready jobs — keyword gap content generation, competitor content audit, keyword cluster focus groups, backlink outreach content, and position tracking executive reports

SEMrush holds your competitive intelligence — which keywords your rivals rank for, what content earns them links, and where your search visibility is shifting. These five jobs pull that data through Mavera’s surfaces (Mave Agent, Custom Personas, Focus Groups, Brand Voices, Generate) so your SEO strategy, outreach, and content plans are grounded in competitive data rather than intuition.

API Reference Card

Detail	Value
Base URL	https://api.semrush.com/
Auth	API key as query parameter (?key=YOUR_KEY)
Rate limits	10 requests per second
Response format	Semicolon-delimited text (not JSON) for most endpoints
Mavera base	https://app.mavera.io/api/v1
Mavera auth	Authorization: Bearer mvra_live_...

All examples use two environment variables: SEMRUSH_API_KEY and MAVERA_API_KEY. SEMrush returns semicolon-delimited text for most endpoints — Python examples parse with csv.reader(delimiter=';') and JavaScript examples split lines by \n then each by ;. Each API call consumes units from your SEMrush plan; check your balance at SEMrush → Subscription Info.

Prerequisites

1. SEMrush API key with available units

   Log in to SEMrush and navigate to your profile settings to find your API key. Verify that your plan includes API units — most Pro plans include 10,000 units/month.
2. Mavera API key

   Generate a key at app.mavera.io/settings/api-keys. The key starts with mvra_live_.
3. Install dependencies

   pip install requests
   
4. Environment variables

   export SEMRUSH_API_KEY="your_semrush_api_key_here"
   export MAVERA_API_KEY="mvra_live_xxxxx"
   

Jobs

#	Job	SEMrush Data	Mavera Surface	Output
1	Keyword Gap → Content Generation	domain_domains	Mave Agent	Content briefs for uncovered keywords
2	Competitor Content Audit	url_organic	Mave Agent + Focus Groups	Messaging gap analysis with persona feedback
3	Keyword Clusters → Focus Group Validation	phrase_related	Personas + Focus Groups	Validated content concepts per cluster
4	Backlink Analysis → Outreach Content	backlinks_overview + backlinks	Brand Voices + Generate	Outreach email variants by link type
5	Position Tracking → Performance Reports	domain_organic	Mave Agent	Executive ranking narrative with actions

---

Rate Limits & Production Notes

SEMrush Endpoint	Unit Cost	Caching Strategy
domain_domains	10-40 units	Cache daily — gaps don’t shift hourly
url_organic	10 units	Cache 24h — competitor pages change slowly
phrase_related	10 units	Cache per seed keyword for 7 days
backlinks / overview	20-70 units	Cache 48h — profiles update slowly
domain_organic	10 units	Cache 24h — positions shift daily at most

SEMrush enforces 10 requests/second. All jobs include delays. In production, add a centralized rate limiter for concurrent jobs. ERROR 130 :: TOO MANY REQUESTS — retry after 1s with exponential backoff.

Always use csv.reader(delimiter=";") in Python and split-then-validate in JavaScript. Raw .split(";") breaks on quoted fields or semicolons inside keyword text.

Concern	Recommendation
API key security	Store in a secrets manager. Never commit to version control.
Unit monitoring	Check balance before batch runs. Full backlink audit costs 90+ units.
Response caching	SEMrush data updates daily at most. Cache with 24-48h TTL.
Mavera credits	Monitor at Dashboard.
Baseline storage	Use a database or versioned JSON for trend analysis.

What’s Next

All Integrations

50+ API integrations with full code

SEMrush API Docs

Official SEMrush API reference

Mave Agent

Full reference for POST /api/v1/mave/chat

Focus Groups API

Full reference for POST /api/v1/focus-groups

Generate API

Full reference for POST /api/v1/generations

Brand Voices API

Full reference for POST /api/v1/brand-voices