122 lines
2.7 KiB
Markdown
122 lines
2.7 KiB
Markdown
|
# 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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
GET https://api.semrush.com/?type=phrase_all&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr&phrase=keyword&database=us
|
||
|
|
```
|
||
|
|
|
||
|
|
### Related keywords
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
GET https://api.semrush.com/?type=phrase_kdi&key={api_key}&export_columns=Ph,Kd&phrase=keyword&database=us
|
||
|
|
```
|
||
|
|
|
||
|
|
### Backlinks overview
|
||
|
|
|
||
|
|
```bash
|
||
|
|
GET https://api.semrush.com/?type=backlinks_overview&key={api_key}&target=example.com&target_type=root_domain
|
||
|
|
```
|
||
|
|
|
||
|
|
### Backlinks list
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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
|
||
|
|
- competitor-alternatives
|