• Nástroje pre SEO

API nástroja Rank Tracker

  • Felix Rose-Collins
  • 16 min read

Úvod

Sledovanie pozícií sa stáva úplne iným problémom, keď spravujete stovky webových stránok, tisíce kľúčových slov alebo SEO reporty, ktoré sa musia automaticky aktualizovať.

Prihlásenie sa do riadiaceho panela a ručný export údajov môže fungovať pri menších projektoch. Pri väčšom rozsahu sa to však rýchlo stáva prekážkou.

Preto sme vytvorili Ranktracker API.

Ranktracker API je teraz v prevádzke a poskytuje vývojárom, SEO tímom, agentúram, SaaS spoločnostiam a dátovým tímom programový prístup k ich údajom v Ranktrackeri.

Toto rozhranie môžete využiť na:

  • Načítanie rebríčka 100 najpopulárnejších kľúčových slov
  • Získajte prístup k údajom SERP
  • Zistite prehľady AI a ďalšie funkcie SERP
  • Vytváranie a správa sledovaných domén
  • Pridávanie a správa kľúčových slov
  • Sledujte konkurentov
  • Prístup k histórii pozícií
  • Vypočítajte podiel na trhu
  • Usporiadajte kľúčové slová pomocou značiek
  • Monitorujte využitie účtu a kvóty
  • Vytvorte automatizované procesy vykazovania SEO
  • Prepojte údaje o pozíciách s internými aplikáciami a riadiacimi panelmi

Namiesto ručného presúvania SEO údajov medzi platformami umožňuje Ranktracker API vášmu vlastnému softvéru pracovať priamo s infraštruktúrou hodnotenia, na ktorej je Ranktracker založený.

Vytvorenie alebo správa vášho kľúča API: https://app.ranktracker.com/account/api

Zoznámte sa s nástrojom Ranktracker

Platforma "všetko v jednom" pre efektívne SEO

Za každým úspešným podnikaním stojí silná kampaň SEO. Pri nespočetnom množstve optimalizačných nástrojov a techník, z ktorých si môžete vybrať, však môže byť ťažké zistiť, kde začať. No už sa nemusíte báť, pretože mám pre vás presne to, čo vám pomôže. Predstavujem komplexnú platformu Ranktracker na efektívne SEO

Konečne sme otvorili registráciu do nástroja Ranktracker úplne zadarmo!

Vytvorenie bezplatného konta

Alebo sa pri hláste pomocou svojich poverení

Prečítajte si dokumentáciu k API: https://developers.ranktracker.com/

Čo je API Ranktracker?

API API Ranktracker je REST API, ktoré poskytuje programový prístup k vášmu účtu Ranktracker.

Namiesto toho, aby ste museli otvárať Ranktracker zakaždým, keď potrebujete informácie o pozíciách, vaša aplikácia môže o údaje požiadať automaticky.

API je postavené na tých istých základných zdrojoch, ktoré sa používajú v celom Ranktrackeri:

  • Účty
  • Domény
  • Kľúčové slová
  • Konkurenti
  • História pozícií
  • Údaje SERP
  • Podiel na diskusii
  • Tagy
  • Využitie a kvóta

To dáva vývojárom možnosť nielen získavať údaje z Ranktrackeru, ale aj spravovať to, čo Ranktracker sleduje.

Napríklad agentúra zaoberajúca sa SEO by mohla automaticky vytvoriť projekt v Ranktrackeri, keď sa nový klient zaregistruje v jej CRM, pridať kľúčové slová a konkurentov daného klienta a následne prenášať ich pozície v rebríčku do interného reportovacieho panela.

Platforma SaaS by mohla použiť to isté API na zobrazenie údajov o pozíciách priamo vo svojom vlastnom produkte.

Tím zodpovedný za údaje by mohol automaticky odosielať denné pozície do BigQuery, Snowflake, PostgreSQL, Google Sheets alebo iného dátového skladu na ďalšiu analýzu.

Zoznámte sa s nástrojom Ranktracker

Platforma "všetko v jednom" pre efektívne SEO

Za každým úspešným podnikaním stojí silná kampaň SEO. Pri nespočetnom množstve optimalizačných nástrojov a techník, z ktorých si môžete vybrať, však môže byť ťažké zistiť, kde začať. No už sa nemusíte báť, pretože mám pre vás presne to, čo vám pomôže. Predstavujem komplexnú platformu Ranktracker na efektívne SEO

Konečne sme otvorili registráciu do nástroja Ranktracker úplne zadarmo!

Vytvorenie bezplatného konta

Alebo sa pri hláste pomocou svojich poverení

Prehľad o tom, ako tieto zdroje do seba zapadajú, nájdete v príručke Základné pojmy API Ranktracker.

Top 100 rebríčkov ako predvolené nastavenie

Jednou z najväčších výhod rozhrania API Ranktracker je hĺbka údajov o rebríčkoch.

Každá kontrola kľúčových slov štandardne zahŕňa prvých 100 výsledkov vyhľadávania Google.

To znamená, že môžete analyzovať všetkých 10 stránok výsledkov vyhľadávania namiesto toho, aby ste videli len to, čo sa momentálne nachádza na prvej stránke.

