---
title: Semrushi uuring
description: SEO ja konkurentsianalüüs Semrushi API abil.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# SemRushi uuring

Tõmba SemRushi API-st reaalajas SEO- ja konkurentsiluure andmeid.

## Eeldused

Nõuab `SEMRUSH_API_KEY` seadmist failis `.env`, `.env.local` või `~/.claude/.env.global`.

```bash
# Verify the key is available
echo "SEMRUSH_API_KEY is ${SEMRUSH_API_KEY:+set}"
```

Kui võtit pole seatud, juhenda kasutajat:
> Sul on vaja SemRushi API-võtit. Hangi see aadressilt https://www.semrush.com/api/
> Seejärel lisa `SEMRUSH_API_KEY=your_key` oma `.env`-faili.

## API baas

Kõik päringud lähevad aadressile `https://api.semrush.com/`, API-võti edastatakse kujul `&key={SEMRUSH_API_KEY}`.

Vastused on semikooloniga eraldatud CSV. Esimene rida on päiserida. Parsi vastavalt.

---

## 1. Domeeni ülevaade

Hangi kõrgetasemeline hetktõmmis mis tahes domeeni orgaanilise ja tasulise otsingu jõudlusest.

### Lõpp-punkt

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

### Ekspordiveerud

| Veerg | Tähendus |
|--------|---------|
| `Dn` | Domeen |
| `Rk` | SemRushi edetabelikoht |
| `Or` | Orgaaniliste märksõnade arv |
| `Ot` | Orgaanilise liikluse hinnang |
| `Oc` | Orgaanilise liikluse maksumus ($) |
| `Ad` | Tasuliste märksõnade arv |
| `At` | Tasulise liikluse hinnang |
| `Ac` | Tasulise liikluse maksumus ($) |

### Näide curl

```bash
curl -s "https://api.semrush.com/?type=domain_ranks&key=${SEMRUSH_API_KEY}&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=example.com"
```

### Vastuse parsimine

```bash
# Response format (semicolon-delimited):
# Dn;Rk;Or;Ot;Oc;Ad;At;Ac
# example.com;12345;8234;145000;234500;120;3400;5600

# Parse with awk
curl -s "..." | awk -F';' 'NR==2 {
  printf "Domain: %s\nSemRush Rank: %s\nOrganic Keywords: %s\nOrganic Traffic: %s\nOrganic Traffic Cost: $%s\nPaid Keywords: %s\nPaid Traffic: %s\nPaid Traffic Cost: $%s\n",
  $1,$2,$3,$4,$5,$6,$7,$8
}'
```

---

## 2. Märksõna ülevaade

Hangi märksõna otsingumaht, CPC, konkurents ja SERP-funktsioonid.

### Lõpp-punkt

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

### Ekspordiveerud

| Veerg | Tähendus |
|--------|---------|
| `Ph` | Märksõnafraas |
| `Nq` | Otsingumaht (kuus) |
| `Cp` | CPC (USD) |
| `Co` | Konkurents (0-1) |
| `Nr` | Tulemuste arv |
| `Td` | Trend (12 kuud, komaga eraldatud) |

### Näide curl

```bash
curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase=content+marketing&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td"
```

### Toetatud andmebaasid

Kasuta `&database=XX`, kus XX on: `us`, `uk`, `ca`, `au`, `de`, `fr`, `es`, `it`, `br`, `in`, `jp`.

---

## 3. Seotud märksõnad

Leia semantiliselt seotud märksõnu sisuplaneerimiseks ja lünkade analüüsiks.

### Lõpp-punkt

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

### Näide curl

```bash
curl -s "https://api.semrush.com/?type=phrase_related&key=${SEMRUSH_API_KEY}&phrase=project+management&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td&display_limit=20"
```

### Mitme rea parsimine

```bash
curl -s "..." | awk -F';' 'NR>1 { printf "%-40s Vol: %-8s CPC: $%-6s Comp: %s\n", $1, $2, $3, $4 }'
```

---

## 4. Märksõna raskusaste

Hinda, kui raske on märksõnaga reastuda.

### Lõpp-punkt

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

| Veerg | Tähendus |
|--------|---------|
| `Ph` | Märksõna |
| `Kd` | Märksõna raskusaste (0-100) |

Tõlgendus:
- 0-29: Lihtne - saavutatav kvaliteetse sisuga
- 30-49: Mõõdukas - vajab korralikku sisu + mõningaid tagasilinke
- 50-69: Raske - vajab tugevat domeeniautoriteeti + tagasilinke
- 70-84: Väga raske - nõuab väljakujunenud autoriteeti
- 85-100: Ülimalt raske - domineerivad tippdomeenid

---

## 5. Domeeni orgaanilised märksõnad

Vaata, milliste märksõnadega domeen orgaaniliselt reastub.

### Lõpp-punkt

```
https://api.semrush.com/?type=domain_organic&key={KEY}&domain={domain}&database=us&export_columns=Ph,Po,Nq,Cp,Url,Tr,Tc&display_limit=50&display_sort=tr_desc
```

