Rank Tracker API

Bevezetés

A rangsor-nyomonkövetés egészen más kihívássá válik, ha több száz weboldalt, több ezer kulcsszót vagy automatikusan frissülő SEO-jelentéseket kell kezelni.

A vezérlőpultba való bejelentkezés és az adatok kézi exportálása kisebb projektek esetében még működhet. Nagyobb léptékben azonban ez gyorsan szűk keresztmetszetté válik.

Ezért hoztuk létre a Ranktracker API-t-t.

A Ranktracker API már elérhető, és programozói hozzáférést biztosít a fejlesztőknek, SEO-csapatoknak, ügynökségeknek, SaaS-vállalatoknak és adatelemző csapatoknak a Ranktracker-adataikhoz.

Az API segítségével:

• A legjobb 100 kulcsszó rangsorának lekérése
• Hozzáférés a SERP-adatokhoz
• Az AI-áttekintések és egyéb SERP-funkciók felismerése
• Nyomon követett domainnevek létrehozása és kezelése
• Kulcsszavak hozzáadása és kezelése
• Versenytársak nyomon követése
• Rangsor-előzmények elérése
• A Share of Voice kiszámítása
• Kulcsszavak címkékkel történő rendszerezése
• A fiók használatának és kvótájának figyelése
• Automatizált SEO-jelentési folyamatok kialakítása
• A rangsoradatok összekapcsolása a belső alkalmazásokkal és irányítópultokkal

Ahelyett, hogy kézzel mozgatná a SEO-adatokat a platformok között, a Ranktracker API lehetővé teszi, hogy saját szoftvere közvetlenül együttműködjön a Ranktracker mögött álló rangsorolási infrastruktúrával.

API-kulcs létrehozása vagy kezelése: https://app.ranktracker.com/account/api

Olvassa el az API dokumentációját: https://developers.ranktracker.com/

Mi az a Ranktracker API?

A Ranktracker API egy REST API, amely programozási hozzáférést biztosít a Ranktracker-fiókjához.

Ahelyett, hogy minden alkalommal megnyitná a Ranktrackert, amikor rangsorolási információkra van szüksége, az alkalmazása automatikusan lekérheti az adatokat.

Az API felépítése a Ranktracker egészében használt alapvető erőforrások köré épül:

• Fiókok
• Domain
• Kulcsszavak
• Versenytársak
• Rangsor-előzmények
• SERP-adatok
• Visszhangarány
• Címkék
• Használat és kvóta

Ez lehetővé teszi a fejlesztők számára, hogy egyrészt lekérjék a Ranktracker adatait, másrészt pedig kezeljék, hogy a Ranktracker mit kövessen nyomon.

Például egy SEO-ügynökség automatikusan létrehozhat egy Ranktracker-projektet, amikor egy új ügyfél bekerül a CRM-jébe, hozzáadhatja az ügyfél kulcsszavait és versenytársait, majd a rangsorokat beépítheti egy belső jelentési irányítópultba.

Egy SaaS-platform ugyanazt az API-t használhatja arra, hogy a rangsoradatokat közvetlenül a saját termékében jelenítse meg.

Egy adatelemző csapat automatikusan elküldheti a napi rangsorokat a BigQuery-be, a Snowflake-be, a PostgreSQL-be, a Google Sheets-be vagy egy másik adattárházba további elemzés céljából.

Az erőforrások összefüggéseinek áttekintéséhez lásd a Ranktracker API alapfogalmak című útmutatótcímű útmutatót.

Alapértelmezés szerint a top 100 rangsor

A Ranktracker API egyik legnagyobb előnye a rangsoradatok részletessége.

Minden kulcsszó-ellenőrzés alapértelmezés szerint a Google első 100 találatát tartalmazza.

Ez azt jelenti, hogy a keresési eredmények mind a 10 oldalát elemezheti, ahelyett, hogy csak azt látná, mi szerepel jelenleg az első oldalon.

Ez azért fontos, mert a SEO-folyamat általában jóval azelőtt megkezdődik, hogy egy kulcsszó bekerülne a Top 10-be.

Egy kulcsszó helyezése a következőképpen változhat:

91. hely → 63. hely → 37. hely → 18. hely → 9. hely

Ez jelentős SEO-előrelépést jelent.

Ha a rangsorolási adataid az első 10 találatnál véget érnek, akkor az út szinte teljes egészében láthatatlan marad.

A Top 100 nyomon követés lehetővé teszi a következőket:

• Új rangsorok kerültek be a Google Top 100-ba
• Az első oldalra felkerülő kulcsszavak
• Jelentős rangsor-előrelépések és -visszaesések
• A versenytársak mozgása
• A hosszú farkú keresések láthatósága
• Új tartalmak teljesítménye
• Programozott SEO-kampányok
• Kiterjedt kulcsszóportfóliók

Ezért az API mind a magas szintű SEO-jelentések, mind a részletes rangsorelemzések számára hasznos.