To je dôležité, pretože pokrok v SEO zvyčajne začína dlho predtým, ako sa kľúčové slovo dostane do Top 10.

Kľúčové slovo sa môže posúvať:

91. miesto → 63. miesto → 37. miesto → 18. miesto → 9. miesto

To predstavuje významný pokrok v oblasti SEO.

Ak sa vaše údaje o umiestnení končia pri prvých 10 výsledkoch, takmer celá táto cesta zostáva neviditeľná.

Sledovanie Top 100 vám umožňuje monitorovať:

  • Nové umiestnenia v Top 100 Googlu
  • Kľúčové slová posúvajúce sa na prvú stranu
  • Výrazné zlepšenia a zhoršenia v rebríčku
  • Pohyb konkurencie
  • Viditeľnosť pri vyhľadávaní s dlhým chvostom
  • Výkonnosť nového obsahu
  • Programové SEO kampane
  • Rozsiahle portfóliá kľúčových slov

Vďaka tomu je toto API užitočné ako pre všeobecné SEO reporty, tak aj pre podrobnú analýzu pozícií.

Zistite viac o API:

https://developers.ranktracker.com/

Sledujte pozície vo viac ako 107 000 lokalitách

Výsledky vyhľadávania sa výrazne líšia v závislosti od miesta, kde sa vyhľadávanie vykonáva.

Ranktracker podporuje viac ako 107 000 lokalít, čo tímom umožňuje sledovať viditeľnosť vo vyhľadávaní na miestnej, národnej aj medzinárodnej úrovni prostredníctvom API.

Sledovanie kľúčových slov je možné nakonfigurovať na základe rôznych faktorov, medzi ktoré patria:

  • Vyhľadávač
  • Poloha
  • Jazyk
  • Zariadenie

Napríklad to isté kľúčové slovo je možné sledovať samostatne pre:

  • Spojené štáty — stolný počítač
  • Spojené štáty — mobil
  • Spojené kráľovstvo — počítač
  • Nemecko — mobil
  • Poľsko — počítač

Každú konfiguráciu je možné považovať za samostatné sledované kľúčové slovo.

To je obzvlášť užitočné pre:

  • Medzinárodné SEO
  • Podniky s viacerými pobočkami
  • Agentúry pre lokálne SEO
  • E-commerce podniky
  • Vydavatelia pôsobiaci na rôznych trhoch
  • Spoločnosti poskytujúce služby SaaS zamerané na viaceré krajiny
  • Firemné SEO tímy

Namiesto toho, aby ste kľúčové slovo považovali za slovo s jednou univerzálnou pozíciou v rebríčku, môžete analyzovať, ako sa viditeľnosť mení na rôznych trhoch a zariadeniach.

Sledovanie pozícií na počítačoch a mobilných zariadeniach

Výsledky vyhľadávania na počítačoch a mobilných zariadeniach sa môžu líšiť.

Ranktracker preto umožňuje segmentáciu sledovania kľúčových slov podľa zariadenia.

To znamená, že integrácia môže samostatne analyzovať:

  • Poradie vo výsledkoch vyhľadávania na počítačoch
  • Hodnotenia na mobilných zariadeniach

Napríklad stránka môže mať vysoké umiestnenie na počítači, ale na mobilných zariadeniach môže dosahovať odlišné výsledky kvôli rozdielom v rozložení SERP, lokálnych výsledkoch alebo iných funkciách vyhľadávania.

Oddelenie týchto dátových súborov poskytuje SEO tímom oveľa jasnejší obraz o tom, ako používatelia skutočne vnímajú ich webové stránky vo vyhľadávaní.

API tiež umožňuje segmentáciu podľa zariadení pri práci s funkciami, ako je napríklad Share of Voice.

Detekcia funkcií SERP a prehľad umelej inteligencie

Moderné výsledky vyhľadávania Google obsahujú oveľa viac než tradičné organické záznamy.

Výsledky vyhľadávania (SERP) môžu obsahovať:

  • Prehľady umelej inteligencie
  • Vybrané úryvky
  • Mapy
  • Lokálne výsledky
  • Videá
  • Výsledky nákupov
  • Ľudia sa tiež pýtajú
  • Ďalšie funkcie vyhľadávania

API Ranktracker obsahuje informácie o funkciách SERP a detekciu prehľadu umelej inteligencie spolu s údajmi o kľúčových slovách.

To znamená, že vaša integrácia môže analyzovať nielen to, kde sa webová stránka umiestňuje v rebríčku, ale aj to, čo toto umiestnenie v Google obklopuje.

Napríklad môžete identifikovať:

  • Kľúčové slová, ktoré spúšťajú AI Prehľad
  • Výsledky vyhľadávania obsahujúce odporúčané úryvky
  • Vyhľadávacie dotazy, v ktorých prevládajú videá
  • Kľúčové slová, ktoré generujú lokálne výsledky alebo výsledky na mape
  • Zmeny v zložení výsledkov vyhľadávania v priebehu času

