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.

# 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

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

# 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

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

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

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

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

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

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