További információk az API-ról:

https://developers.ranktracker.com/

Rangsorok nyomon követése több mint 107 000 helyszínen

A keresési eredmények jelentősen eltérhetnek attól függően, hogy hol történik a keresés.

A Ranktracker több mint 107 000 helyszínt támogat, így a csapatok az API segítségével nyomon követhetik a helyi, országos és nemzetközi keresési láthatóságot.

A kulcsszó-követés többek között a következő tényezők alapján konfigurálható:

• Keresőmotor
• Hely
• Nyelv
• Eszköz

Például ugyanazt a kulcsszót külön-külön lehet nyomon követni a következők szerint:

• Egyesült Államok — asztali számítógép
• Egyesült Államok — mobil
• Egyesült Királyság — asztali számítógép
• Németország — mobil
• Lengyelország — asztali számítógép

Minden konfiguráció külön nyomon követett kulcsszóként kezelhető.

Ez különösen hasznos a következő esetekben:

• Nemzetközi SEO
• Több telephelyű vállalkozások
• Helyi SEO-ügynökségek
• E-kereskedelmi vállalkozások
• Különböző piacokon működő kiadók
• Több országot megcélzó SaaS-vállalatok
• Vállalati SEO-csapatok

Ahelyett, hogy egy kulcsszót egyetlen univerzális rangsorolási pozícióval kezelne, elemezheti, hogyan változik a láthatóság a különböző piacokon és eszközökön.

Asztali és mobil rangsor-követés

Az asztali és a mobil keresési eredmények eltérhetnek egymástól.

A Ranktracker ezért lehetővé teszi a kulcsszavak eszközönkénti szegmentálását.

Ez azt jelenti, hogy az integráció külön-külön elemezheti:

• Asztali rangsorok
• Mobil rangsorok

Például egy oldal asztali számítógépen magas rangot érhet el, de mobilon eltérő teljesítményt nyújthat a SERP elrendezésének, a helyi eredményeknek vagy más keresési funkcióknak köszönhetően.

Ezen adatkészletek elkülönítése sokkal világosabb képet ad a SEO-csapatoknak arról, hogy a felhasználók valójában hogyan találkoznak weboldalaikkal a keresés során.

Az API lehetővé teszi az eszközök szerinti szegmentálást olyan funkciók használata során is, mint például a Share of Voice.

SERP-funkciók és AI-áttekintés

A modern Google-eredmények sokkal többet tartalmaznak, mint a hagyományos organikus listázások.

A SERP-ek a következőket tartalmazhatják:

• AI-áttekintések
• Kiemelt részletek
• Térképek
• Helyi találatok
• Videók
• Vásárlási eredmények
• Gyakran feltett kérdések
• Egyéb keresési funkciók

A Ranktracker API a kulcsszóadatok mellett a SERP-funkciókra vonatkozó információkat és az AI Overview felismerést is tartalmazza.

Ez azt jelenti, hogy az integrációja nemcsak azt tudja elemezni, hogy egy weboldal hol szerepel a rangsorban, hanem azt is, hogy mi veszi körül azt a rangsort a Google-ban.

Például az alábbiakat azonosíthatja:

• Az AI-áttekintést kiváltó kulcsszavak
• Kiemelt részleteket tartalmazó SERP-ek
• Videóeredmények által dominált keresési lekérdezések
• Helyi vagy térképes eredményeket generáló kulcsszavak
• A keresési találati oldalak összetételének időbeli változásai

Ez egyre fontosabbá válik, mivel a természetes pozíció önmagában nem mindig ad teljes képet a helyzetről.

Egy oldal, amely a hagyományos SERP-en a harmadik helyen szerepel, és egy oldal, amely az AI Overview, a térképcsomag, a videók és a „People Also Ask” alatt a harmadik helyen szerepel, nagyon eltérő láthatósági szintet érhet el.

Az API lehetővé teszi, hogy ezek a különbségek is részét képezzék a SEO-elemzésének.

Az API teljes dokumentációja itt található:

https://developers.ranktracker.com/

Hozzáférés a teljes SERP-adatokhoz

A Ranktracker sokkal többet nyújt, mint egy egyszerű rangsorolási számot.

A nyomon követett kulcsszavak esetében az API a legfrissebb keresési eredményeket a kapcsolódó SERP-adatokkal együtt jeleníti meg.

Az API-erőforrások felépítése a következőket tartalmazza:

• Legfrissebb SERP-adatok
• Rangsorolási információk
• A SERP jellemzői
• A SERP HTML-kódjának gyorsítótárazott változata

Ez azt jelenti, hogy a fejlesztők a tényleges keresési eredmények köré építhetik a munkafolyamatokat, ahelyett, hogy egyszerűen csak a következőket tárolnák:

Pozíció: 12

A haladó SEO-csapatok számára ez sokkal nagyobb rugalmasságot biztosít.