Toto je čoraz dôležitejšie, pretože samotná organická pozícia nie vždy vypovedá o celkovej situácii.

Stránka, ktorá sa umiestňuje na treťom mieste v tradičnom SERP, a stránka, ktorá sa umiestňuje na treťom mieste pod prehľadom AI, balíkom máp, videami a sekciou „Ľudia sa tiež pýtajú“, môžu mať veľmi odlišnú úroveň viditeľnosti.

Toto rozhranie API umožňuje, aby sa tieto rozdiely stali súčasťou vašej SEO analýzy.

Pozrite si kompletnú dokumentáciu k API:

https://developers.ranktracker.com/

Prístup k úplným údajom SERP

Ranktracker ponúka oveľa viac než len jedno číslo poradia.

Pre sledované kľúčové slová môže API poskytovať najnovšie výsledky vyhľadávania spolu s príslušnými informáciami o SERP.

Štruktúra zdrojov API zahŕňa:

  • Najnovšie údaje o výsledkoch vyhľadávania
  • Informácie o poradí
  • Funkcie SERP
  • Uložené HTML SERP

To znamená, že vývojári môžu vytvárať pracovné postupy založené na skutočných výsledkoch vyhľadávania, namiesto toho, aby jednoducho ukladali napríklad:

Pozícia: 12

Pre pokročilé SEO tímy to poskytuje oveľa väčšiu flexibilitu.

Informácie SERP môžete využiť na:

  • Analýza konkurenčných URL
  • Vyšetrujte neočakávané zmeny v poradí
  • Identifikácia zmien v rozložení výsledkov
  • Vytvorenie interných nástrojov na analýzu SERP
  • Ukladanie historických informácií o SERP
  • Vkladanie informácií o výsledkoch vyhľadávania do iných modelov alebo analytických systémov

Kompletný zoznam koncových bodov nájdete tu:

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

Správa domén prostredníctvom API

Domény sú jedným z kľúčových zdrojov rozhrania API Ranktracker.

REST API vám umožňuje:

  • Vytvárajte domény
  • Načítanie domén
  • Aktualizovať domény
  • Odstránenie domén

Doména predstavuje webovú stránku sledovanú v rámci Ranktrackeru.

Každá doména môže obsahovať:

  • Kľúčové slová
  • Konkurenti
  • História pozícií
  • Údaje o podiele na trhu

To umožňuje automatizované pridávanie.

Napríklad agentúra by mohla vytvoriť nasledujúci pracovný postup:

Nový klient sa zaregistruje
        ↓
Vytvorenie domény v Ranktracker
        ↓
Pridanie kľúčových slov klienta
        ↓
Pridanie konkurentov
        ↓
Začatie sledovania pozícií
        ↓
Odoslanie údajov do reportovacieho panela

Člen tímu nemusí ručne konfigurovať každý nový projekt.

Kompletný návod je k dispozícii v tutoriáli návode Pridať doménu a sledovať kľúčové slová.

Programové pridávanie a správa kľúčových slov

Akonáhle doména existuje, kľúčové slová je možné spravovať prostredníctvom API.

Pomocou rozhrania API môžete pridávať sledované kľúčové slová a zároveň špecifikovať konfiguráciu vyhľadávania, ktorá sa k nim viaže.

Údaje o sledovaných kľúčových slovách môžu zahŕňať faktory, ako napríklad:

  • Slovo
  • Vyhľadávač
  • Miesto
  • Jazyk
  • Zariadenie
  • Výsledky poradia

Môžete tiež spravovať životný cyklus sledovania existujúcich kľúčových slov.

To zahŕňa možnosť:

  • Načítanie kľúčových slov
  • Prečítajte si informácie o ich umiestnení
  • Pozastaviť sledovanie
  • Obnoviť sledovanie
  • Zastaviť sledovanie
  • Získať informácie o SERP
  • Priradiť tagy

Vďaka tomu môže vaša vlastná aplikácia riadiť, ktoré kľúčové slová Ranktracker monitoruje.

Hromadné sledovanie kľúčových slov

Veľké SEO účty by nemali musieť posielať jednu požiadavku na API pre každé kľúčové slovo.

Ranktracker podporuje hromadné operácie s kľúčovými slovami.

Koncový bod na vytváranie kľúčových slov akceptuje konfiguráciu „slová × vyhľadávače“, čo umožňuje vytvoriť mnoho kombinácií sledovaných kľúčových slov v jednej požiadavke.

Predstavte si napríklad, že chcete sledovať:

  • 100 kľúčových slov
  • Počítač v USA
  • Mobilné zariadenia v USA

Tieto konfigurácie môžu vytvoriť 200 sledovaných kombinácií kľúčových slov bez potreby 200 individuálnych požiadaviek na nastavenie.

Hromadné operácie sú obzvlášť užitočné pre:

  • Agentúry
  • SEO pre veľké podniky
  • Veľké e-shopy
  • Programatické SEO
  • SaaS platformy pre SEO
  • Veľkí vydavatelia obsahu

Ranktracker tiež podporuje hromadné označovanie kľúčových slov.

Prečítajte si kompletnú príručku k hromadným operáciám:

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

