Skip to content

semrush.md

Latest commit

 

History

History
121 lines (85 loc) · 2.68 KB

semrush.md

File metadata and controls

121 lines (85 loc) · 2.68 KB

SEMrush

SEO and competitive analysis platform for keyword research and site audits.

Capabilities

Integration Available Notes
API ✓ Analytics API, Projects API
MCP - Not available
CLI - Not available
SDK - API-only

Authentication

  • Type: API Key
  • Parameter: key={api_key} in query string
  • Get key: My Profile > API in SEMrush dashboard

Common Agent Operations

Domain overview

GET https://api.semrush.com/?type=domain_ranks&key={api_key}&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=example.com

Organic keywords

GET https://api.semrush.com/?type=domain_organic&key={api_key}&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr&domain=example.com&database=us&display_limit=100

Keyword overview

GET https://api.semrush.com/?type=phrase_all&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr&phrase=keyword&database=us

Related keywords

GET https://api.semrush.com/?type=phrase_related&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr,Td&phrase=keyword&database=us&display_limit=50

Keyword difficulty

GET https://api.semrush.com/?type=phrase_kdi&key={api_key}&export_columns=Ph,Kd&phrase=keyword&database=us

Backlinks overview

GET https://api.semrush.com/?type=backlinks_overview&key={api_key}&target=example.com&target_type=root_domain

Backlinks list

GET https://api.semrush.com/?type=backlinks&key={api_key}&target=example.com&target_type=root_domain&export_columns=source_url,source_title,target_url,anchor&display_limit=100

Competitors

GET https://api.semrush.com/?type=domain_organic_organic&key={api_key}&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&domain=example.com&database=us&display_limit=20

Response Format

Responses are CSV by default. Add &export_escape=1 for proper escaping.

Export Columns

Domain Report

  • Db - Database
  • Dn - Domain
  • Rk - Rank
  • Or - Organic keywords
  • Ot - Organic traffic
  • Oc - Organic cost

Keyword Report

  • Ph - Phrase/keyword
  • Nq - Search volume
  • Cp - CPC
  • Co - Competition
  • Kd - Keyword difficulty
  • Nr - Number of results

Backlinks

  • source_url - Linking page
  • target_url - Target page
  • anchor - Anchor text
  • source_title - Page title

Databases

Use country code: us, uk, de, fr, ca, au, etc.

When to Use

  • Keyword research
  • Competitive analysis
  • Backlink analysis
  • Site audits
  • Rank tracking
  • Content gap analysis

Rate Limits

  • Varies by plan (10-30K units/day)
  • Each API call costs units

Relevant Skills

  • seo-audit
  • programmatic-seo
  • content-strategy
  • competitors