A SERP-adatokat a következőkre használhatja:

• Versengő URL-ek elemzése
• Vizsgálja meg a váratlan rangsorváltozásokat
• Az eredmények elrendezésében bekövetkezett változások azonosítása
• Belső SERP-elemző eszközök készítése
• A korábbi SERP-adatok tárolása
• A keresési eredmények adatainak továbbítása más modellekbe vagy elemző rendszerekbe

A teljes végpont-referencia itt található:

https://developers.ranktracker.com/rest-api/

Domainok kezelése az API-n keresztül

A domainnevek a Ranktracker API egyik legfontosabb erőforrása.

A REST API segítségével a következőket teheti:

• Domainok létrehozása
• Domain-ek lekérése
• Domainok frissítése
• Domain törlése

Egy domain egy olyan webhelyet jelöl, amelyet a Ranktrackerben nyomon követnek.

Minden domain tartalmazhatja a saját:

• Kulcsszavak
• Versenytársak
• Rangsor története
• Share of Voice adatok

Ez lehetővé teszi az automatizált bevezetést.

Például egy ügynökség a következő munkafolyamatot hozhatja létre:

Új ügyfél regisztrál
        ↓
Ranktracker-domain létrehozása
        ↓
Az ügyfél kulcsszavainak hozzáadása
        ↓
A versenytársak hozzáadása
        ↓
A rangsor-nyomon követés megkezdése
        ↓
Adatok elküldése a jelentési irányítópultra

Nincs szükség arra, hogy a csapat tagjai minden új projektet manuálisan konfiguráljanak.

A teljes útmutató elérhető a „Domain hozzáadása és kulcsszavak nyomon követése” című útmutatóbancímű útmutatóban.

Kulcsszavak programozott hozzáadása és kezelése

A domain létrehozását követően a kulcsszavak az API-n keresztül kezelhetők.

Az API segítségével hozzáadhat nyomon követett kulcsszavakat, miközben megadhatja a hozzájuk tartozó keresési beállításokat is.

A nyomon követett kulcsszavak adatai a következő tényezőket tartalmazhatják:

• Szó
• Keresőmotor
• Hely
• Nyelv
• Eszköz
• Rangsorolt találatok

A meglévő kulcsszavak nyomon követési életciklusát is kezelheti.

Ez magában foglalja a következő lehetőségeket:

• Kulcsszavak lekérése
• Rangsor-adatok megtekintése
• Nyomon követés szüneteltetése
• A nyomon követés folytatása
• A nyomon követés leállítása
• Hozzáférés a SERP-adatokhoz
• Címkék hozzárendelése

Ez lehetővé teszi, hogy saját alkalmazása szabályozza, mely kulcsszavakat figyelje a Ranktracker.

Kulcsszavak tömeges nyomon követése

A nagy SEO-fiókok esetében nem szükséges minden kulcsszóra külön API-lekérdezést indítani.

A Ranktracker támogatja a kulcsszavak tömeges kezelését.

A kulcsszó-létrehozási végpont elfogadja a „szavak × keresőmotorok” konfigurációt, így egy kéréssel számos nyomon követett kulcsszó-kombináció hozható létre.

Képzelje el például, hogy a következőket szeretné nyomon követni:

• 100 kulcsszó
• Amerikai asztali számítógép
• Amerikai mobil

Ezek a konfigurációk 200 nyomon követett kulcsszó-kombinációt eredményezhetnek anélkül, hogy 200 külön beállítási kérésre lenne szükség.

A tömeges műveletek különösen hasznosak a következő esetekben:

• Ügynökségek
• Vállalati SEO
• Nagy e-kereskedelmi áruházak
• Programmatikus SEO
• SaaS SEO-platformok
• Nagy tartalomszolgáltatók

A Ranktracker támogatja a kulcsszavak tömeges címkézését is.

Olvassa el a tömeges műveletekről szóló teljes útmutatót:

https://developers.ranktracker.com/guides/bulk-operations/

SEO-versenytársak nyomon követése

A rangsorok sokkal hasznosabbá válnak, ha tartalmazzák a versenytársakkal kapcsolatos kontextust is.

A Ranktracker API lehetővé teszi a versenytársak kezelését a nyomon követett domainekhez viszonyítva.

Ez lehetővé teszi a keresési teljesítmény automatikus elemzését a versenytárs weboldalakkal összehasonlítva.

A versenytársak adatait a következőkre használhatja:

• Mely versenytársak nyernek teret
• Mely webhelyek előzik meg a domainjét
• Változások a közös kulcsszócsoportokban
• Versenyhelyzeti rangsor-trendek
• Relatív keresési láthatóság
• A hangosság arányának változásai

Ügynökségek számára ez az automatizált ügyfél-jelentési rendszer részévé válhat.