Sledovanie konkurentov v oblasti SEO

Hodnotenia sa stávajú oveľa užitočnejšími, keď zahŕňajú konkurenčný kontext.

API Ranktracker umožňuje spravovať konkurentov vo vzťahu k sledovaným doménam.

Vďaka tomu je možné automaticky analyzovať vašu výkonnosť vo vyhľadávaní v porovnaní s konkurenčnými webovými stránkami.

Údaje o konkurencii môžete využiť na monitorovanie:

  • Ktorí konkurenti získavajú na viditeľnosti
  • Ktoré stránky predbiehajú vašu doménu
  • Zmeny v skupinách zdieľaných kľúčových slov
  • Trendy v konkurenčnom poradí
  • Relatívna viditeľnosť vo vyhľadávaní
  • Zmeny v podiele na trhu

Pre agentúry sa to môže stať súčasťou automatizovaného systému vykazovania pre klientov.

Namiesto toho, aby ste každý mesiac ručne porovnávali klienta s konkurentmi, je možné príslušné údaje integrovať priamo do procesu vykazovania.

Prístup k historickým údajom o pozíciách

Aktuálne pozície v rebríčku ukazujú len to, čo sa deje práve teraz.

Historické údaje o pozíciách ukazujú, akým smerom sa vyvíja výkonnosť SEO.

Ranktracker poskytuje históriu pozícií domén prostredníctvom API, čo umožňuje vývojárom analyzovať viditeľnosť v priebehu času.

Historické údaje môžu pomôcť identifikovať:

  • Zlepšenie pozícií
  • Poklesy v rebríčku
  • Trendy viditeľnosti
  • Pohyb kľúčových slov
  • Zmeny po SEO kampaniach
  • Vplyv aktualizácie Google
  • Dlhodobá výkonnosť kampaní

Históriu pozícií môžete tiež využiť na vytváranie vlastných grafov a prehľadových panelov.

Napríklad:

API Ranktracker
       ↓
Denné získavanie údajov o pozíciách
       ↓
Dátový sklad
       ↓
Historický súbor údajov o SEO
       ↓
Prehľadový panel / Upozornenia / Analýza

Ranktracker poskytuje špeciálny návod, ktorý ukazuje, ako načítať denné pozície do dátového skladu:

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

Odosielanie údajov z Ranktrackeru do dátového skladu

Jedným z najužitočnejších pracovných postupov API je automatické ukladanie údajov z Ranktrackeru do vašej vlastnej databázy alebo dátového skladu.

Napríklad údaje o pozíciách v rebríčku je možné odoslať do:

  • BigQuery
  • Snowflake
  • PostgreSQL
  • MySQL
  • Tabuľky Google
  • Interné analytické databázy

Tieto informácie je potom možné kombinovať s inými obchodnými údajmi.

Napríklad:

Ranktracker
     ↓
Ranktracker API
     ↓
Dátový sklad
     ↓
Google Search Console
Analytics
Konverzie
Tržby
Údaje z CRM
     ↓
Dashboard Business Intelligence

Vďaka tomu získate oveľa komplexnejší prehľad o výkonnosti SEO.

Namiesto toho, aby ste len vedeli, že sa kľúčové slovo posunulo z 8. na 3. pozíciu, môžete analyzovať, či táto zmena viedla aj k:

  • Viac organických kliknutí
  • Viac potenciálnych zákazníkov
  • Vyššie miery konverzie
  • Vyššie tržby

Návod Návod „Od rebríčka k dátovému skladu“ uvádza príklad vytvorenia tohto typu procesného reťazca.

Vytváranie správ o podiele na trhu

Rozhranie API Ranktracker tiež poskytuje údaje o podiele na trhu (Share of Voice ).

Podiel na hlasoch poskytuje širšie meranie viditeľnosti domény v rámci sledovanej sady kľúčových slov.

Namiesto otázky:

Aké je naše umiestnenie pre toto kľúčové slovo?

môžete sa opýtať:

Aká je naša viditeľnosť na celom tomto vyhľadávacom trhu?

Toto je obzvlášť užitočné, ak sú zahrnuté údaje o konkurencii.

API Share of Voice možno použiť na analýzu:

  • Vaša celková viditeľnosť
  • Viditeľnosť konkurencie
  • Zmeny viditeľnosti v čase
  • Relatívna pozícia na trhu
  • Viditeľnosť na počítačoch
  • Viditeľnosť na mobilných zariadeniach

Koncový bod podporuje časové rozsahy a segmentáciu zariadení, čo umožňuje začleniť Share of Voice do vlastných SEO správ.

Kompletný príklad implementácie je k dispozícii tu:

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

Usporiadajte kľúčové slová pomocou značiek

Veľké portfóliá kľúčových slov sa bez organizácie ťažko spravujú.

Ranktracker poskytuje tagy na úrovni účtu, ktoré je možné priradiť k sledovaným kľúčovým slovám.

Môžete vytvoriť tagy napríklad pre:

  • Kategórie produktov
  • Zámer vyhľadávania
  • Lokalizácie
  • Typy obsahu
  • Kampane
  • Klienti
  • Fázy nákupného procesu
  • Obchodné jednotky
  • Tímy SEO