| Veerg | Tähendus |
|--------|---------|
| `Ph` | Märksõna |
| `Po` | Positsioon |
| `Nq` | Otsingumaht |
| `Cp` | CPC |
| `Url` | Reastuv URL |
| `Tr` | Liiklus (%) |
| `Tc` | Liikluse maksumus |

### Näide curl

```bash
curl -s "https://api.semrush.com/?type=domain_organic&key=${SEMRUSH_API_KEY}&domain=hubspot.com&database=us&export_columns=Ph,Po,Nq,Cp,Url,Tr,Tc&display_limit=20&display_sort=tr_desc"
```

---

## 6. Tagasilinkide ülevaade

Hangi kokkuvõte domeeni tagasilingiprofiilist.

### Lõpp-punkt

```
https://api.semrush.com/analytics/v1/?key={KEY}&type=backlinks_overview&target={domain}&target_type=root_domain&export_columns=total,domains_num,urls_num,ips_num,follows_num,nofollows_num,texts_num,images_num
```

### Näide curl

```bash
curl -s "https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=backlinks_overview&target=example.com&target_type=root_domain&export_columns=total,domains_num,urls_num,ips_num,follows_num,nofollows_num,texts_num,images_num"
```

---

## 7. Konkurentide avastamine

Leia domeenid, mis võistlevad samade orgaaniliste märksõnade pärast.

### Lõpp-punkt

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

| Veerg | Tähendus |
|--------|---------|
| `Dn` | Konkurendi domeen |
| `Cr` | Konkurentsitase |
| `Np` | Ühised märksõnad |
| `Or` | Orgaanilised märksõnad |
| `Ot` | Orgaaniline liiklus |
| `Oc` | Orgaanilise liikluse maksumus |
| `Ad` | Tasulised märksõnad |

### Näide curl

```bash
curl -s "https://api.semrush.com/?type=domain_organic_organic&key=${SEMRUSH_API_KEY}&domain=notion.so&database=us&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&display_limit=10"
```

---

## 8. Liiklusanalüütika (hinnangud)

Hinda domeeni üldiseid liiklusallikaid ja kaasatust.

### Lõpp-punkt

```
https://api.semrush.com/analytics/ta/api/v3/summary?key={KEY}&targets={domain}&display_date=2024-01-01&country=us&export_columns=target,visits,users,bounce_rate,pages_per_visit,avg_visit_duration
```

---

## Töövoog: täielik konkurentsianalüüs

Kui kasutaja palub täielikku konkurentsianalüüsi, käivita need sammud järjekorras:

1. **Domeeni ülevaade** - Hangi sihtdomeeni mõõdikud
2. **Konkurentide avastamine** - Leia 5-10 parimat konkurenti
3. **Domeeni ülevaade** iga konkurendi kohta - Võrdle mõõdikuid
4. **Parimad märksõnad** iga domeeni kohta - Leia märksõnalüngad
5. **Tagasilinkide ülevaade** iga domeeni kohta - Võrdle lingiprofiile

### Väljundformaat

Esita tulemused võrdlustabelina:

```
| Metric              | target.com | competitor1.com | competitor2.com |
|---------------------|-----------|-----------------|-----------------|
| SemRush Rank        | ...       | ...             | ...             |
| Organic Keywords    | ...       | ...             | ...             |
| Organic Traffic     | ...       | ...             | ...             |
| Traffic Cost        | ...       | ...             | ...             |
| Backlinks           | ...       | ...             | ...             |
| Referring Domains   | ...       | ...             | ...             |
```

Seejärel too esile:
- **Märksõnalüngad**: Märksõnad, millega konkurendid reastuvad, aga siht mitte
- **Kiired võidud**: Märksõnad, kus siht reastub positsioonidel 5-20 (parandamisvõimalused)
- **Sisulüngad**: Teemad, mida konkurendid käsitlevad, aga siht mitte
- **Tagasilingivõimalused**: Saidid, mis lingivad konkurentidele, aga mitte sihile

## Päringupiirangud ja kulud

- Iga API-kutse maksab API-ühikuid (kontrolli oma plaani)
- Kasuta `&display_limit=` tulemuste arvu reguleerimiseks (vaikeväärtus oleneb lõpp-punktist)
- Puhverda tulemused lokaalselt mitmesammulise analüüsi ajal, et vältida liigseid kutseid
- Domeeni ülevaate kutsed on odavaimad; tagasilingid ja liiklusanalüütika maksavad rohkem

## Vigade käsitlemine

| Viga | Tähendus |
|-------|---------|
| `ERROR 50 :: NOTHING FOUND` | Selle päringu jaoks andmeid pole |
| `ERROR 120 :: WRONG KEY` | Kehtetu API-võti |
| `ERROR 130 :: LIMIT EXCEEDED` | API-ühikute limiit täis |
| Tühi vastus | Tähendab tavaliselt, et päringuparameetrite jaoks pole andmeid saadaval |

Kui saad „NOTHING FOUND“, proovi:
- Teist andmebaasi (nt `uk` `us` asemel)
- Juurdomeeni alamdomeeni asemel
- Laiemat märksõnafraasi