Ahelyett, hogy havonta manuálisan hasonlítanák össze az ügyfelet a versenytársakkal, a releváns adatok közvetlenül integrálhatók a jelentéskészítési folyamatba.

Hozzáférés a korábbi rangsoradatokhoz

A jelenlegi rangsorok csak azt mutatják, mi történik éppen most.

A korábbi rangsorolási adatokból látható, hogy milyen irányba halad a SEO-teljesítmény.

A Ranktracker az API-n keresztül biztosítja a domain rangsorának történetét, lehetővé téve a fejlesztők számára, hogy elemezzék a láthatóság időbeli alakulását.

A korábbi adatok segítségével az alábbiakat lehet azonosítani:

• Rangsor-előrelépések
• Rangsorvesztések
• Láthatósági trendek
• Kulcsszavak mozgása
• Változások a SEO-kampányok után
• A Google frissítésének hatása
• Hosszú távú kampányteljesítmény

A rangsor-előzményeket egyedi diagramok és irányítópultok létrehozásához is felhasználhatja.

Például:

Ranktracker API
       ↓
Napi rangsor-kivonat
       ↓
Adattárház
       ↓
Történeti SEO-adatkészlet
       ↓
Műszerfal / Riasztások / Elemzés

A Ranktracker egy speciális útmutatót kínál, amely bemutatja, hogyan lehet a napi rangsorokat adatbázisba importálni:

https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Ranktracker-adatok küldése adatraktárba

Az egyik leghasznosabb API-munkafolyamat a Ranktracker-adatok automatikus tárolása a saját adatbázisában vagy adattárházában.

Például a rangsoradatok elküldhetők:

• BigQuery
• Snowflake
• PostgreSQL
• MySQL
• Google Táblázatok
• Belső elemzési adatbázisok

Ezeket az információkat ezután össze lehet vonni más üzleti adatokkal.

Például:

Ranktracker
     ↓
Ranktracker API
     ↓
Adattárház
     ↓
Google Search Console
Analytics
Konverziók
Bevétel
CRM-adatok
     ↓
Üzleti intelligencia irányítópult

Ez sokkal átfogóbb képet ad a SEO-teljesítményről.

Ahelyett, hogy egyszerűen csak azt tudnánk, hogy egy kulcsszó a 8. helyről a 3. helyre került, elemezhetjük, hogy a változás a következőket is eredményezte-e:

• Több organikus kattintás
• Több potenciális ügyfél
• Magasabb konverziós arányok
• Megnövekedett bevétel

A „Rankings to Warehouse” bemutató példát mutat be egy ilyen típusú folyamat felépítésére.

„Share of Voice” jelentések készítése

A Ranktracker API a Share of Voice adatokat is elérhetővé teszi.

A Share of Voice szélesebb körű mérést nyújt arról, hogy egy domain mennyire látható a nyomon követett kulcsszókészletben.

Ahelyett, hogy azt kérdezné:

Hol szerepelünk ennek a kulcsszónak a rangsorában?

a következő kérdést teheti fel:

Mennyire vagyunk láthatók az egész keresési piacon?

Ez különösen hatékony, ha a versenytársak adatait is figyelembe vesszük.

A Share of Voice API a következő elemzésekhez használható:

• Átfogó láthatósága
• A versenytársak láthatósága
• A láthatóság időbeli változása
• Relatív piaci pozíció
• Láthatóság asztali számítógépeken
• Mobil láthatóság

Az endpoint támogatja a dátumtartományokat és az eszközszegmentációt, így a Share of Voice beépíthető az egyedi SEO-jelentésekbe.

Egy teljes implementációs példa itt érhető el:

https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Kulcsszavak szervezése címkékkel

A nagy kulcsszóportfóliók szervezés nélkül nehezen kezelhetők.

A Ranktracker fiók szintű címkéket biztosít, amelyek hozzáadhatók a nyomon követett kulcsszavakhoz.

Címkéket hozhat létre például:

• Termékkategóriák
• Keresési szándék
• Helyek
• Tartalomtípusok
• Kampányok
• Ügyfelek
• A vásárlási folyamat szakaszai
• Üzleti egységek
• SEO-csapatok

Például:

„futócipő vásárlás” → Kereskedelmi
„legjobb futócipő” → Összehasonlítás
„hogyan tisztítsuk a futócipőt” → Információs

Ugyanazok a címkék újra felhasználhatók különböző domaineken és kulcsszócsonkokon belül.

A Ranktracker tömeges címkézési funkciót is biztosít, így nagy kulcsszócsoportok is rendszerezhetők anélkül, hogy egyedi kéréseket kellene benyújtani.

Egy erre vonatkozó útmutató itt érhető el:

https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

A fiókhasználat és a kvóta figyelemmel kísérése

Az automatizált rendszereknek is ismerniük kell a rendelkezésükre álló fiókforrásokat.

A Ranktracker API a következőket biztosítja:

GET /v1/account/usage

Ez a végpont jelentést ad a fiók használatáról és korlátairól.