Napríklad:

„kúpiť bežecké topánky“ → Komerčné
„najlepšie bežecké topánky“ → Porovnanie
„ako čistiť bežecké topánky“ → Informačné

Tie isté značky je možné opakovane používať v rôznych doménach a skupinách kľúčových slov.

Ranktracker tiež ponúka hromadné označovanie, vďaka čomu je možné organizovať veľké skupiny kľúčových slov bez nutnosti vytvárať jednotlivé požiadavky.

Špeciálny návod je k dispozícii tu:

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

Monitorovanie využitia účtu a kvóty

Automatizované systémy musia tiež rozumieť zdrojom účtu, ktoré majú k dispozícii.

API Ranktracker poskytuje:

GET /v1/account/usage

Tento koncový bod hlási využitie účtu a limity.

Informácie o aktuálnom využívaní môžu zahŕňať:

  • Stav prístupu k API
  • Kľúčové slová
  • Riadky údajov
  • Využitie na požiadanie
  • Využitie nástroja SERP Analyser

Každá kvóta môže poskytovať hodnoty, ako napríklad:

  • Využitie
  • Limit
  • Zostávajúce

To umožňuje aplikácii skontrolovať dostupnú kapacitu pred spustením rozsiahlej operácie.

Napríklad pred importom tisícov kľúčových slov môže váš systém zistiť využitie účtu a určiť, koľko kapacity zostáva.

Prečítajte si kompletnú príručku:

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

Ako funguje overovanie prostredníctvom API Ranktracker

Požiadavky na REST API Ranktracker sú overované pomocou kľúča API.

Kľúče môžete vytvárať a spravovať priamo v Ranktrackeri:

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

S vaším API kľúčom by ste mali vždy zaobchádzať ako s heslom.

Základná URL adresa produkčného API je:

https://api.ranktracker.com

Zdroje API sa nachádzajú pod cestou /v1.

Napríklad:

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

Kľúč API sa odosiela priamo v hlavičke Authorization.

Pre štandardné požiadavky REST API sa nepoužíva predpona „Bearer “.

Príklad:

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

Kľúč API Ranktracker by mal byť uchovávaný na strane servera a nikdy by nemal byť zverejnený prostredníctvom:

  • JavaScript prehliadača
  • Zdrojový kód front-endu
  • Verejné repozitáre
  • Kód mobilnej aplikácie
  • Verejné konfiguračné súbory

Ďalšie informácie nájdete tu:

Rýchly štart: https://developers.ranktracker.com/guides/quickstart/

Overovanie: https://developers.ranktracker.com/guides/authentication/

Vytvorenie/správa kľúčov API: https://app.ranktracker.com/account/api

Štruktúra zdrojov API

Ranktracker používa na identifikáciu zdrojov UUID.

Patria sem napríklad také zdroje ako:

  • Domény
  • Kľúčové slová
  • Konkurenti
  • Tagy

Zjednodušené znázornenie vyzerá takto:

Účet
│
├── Využitie
├── Tagy
│
└── Domény
    │
    ├── História pozícií
    ├── Podiel na trhu
    ├── Konkurenti
    │
    └── Kľúčové slová
        │
        ├── SERP
        ├── Uložené SERP HTML
        └── Tagy

Vďaka tomu je štruktúra API predvídateľná.

Doména má kľúčové slová a konkurentov.

Kľúčové slovo patrí k sledovanej doméne a má pridružené informácie o SERP a pozícii.

Tagy existujú na úrovni účtu a môžu byť priradené ku kľúčovým slovám.

Viac informácií:

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

Odpovede JSON API

Odpovede Ranktrackeru používajú jednotný formát JSON:API.

Zdroje sa vracajú v rámci dát, zatiaľ čo ich polia sú uložené v rámci atribútov.

Napríklad:

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

Vývojári by si mali byť vedomí aj dôležitej konvencie pomenovania:

  • Odpovede API používajú camelCase
  • Telo žiadosti o zápis používa snake_case

Odpoveď môže napríklad obsahovať:

projectName

zatiaľ čo požiadavka na zápis používa:

project_name

Táto konvencia platí v celom rozhraní API.

Pozri:

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

Stránkovanie

Koncové body zoznamu sú stránkované, aby aplikácie mohli efektívne pracovať s veľkými účtami Ranktracker.

Paginácia sa vzťahuje na zdroje vrátane:

  • Domény
  • Kľúčové slová
  • Konkurenti
  • Tagy

Dva hlavné parametre sú:

  • stránka
  • na_stránku

per_page podporuje až 1 000 záznamov na stránku.

Informácie o stránkovaní sa vracajú prostredníctvom hlavičiek odpovede, medzi ktoré patria:

  • X-Celkový počet
  • X-Celkový počet strán
  • X-Počet na stránku
  • X-Aktuálna-stránka

Pri rozsiahlych exportoch môžu aplikácie preto pokračovať v žiadaní stránok, kým sa nezíska kompletný súbor údajov.

Prečítajte si príručku k stránkovaniu:

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

Spracovanie chýb a obmedzenia frekvencie

Rozhranie API Ranktracker používa štandardné stavové kódy HTTP, aby bolo možné chyby ľahšie programovo spracovať.

Medzi bežné odpovede patria:

StavVýznamPríklad
400Neplatná požiadavkaChýba povinný parameter alebo má nesprávny formát
402Prekročenie kvótyPožadovaná operácia by prekročila limit účtu
403ZakázanéŽiadosť nie je autorizovaná alebo prístup k API nie je k dispozícii
404NenájdenéZdroje v rámci účtu neexistujú
422Chyba overeniaŽiadosť je v platnom formáte JSON, ale obsahuje neplatné údaje
429Príliš veľa požiadaviekIntegrácia bola obmedzená

Ak sa vyskytne odpoveď 429, integrácie by mali pred ďalším pokusom rešpektovať vrátené informácie Retry-After.

To umožňuje produkčným aplikáciám zvládnuť dočasné obmedzenie bez toho, aby jednoducho zlyhali.

Kompletná dokumentácia k chybám a obmedzeniam frekvencie je k dispozícii tu:

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

Ranktracker REST API vs. MCP

REST API nie je jediným spôsobom, ako pripojiť externý softvér k Ranktracker.

Ranktracker poskytuje aj hostovaný MCP server.

Skratka MCP znamená Model Context Protocol a umožňuje kompatibilným aplikáciám a agentom umelej inteligencie pracovať priamo s údajmi Ranktracker.

Patria sem kompatibilní klienti, ako napríklad:

  • ChatGPT
  • Claude
  • Kurzor
  • Ďalšie aplikácie umelej inteligencie kompatibilné s MCP

REST a MCP pracujú s rovnakými základnými údajmi z Ranktrackeru, sú však určené pre odlišné pracovné postupy.

REST API RanktrackerRanktracker MCP
Najvhodnejšie preAplikácie, riadiace panely, sklady a naplánované úlohyAI asistenti a agenti
VolajúciVáš backend alebo HTTP klientChatGPT, Claude, Cursor alebo iný klient MCP
RozhranieREST koncové bodyNástroje MCP
Cesta REST/v1/.../mcp
Typické použitieAutomatické presúvanie a správa údajov o SEOPreskúmavanie údajov o SEO formou konverzácie

Napríklad REST je lepšou voľbou, ak chcete:

  • Každú noc exportovať rebríčky
  • Aktualizácia BI panela
  • Automatické vytváranie projektov SEO
  • Pridávanie kľúčových slov z vašej aplikácie
  • Synchronizácia údajov o rebríčkoch s databázou

MCP je vhodnejšie pre otázky typu:

Ktoré z mojich sledovaných kľúčových slov tento týždeň klesli najviac?

alebo:

Ktorí konkurenti dosiahli najväčšiu viditeľnosť?

Klient s umelou inteligenciou si môže vybrať vhodný nástroj Ranktracker a vyhľadať relevantné údaje.

Mnohé pokročilé SEO tímy môžu využívať obidva.

REST sa stará o infraštruktúru a automatizáciu. MCP sprístupňuje údaje z Ranktrackeru agentom umelej inteligencie.

Viac informácií:

Prehľad MCP: https://developers.ranktracker.com/mcp/

Pripojenie klienta MCP: https://developers.ranktracker.com/mcp/connect/

Referenčná príručka k nástroju MCP: https://developers.ranktracker.com/mcp/tools/

Čo môžete vytvoriť pomocou API Ranktracker?

Rozhranie API Ranktracker sa dá využiť na oveľa viac než len na zobrazenie pozície kľúčového slova.

Tu je niekoľko najužitočnejších aplikácií.

Automatizované SEO reportovanie

Agentúra môže automaticky načítať informácie o pozíciách do svojej vlastnej platformy na vytváranie správ.

Namiesto:

Otvoriť Ranktracker
↓
Exportovať CSV
↓
Upraviť tabuľku
↓
Nahrať správu
↓
Odoslať klientovi

môžete vytvoriť:

API Ranktracker
↓
Platforma pre vykazovanie
↓
Automaticky aktualizovaná správa pre klienta

Toto je obzvlášť cenné pre agentúry, ktoré spravujú veľký počet klientov.

Vlastné SEO panely

Vaša spoločnosť možno už používa internú platformu na vytváranie správ alebo platformu pre business intelligence.

API umožňuje, aby sa údaje z Ranktrackeru stali ďalším zdrojom údajov v rámci tohto prostredia.

Môžete vytvoriť panely zobrazujúce:

  • Pozície kľúčových slov
  • Zmeny v poradí
  • Top 3 kľúčové slová
  • Top 10 kľúčových slov
  • Top 100 kľúčových slov
  • Podiel na trhu
  • Viditeľnosť konkurencie
  • Funkcie SERP
  • Prehľad výskytov v AI

Výsledný dashboard je možné prispôsobiť konkrétne potrebám vašej spoločnosti v oblasti reportingu.

Automatizované zapojenie klientov

SEO agentúry môžu prepojiť Ranktracker so svojím procesom zapájania klientov.