Az aktuális használati információk a következőket tartalmazhatják:

• API-hozzáférési állapot
• Kulcsszavak
• Adatsorok
• Igény szerinti használat
• SERP Analyser használata

Minden kvóta olyan értékeket adhat meg, mint például:

• Használat
• Korlát
• Maradt

Ez lehetővé teszi az alkalmazás számára, hogy egy nagy művelet megkezdése előtt ellenőrizze a rendelkezésre álló kapacitást.

Például több ezer kulcsszó importálása előtt a rendszer lekérdezheti a fiók használatát, és meghatározhatja, mennyi kapacitás maradt.

Olvassa el a teljes útmutatót:

https://developers.ranktracker.com/guides/usage-and-quota/

Hogyan működik a Ranktracker API hitelesítése

A Ranktracker REST API-kérelmek hitelesítése API-kulcs segítségével történik.

A kulcsokat közvetlenül a Ranktrackerben hozhatja létre és kezelheti:

https://app.ranktracker.com/account/api

Az API-kulcsát mindig jelszóként kell kezelnie.

A termelési API alap-URL-je:

https://api.ranktracker.com

Az API-erőforrások a /v1 útvonal alatt találhatók.

Például:

https://api.ranktracker.com/v1/domains

Az API-kulcsot közvetlenül az Authorization fejlécben küldjük el.

A szabványos REST API-kérelmeknél nincs Bearer előtag.

Példa:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

A Ranktracker API-kulcsot a szerveren kell tárolni, és soha nem szabad nyilvánosságra hozni a következő csatornákon keresztül:

• Böngésző JavaScript
• Front-end forráskód
• Nyilvános tárolók
• Mobilalkalmazás kódja
• Nyilvános konfigurációs fájlok

További információkért olvassa el:

Gyors útmutató: https://developers.ranktracker.com/guides/quickstart/

Hitelesítés: https://developers.ranktracker.com/guides/authentication/

API-kulcsok létrehozása/kezelése: https://app.ranktracker.com/account/api

API-erőforrások felépítése

A Ranktracker UUID-ket használ az erőforrások azonosítására.

Ide tartoznak például az alábbi erőforrások:

• Domainok
• Kulcsszavak
• Versenytársak
• Címkék

Egy egyszerűsített ábrázolás így néz ki:

Fiók
│
├── Használat
├── Címkék
│
└── Domainok
    │
    ├── Rangsor-előzmények
    ├── Share of Voice
    ├── Versenytársak
    │
    └── Kulcsszavak
        │
        ├── SERP
        ├── SERP HTML-tárhely
        └── Címkék

Ezáltal az API felépítése kiszámíthatóvá válik.

Egy domainhez kulcsszavak és versenytársak tartoznak.

Egy kulcsszó egy nyomon követett domainhez tartozik, és hozzá tartozó SERP- és rangsorolási információkkal rendelkezik.

A címkék fiók szinten léteznek, és hozzárendelhetők a kulcsszavakhoz.

További információ:

https://developers.ranktracker.com/guides/concepts/

JSON API-válaszok

A Ranktracker válaszai egységes JSON:API-stílusú burkolatot használnak.

Az erőforrás a „data” alatt kerül visszaadásra, míg a mezői az „attributes” alatt vannak tárolva.

Például:

{
  "data": {
    "id": "DOMAIN_UUID",
    "type": "domain",
    "attributes": {
      "host": "www.example.com",
      "projectName": "Example",
      "matchType": "any"
    }
  }
}

A fejlesztőknek figyelniük kell egy fontos névkonvencióra is:

• Az API-válaszok camelCase-t használnak
• Az írási kérések törzse snake_case-t használ

Például egy válasz tartalmazhatja a következőket:

projectName

míg egy írási kérés a következőt használja:

project_name

Ez a szabály az API egészére vonatkozik.

Lásd:

https://developers.ranktracker.com/guides/concepts/

Oldalszámozás

A lista végpontok lapozásra kerülnek, így az alkalmazások hatékonyan tudnak működni nagy Ranktracker-fiókokkal is.

Az oldalszámozás a következő erőforrásokra vonatkozik:

• Domainok
• Kulcsszavak
• Versenytársak
• Címkék

A két fő paraméter a következő:

• oldal
• oldalonként

A per_page paraméter oldalanként legfeljebb 1 000 rekordot támogat.

Az oldalszámozásra vonatkozó információkat a válaszfejlécekben adjuk vissza, többek között:

• X-Összes szám
• X-Összes oldal
• X-Oldalonként
• X-Aktuális oldal

Nagy méretű exportok esetén az alkalmazások így addig folytathatják az oldalak lekérését, amíg a teljes adatkészlet be nem érkezik.

Olvassa el az oldalszámozási útmutatót:

https://developers.ranktracker.com/guides/pagination/

Hibakezelés és sebességkorlátozások