Napríklad:

Zákazník si zakúpi balík SEO služieb
↓
CRM vytvorí záznam o klientovi
↓
API Ranktracker vytvorí doménu
↓
Pridajú sa kľúčové slová
↓
Pridajú sa konkurenti
↓
Začne sa sledovanie

Tým sa eliminuje opakované ručné nastavovanie projektov.

SEO dátové sklady

Hodnotenie sa stáva cennějším, keď je prepojené s ďalšími marketingovými a obchodnými údajmi.

Informácie z Ranktrackeru je možné kombinovať s:

  • Google Search Console
  • Analytika
  • Údaje z CRM
  • Údaje o konverziách
  • Tržby z e-commerce
  • Údaje o potenciálnych zákazníkoch
  • Výkonnosť obsahu

To môže pomôcť odpovedať na oveľa dôležitejšie otázky než len kontrola rebríčka.

Napríklad:

Ktoré zlepšenia v rebríčku priniesli najväčšie tržby?

alebo:

Ktoré skupiny kľúčových slov zvyšujú viditeľnosť, ale negenerujú konverzie?

Upozornenia na rebríčky

Historické údaje o umiestnení môžu tiež slúžiť ako podklad pre vlastné systémy upozornení.

Integrácia by mohla automaticky zistiť, kedy:

  • Kľúčové slovo vypadlo z Top 3
  • Stránka sa dostala do Top 10
  • Kľúčové slovo sa dostalo do Top 100
  • Dôležité kľúčové slovo zmizne z Top 100
  • Konkurent predbehne vašu webovú stránku
  • Viditeľnosť vo vyhľadávačoch prudko klesá

Upozornenia by sa potom mohli odosielať na vašu e-mailovú adresu, do aplikácie Slack, na interný dashboard alebo do monitorovacieho systému.

Konkurenčné informácie

Kombináciou:

  • Poradie
  • Sledovanie konkurencie
  • História umiestnení
  • Podiel na trhu

vytvára základ pre automatizovaný systém monitorovania konkurenčného SEO.

Namiesto toho, aby ste konkurentov hodnotili raz za niekoľko mesiacov, môže sa ich viditeľnosť vo vyhľadávačoch stať nepretržite monitorovanou metrikou.

Programové monitorovanie SEO

Programové SEO môže vytvoriť tisíce alebo státisíce vstupných stránok.

Ručné monitorovanie týchto projektov je nereálne.

Rozhranie API Ranktracker umožňuje vývojárom vytvárať pracovné postupy pre sledovanie pozícií, ktoré sú schopné spracovávať veľké súbory údajov o kľúčových slovách a automaticky odosielať výsledné informácie do interných analytických systémov.

Analýza SEO s využitím umelej inteligencie

REST API a MCP Server od Ranktracker sa môžu stať aj súčasťou pracovných postupov SEO poháňaných umelou inteligenciou.

Systémy umelej inteligencie by napríklad mohli pomôcť:

  • Identifikácia poklesov v rebríčku
  • Zhrnutie zmien v rebríčku
  • Nájdite kľúčové slová, ktoré sa rýchlo zlepšujú
  • Porovnanie viditeľnosti konkurencie
  • Analyzujte zmeny v SERP
  • Určite priority v oblasti SEO
  • Vytvárajte interné správy
  • Vyšetrujte nezvyčajné pohyby v rebríčku

API poskytuje štruktúrované údaje, zatiaľ čo umelá inteligencia môže pomôcť pri ich interpretácii.

Pre koho je rozhranie API Ranktracker určené?

API Ranktracker je obzvlášť užitočné pre:

  • SEO agentúry
  • Firemné SEO tímy
  • SaaS firmy
  • Spoločnosti poskytujúce SEO softvér
  • Vývojári
  • Dátoví inžinieri
  • Tímy BI
  • E-commerce firmy
  • Affiliate marketingoví špecialisti
  • Vydavatelia
  • Podniky s viacerými pobočkami
  • Tímy pre programatické SEO
  • Tímy pre automatizáciu s využitím umelej inteligencie

Ak je potrebné automaticky získavať, presúvať, analyzovať alebo spravovať údaje o pozíciách, rozhranie API je zvyčajne oveľa škálovateľnejším riešením ako ručné exporty.

Prečo používať Ranktracker namiesto budovania vlastnej infraštruktúry na sledovanie pozícií?

Zbieranie údajov o pozíciách vo veľkom meradle zahŕňa oveľa viac než len vyhľadávanie v Google.

Produkčný systém na sledovanie pozícií musí zohľadňovať:

  • Lokalizácie
  • Jazyky
  • Zariadenia
  • Zoznam 100 najlepších výsledkov
  • Funkcie SERP
  • Prehľady umelej inteligencie
  • Konfigurácia kľúčových slov
  • Historické údaje o pozíciách
  • Konkurenti
  • Plánovanie
  • Zmeny vo výsledkoch vyhľadávania
  • Ukladanie údajov
  • Vytváranie správ

Vytvorenie a údržba celej tejto infraštruktúry interne môže vyžadovať značné vývojové zdroje.

Ranktracker spravuje infraštruktúru na sledovanie pozícií a výsledné údaje sprístupňuje prostredníctvom štruktúrovaného API.

Vaši vývojári sa tak môžu sústrediť na tvorbu aplikácie, riadiaceho panela, pracovného postupu alebo analýzy, ktoré vaša firma skutočne potrebuje.

Ako začať s API Ranktracker

Začatie vyžaduje len niekoľko krokov.

1. Otvorte nastavenia API

Prejdite priamo na:

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

Vytvorte kľúč API a bezpečne ho uložte.

2. Prečítajte si rýchly sprievodca

Postupujte podľa oficiálneho rýchleho sprievodcu:

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

3. Vytvorte svoju prvú požiadavku

Napríklad:

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

4. Prezrite si referenčnú príručku k API

Kompletná dokumentácia k REST API je k dispozícii tu:

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

5. Začnite vytvárať

Odtiaľ môžete začať prepojiť Ranktracker s:

  • Vaša aplikácia
  • Vaša sada nástrojov na vytváranie správ
  • Váš dátový sklad
  • Váš CRM
  • Vaše interné nástroje
  • Vaše pracovné postupy umelej inteligencie

Dokumentácia k API Ranktracker

Kompletnú dokumentáciu pre vývojárov nájdete na:

Dokumentácia pre vývojárov: https://developers.ranktracker.com/

Vytvorenie a správa kľúčov API: https://app.ranktracker.com/account/api

Rýchly štart: https://developers.ranktracker.com/guides/quickstart/

Overovanie: https://developers.ranktracker.com/guides/authentication/

Základné pojmy: https://developers.ranktracker.com/guides/concepts/

Paginácia: https://developers.ranktracker.com/guides/pagination/

Chyby a obmedzenia frekvencie: https://developers.ranktracker.com/guides/errors-and-rate-limits/

Použitie a kvóty: https://developers.ranktracker.com/guides/usage-and-quota/

Hromadné operácie: https://developers.ranktracker.com/guides/bulk-operations/

Návod na sledovanie domény: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Návod na prepojenie rebríčkov so skladom: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Návod na Share of Voice: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Návod na hromadné označovanie: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

Referenčná príručka k REST API: https://developers.ranktracker.com/rest-api/

Server MCP: https://developers.ranktracker.com/mcp/

Pripojenie klienta MCP: https://developers.ranktracker.com/mcp/connect/

Referenčná príručka k nástroju MCP: https://developers.ranktracker.com/mcp/tools/

Začnite vytvárať s Ranktracker API

Rozhranie API Ranktracker premení Ranktracker z SEO riadiaceho panela na infraštruktúru, ktorú môžete integrovať priamo do svojho technologického prostredia.

Môžete ho použiť na správu domén a kľúčových slov, sledovanie konkurencie, získavanie rebríčkov Top 100, analýzu SERP, detekciu prehľadov umelej inteligencie, monitorovanie podielu na trhu, prístup k historickým údajom o rebríčkoch, organizovanie kľúčových slov, vytváranie reportovacích kanálov a integráciu informácií o SEO so zvyškom vášho podnikania.

Vývojárom to odstraňuje potrebu ručného exportovania a presúvania údajov o umiestneniach.

Agentúram umožňuje automatizáciu práce s klientmi vo veľkom meradle.

Pre podnikové SEO tímy umožňuje, aby sa informácie o rebríčkoch stali súčasťou internej analytiky a dátovej infraštruktúry.

Zoznámte sa s nástrojom Ranktracker

Platforma "všetko v jednom" pre efektívne SEO

Za každým úspešným podnikaním stojí silná kampaň SEO. Pri nespočetnom množstve optimalizačných nástrojov a techník, z ktorých si môžete vybrať, však môže byť ťažké zistiť, kde začať. No už sa nemusíte báť, pretože mám pre vás presne to, čo vám pomôže. Predstavujem komplexnú platformu Ranktracker na efektívne SEO

Konečne sme otvorili registráciu do nástroja Ranktracker úplne zadarmo!

Vytvorenie bezplatného konta

Alebo sa pri hláste pomocou svojich poverení

A vďaka serveru MCP od Ranktracker je možné tie isté základné SEO údaje sprístupniť aj asistentom a agentom umelej inteligencie.

Vytvorte si kľúč API Ranktracker: https://app.ranktracker.com/account/api

Prečítajte si dokumentáciu: https://developers.ranktracker.com/

Prezrite si referenčnú príručku k REST API: https://developers.ranktracker.com/rest-api/

Felix Rose-Collins

Felix Rose-Collins

Ranktracker's CEO/CMO & Co-founder

Felix Rose-Collins is the Co-founder and CEO/CMO of Ranktracker. With over 15 years of SEO experience, he has single-handedly scaled the Ranktracker site to over 500,000 monthly visits, with 390,000 of these stemming from organic searches each month.

Začnite používať Ranktracker... zadarmo!

Zistite, čo brzdí vaše webové stránky v hodnotení.

Vytvorenie bezplatného konta

Alebo sa pri hláste pomocou svojich poverení

Different views of Ranktracker app