A Ranktracker API szabványos HTTP-állapotkódokat használ, hogy a hibákat programozási szempontból könnyebben lehessen kezelni.

A leggyakoribb válaszok a következők:

Állapot	Jelentés	Példa
400	Hibás kérés	Egy kötelező paraméter hiányzik vagy hibás
402	A kvóta túllépése	A kért művelet túllépné a fiók korlátját
403	Tiltva	A kérés nem engedélyezett, vagy az API-hozzáférés nem elérhető
404	Nem található	Az erőforrás nem létezik a fiókban
422	Érvényesítési hiba	A kérés érvényes JSON, de érvénytelen adatokat tartalmaz
429	Túl sok kérés	Az integrációra sebességkorlátozás vonatkozik

Ha 429-es válasz érkezik, az integrációknak figyelembe kell venniük a visszaküldött Retry-After információt, mielőtt újra megpróbálnák a műveletet.

Ez lehetővé teszi a termelési alkalmazások számára, hogy az ideiglenes korlátozásokat kezeljék anélkül, hogy egyszerűen meghibásodnának.

A hibákra és a sebességkorlátozásokra vonatkozó teljes dokumentáció itt érhető el:

https://developers.ranktracker.com/guides/errors-and-rate-limits/

Ranktracker REST API vs. MCP

A REST API nem az egyetlen módja annak, hogy külső szoftvereket csatlakoztassunk a Ranktrackerhez.

A Ranktracker egy hosztolt MCP-kiszolgálót is biztosít.

Az MCP a Model Context Protocol rövidítése, és lehetővé teszi a kompatibilis AI-alkalmazások és ügynökök számára, hogy közvetlenül a Ranktracker adataival dolgozzanak.

Ide tartoznak az alábbi kompatibilis kliensek:

• ChatGPT
• Claude
• Cursor
• Egyéb MCP-kompatibilis AI-alkalmazások

A REST és az MCP ugyanazt az alapul szolgáló Ranktracker-adatállományt használja, de különböző munkafolyamatokhoz lettek kialakítva.

	Ranktracker REST API	Ranktracker MCP
Legalkalmasabb	Alkalmazások, irányítópultok, adattárak és ütemezett feladatok	AI-asszisztensek és ügynökök
Hívó	A háttérrendszered vagy HTTP-kliensed	ChatGPT, Claude, Cursor vagy más MCP-kliens
Interfész	REST végpontok	MCP-eszközök
REST útvonal	/v1/...	/mcp
Jellemző felhasználás	SEO-adatok automatikus áthelyezése és kezelése	A SEO-adatok párbeszédszerű feltárása

Például a REST a jobb választás, ha az alábbiakat szeretné elérni:

• Rangsorok exportálása minden éjjel
• BI-dashboard frissítése
• SEO-projektek automatikus létrehozása
• Kulcsszavak hozzáadása az alkalmazásból
• A rangsoradatok szinkronizálása egy adatbázissal

Az MCP jobban megfelel az alábbi típusú kérdésekre:

Melyik nyomon követett kulcsszavam esett vissza a legjobban ezen a héten?

vagy:

Melyik versenytársak láthatósága nőtt a legjobban?

Egy AI-kliens kiválaszthatja a megfelelő Ranktracker-eszközt, és lekérdezheti a releváns adatokat.

Számos fejlett SEO-csapat mindkettőt használja.

A REST kezeli az infrastruktúrát és az automatizálást. Az MCP elérhetővé teszi a Ranktracker adatait az AI-ügynökök számára.

További információk:

MCP áttekintés: https://developers.ranktracker.com/mcp/

MCP-ügyfél csatlakoztatása: https://developers.ranktracker.com/mcp/connect/

MCP eszközhivatkozás: https://developers.ranktracker.com/mcp/tools/

Mit lehet létrehozni a Ranktracker API segítségével?

A Ranktracker API-val sokkal többet lehet csinálni, mint csak a kulcsszavak pozíciójának megjelenítését.

Íme néhány a leghasznosabb alkalmazások közül.

Automatizált SEO-jelentések

Egy ügynökség automatikusan beolvashatja a rangsorolási információkat a saját jelentéskészítő platformjába.

Ahelyett, hogy:

Ranktracker megnyitása
↓
CSV exportálása
↓
Táblázat szerkesztése
↓
Jelentés feltöltése
↓
Elküldés az ügyfélnek

a következőket hozhatja létre:

Ranktracker API
↓
Jelentéskészítő platform
↓
Automatikusan frissülő ügyféljelentés

Ez különösen értékes azoknak az ügynökségeknek, amelyek nagy számú ügyfelet kezelnek.

Egyedi SEO-irányítópultok

Lehet, hogy cége már használ valamilyen belső jelentéskészítő vagy üzleti intelligencia platformot.

Az API lehetővé teszi, hogy a Ranktracker adatai egy újabb adatforrásként megjelenjenek ebben a környezetben.

Olyan irányítópultokat hozhat létre, amelyek a következőket jelenítik meg:

• Kulcsszavak rangsorolása
• Rangsorváltozások
• A 3 legnépszerűbb kulcsszó
• A 10 legnépszerűbb kulcsszó
• A 100 legnépszerűbb kulcsszó
• Piaci részesedés
• Versenytársak láthatósága
• SERP-funkciók
• AI-áttekintés megjelenései

Az így létrehozott irányítópult pontosan a vállalat jelentési igényeihez igazítható.

Automatizált ügyfél-bevezetés

A SEO-ügynökségek beépíthetik a Ranktrackert az ügyfél-bevezetési folyamatukba.

Például:

Az ügyfél megvásárolja a SEO-csomagot
↓
A CRM létrehozza az ügyfelet
↓
A Ranktracker API létrehozza a domaint
↓
Hozzáadódnak a kulcsszavak
↓
Hozzáadódnak a versenytársak
↓
Megkezdődik a nyomon követés

Ezzel elkerülhető a projekt ismétlődő, manuális beállítása.

SEO-adattárak

A rangsorok értékesebbé válnak, ha összekapcsolják őket más marketing- és üzleti adatokkal.

A Ranktracker adatai kombinálhatók a következőkkel:

• Google Search Console
• Analitika
• CRM-adatok
• Konverziós adatok
• E-kereskedelmi bevétel
• Lehetőségi adatok
• Tartalomteljesítmény

Ez segíthet olyan, a rangsor egyszerű ellenőrzésénél sokkal fontosabb kérdések megválaszolásában.

Például:

Mely rangsorjavulások generálták a legtöbb bevételt?

vagy:

Mely kulcsszócsoportok növelik a láthatóságot, de nem generálnak konverziókat?

Rangsor-riasztások

A korábbi rangsoradatok egyedi riasztási rendszerek működtetésére is felhasználhatók.

Egy integráció automatikusan felismerheti, amikor:

• Egy kulcsszó kiesik a Top 3-ból
• Egy oldal bekerül a Top 10-be
• Egy kulcsszó bekerül a Top 100-ba
• Egy fontos kulcsszó kiesik a Top 100-ból
• Egy versenytárs megelőzi a webhelyét
• A keresési láthatóság hirtelen csökken

A riasztások ezután elküldhetők a saját e-mail címére, a Slackbe, a belső irányítópultra vagy a felügyeleti rendszerbe.

Versenyinformációk

A következők kombinálásával:

• Rangsorok
• Versenytársak nyomon követése
• Rangsor-előzmények
• Piaci részesedés

megteremti az automatizált versenytársi SEO-figyelő rendszer alapját.

Ahelyett, hogy néhány havonta egyszer értékelnéd a versenytársakat, keresési láthatóságuk folyamatosan figyelemmel kísérhető mutatóvá válhat.

Programozott SEO-figyelés

A programozott SEO több ezer vagy akár több százezer céloldalt is létrehozhat.

Ezeket a projekteket manuálisan figyelemmel kísérni nem reális.

A Ranktracker API lehetővé teszi a fejlesztők számára, hogy olyan rangsorolási munkafolyamatokat hozzanak létre, amelyek képesek nagy kulcsszó-adatkészletek kezelésére, és az eredményül kapott információkat automatikusan továbbítják a belső elemzési rendszerekbe.

Mesterséges intelligenciával támogatott SEO-elemzés

A Ranktracker REST API-ja és MCP-kiszolgálója szintén beépíthető az AI-vezérelt SEO-munkafolyamatokba.

Például az AI-rendszerek a következőket segíthetik elő:

• A rangsorvesztések azonosítása
• A rangsorváltozások összefoglalása
• Gyorsan fejlődő kulcsszavak felkutatása
• A versenytársak láthatóságának összehasonlítása
• A SERP-változások elemzése
• A SEO-lehetőségek fontossági sorrendbe állítása
• Belső jelentések készítése
• Vizsgálja meg a szokatlan rangsorváltozásokat

Az API biztosítja a strukturált adatokat, míg a mesterséges intelligencia segíthet azok értelmezésében.

Kiknek szól a Ranktracker API?

A Ranktracker API különösen hasznos a következő esetekben:

• SEO-ügynökségek
• Vállalati SEO-csapatok
• SaaS-vállalkozások
• SEO szoftvercégek
• Fejlesztők
• Adatmérnökök
• BI-csapatok
• E-kereskedelmi vállalkozások
• Partnerprogram-marketingesek
• Kiadók
• Több telephelyen működő vállalkozások
• Programmatikus SEO-csapatok
• Mesterséges intelligencia-alapú automatizálási csapatok

Ha a rangsorolási adatokat automatikusan kell lekérni, áthelyezni, elemezni vagy kezelni, az API általában sokkal skálázhatóbb megoldás, mint a kézi exportálás.

Miért érdemes a Ranktrackert használni a saját rangkövető infrastruktúra kiépítése helyett?

A keresési rangsorok nagy léptékű összegyűjtése sokkal többet jelent, mint egy Google-keresés elvégzése.

Egy termeléskész rangkövető rendszernek figyelembe kell vennie a következőket:

• Helyszínek
• Nyelvek
• Eszközök
• A legjobb 100 találat gyűjteménye
• SERP-funkciók
• AI-áttekintések
• Kulcsszó-konfiguráció
• Korábbi rangsoradatok
• Versenytársak
• Ütemezés
• A keresési eredmények változásai
• Adattárolás
• Jelentések

Az egész infrastruktúra belső kiépítése és karbantartása jelentős fejlesztési erőforrásokat igényelhet.

A Ranktracker kezeli a rangkövetési infrastruktúrát, és a kapott adatokat strukturált API-n keresztül teszi elérhetővé.

Fejlesztői így az alkalmazás, a vezérlőpult, a munkafolyamat vagy az elemzés kialakítására koncentrálhatnak, amire vállalkozásának ténylegesen szüksége van.

Hogyan kezdje el a Ranktracker API használatát

A kezdéshez csupán néhány lépés szükséges.

1. Nyissa meg az API-beállításokat

Lépjen közvetlenül ide:

https://app.ranktracker.com/account/api

Hozzon létre egy API-kulcsot, és tárolja biztonságosan.

2. Olvassa el a gyors útmutatót

Kövesse a hivatalos gyors útmutatót:

https://developers.ranktracker.com/guides/quickstart/

3. Küldje el az első kérését

Például:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

4. Fedezze fel az API-referenciát

A teljes REST API-referencia itt érhető el:

https://developers.ranktracker.com/rest-api/

5. Kezdje el a fejlesztést

Innen kezdheti el a Ranktracker összekapcsolását a következőkkel:

• Az Ön alkalmazása
• A jelentéskészítési rendszer
• Az Ön adatraktára
• A CRM-je
• Belső eszközei
• Az Ön AI-munkafolyamatai

Ranktracker API dokumentáció

A teljes fejlesztői dokumentáció itt található:

Fejlesztői dokumentáció: https://developers.ranktracker.com/

API-kulcsok létrehozása és kezelése: https://app.ranktracker.com/account/api

Gyors útmutató: https://developers.ranktracker.com/guides/quickstart/

Hitelesítés: https://developers.ranktracker.com/guides/authentication/

Alapfogalmak: https://developers.ranktracker.com/guides/concepts/

Oldalszámozás: https://developers.ranktracker.com/guides/pagination/

Hibák és sebességkorlátozások: https://developers.ranktracker.com/guides/errors-and-rate-limits/

Használat és kvóta: https://developers.ranktracker.com/guides/usage-and-quota/

Tömeges műveletek: https://developers.ranktracker.com/guides/bulk-operations/

Útmutató a domain nyomon követéséhez: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Rangsorok raktárba helyezése – útmutató: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Share of Voice útmutató: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Tömeges címkézés útmutató: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

REST API-referencia: https://developers.ranktracker.com/rest-api/

MCP-kiszolgáló: https://developers.ranktracker.com/mcp/

MCP-kliens csatlakoztatása: https://developers.ranktracker.com/mcp/connect/

MCP eszköz referencia: https://developers.ranktracker.com/mcp/tools/

Kezdje el a fejlesztést a Ranktracker API-val

A Ranktracker API segítségével a Ranktracker egy SEO-irányítópultból olyan infrastruktúrává válik, amely közvetlenül beépíthető a technológiai rendszerébe.

Használhatja domainek és kulcsszavak kezelésére, versenytársak nyomon követésére, a Top 100 rangsorok lekérésére, a SERP-ek elemzésére, AI-áttekintések felismerésére, a Share of Voice figyelemmel kísérésére, a korábbi rangsoradatok elérésére, kulcsszavak szervezésére, jelentési folyamatok kialakítására, valamint a SEO-információk integrálására a vállalkozás többi részével.

A fejlesztők számára ez feleslegessé teszi a rangsoradatok kézi exportálását és áthelyezését.

Az ügynökségek számára lehetővé teszi a nagyméretű ügyfél-automatizálást.

A nagyvállalati SEO-csapatok számára lehetővé teszi, hogy a rangsorolási információk a belső elemzési és adatinfrastruktúra részévé váljanak.

A Ranktracker MCP-kiszolgálójával pedig ugyanazok az alapul szolgáló SEO-adatok hozzáférhetővé tehetők az AI-asszisztensek és -ügynökök számára is.

Hozzon létre Ranktracker API-kulcsot: https://app.ranktracker.com/account/api

Olvassa el a dokumentációt: https://developers.ranktracker.com/

Tekintse meg a REST API-referenciát: https://developers.ranktracker.com/rest-api/