API Ranktracker je už v prevádzke — prístup je súčasťou každého balíka

Úvod

API Ranktracker je oficiálne spustené.

Každý plán Ranktracker teraz zahŕňa prístup k API, čo zákazníkom poskytuje priamy spôsob prepojenia Ranktracker s ich vlastnými riadiacimi panelmi, platformami na vytváranie správ, internými systémami a pracovnými postupmi v oblasti SEO.

Na začatie práce už nepotrebujete samostatné predplatné API ani účet určený výhradne pre podniky. Nech už používate plán Launch, Growth, Scale alebo Authority, môžete si vytvoriť kľúč API a programovo pracovať s údajmi dostupnými vo vašom účte Ranktracker.

API je postavené na rovnakých limitoch pre kľúčové slová, riadky údajov a sledovanie, ktoré sú zahrnuté vo vašom pláne. Vyššie plány poskytujú väčšie limity, ale prístup k API je k dispozícii pre všetkých.

Prezrite si kompletnú dokumentáciu pre vývojárov na adrese developers.ranktracker.com.

Prečo sme vytvorili API Ranktracker

Tímy zaoberajúce sa SEO čoraz viac potrebujú svoje údaje o vyhľadávaní mimo jednej platformy.

Agentúry chcú mať údaje o pozíciách vo vnútri klientskych portálov. Interné tímy chcú kombinovať pozície s analytikou, potenciálnymi zákazníkmi a tržbami. Vývojári chcú automatizovať opakujúce sa úlohy v rámci riadenia projektov. Väčšie organizácie chcú ukladať SEO údaje vo vlastných dátových skladiskách a systémoch business intelligence.

Ručný export môže občas fungovať, ale stáva sa neefektívnym, keď je potrebné každý deň aktualizovať správy pre stovky domén alebo tisíce kľúčových slov.

Rozhranie API Ranktracker tento problém rieši tým, že umožňuje vašim systémom komunikovať priamo s Ranktrackerom.

Teraz môžete získavať údaje o pozíciách, spravovať sledované projekty, organizovať kľúčové slová a vytvárať pracovné postupy pre vytváranie správ bez toho, aby ste museli ručne opakovať tie isté úkony v riadiacom paneli.

Prístup k API je súčasťou každého plánu Ranktracker

Prístup k API nie je obmedzený len na náš najväčší balík.

Je zahrnutý v:

• Spustite
• Growth
• Rozšírenie
• Autorita

Vaša aktivita v rámci API prebieha v rámci limitov pre kľúčové slová, riadky údajov, konkurentov a ďalších limitov spojených s vaším predplatným.

Napríklad, ak pridáte kľúčové slová prostredníctvom API, tieto kľúčové slová sa započítavajú do rovnakých limitov účtu ako kľúčové slová pridané prostredníctvom rozhrania Ranktracker. Pred odoslaním veľkého importu si môžete programovo skontrolovať aktuálne využitie a zostávajúcu kapacitu.

To dáva každému zákazníkovi možnosť experimentovať s automatizáciou, bez ohľadu na veľkosť spoločnosti alebo technické zdroje.

Menšie firmy môžu prepojiť Ranktracker s jednoduchým interným dashboardom. Agentúry môžu automatizovať registráciu klientov a vykazovanie. Väčšie tímy môžu okolo svojho účtu Ranktracker vybudovať kompletné dátové potrubia.

Úplné údaje o rebríčku Top 100

Ranktracker je postavený na kompletnom sledovaní Top 100.

Namiesto toho, aby sa Ranktracker zastavil na prvej stránke Google, sleduje všetkých desať stránok organických výsledkov. To vám pomáha identifikovať kľúčové slová, ktoré začínajú získavať viditeľnosť ešte predtým, ako sa dostanú na prvú stránku.

Prostredníctvom API môžete získať najnovšiu históriu pozícií priradenú k sledovanému kľúčovému slovu, vrátane informácií, ako sú:

• Aktuálna organická pozícia
• Absolútna pozícia v SERP
• URL v rebríčku
• Denná zmena v rebríčku
• Týždenný pohyb v rebríčku
• Mesačný pohyb v rebríčku
• Objem vyhľadávania
• Odhadovaná návštevnosť
• Cena za kliknutie
• Konkurencia
• Náročnosť kľúčových slov

Každé sledované kľúčové slovo je možné prepojiť s nakonfigurovaným vyhľadávačom, lokalitou, jazykom a zariadením. To umožňuje tímom vytvárať oveľa podrobnejšie správy než len jednoduchý zoznam pozícií kľúčových slov.

Sledovanie vo viac ako 107 000 lokalitách

Ranktracker podporuje viac ako 107 000 sledovateľných lokalít, vrátane sledovania na počítačoch a mobilných zariadeniach a širokého jazykového pokrytia. Vďaka tomu je API vhodné pre:

• Lokálne SEO kampane
• Monitorovanie vyhľadávania na národnej úrovni
• Medzinárodné SEO
• Viacjazyčné webové stránky
• Franšízové a podniky s viacerými pobočkami
• Agentúry spravujúce klientov na rôznych trhoch

Kľúčové slovo je možné sledovať v rôznych kombináciách lokality, jazyka a zariadenia.

Napríklad agentúra môže sledovať to isté kľúčové slovo na počítačoch aj mobilných zariadeniach v Londýne, Manchestri a Birminghame. Každá kombinácia je uložená ako samostatný riadok sledovania, čo agentúre poskytuje presnejší prehľad o tom, ako sa výkonnosť vyhľadávania líši v jednotlivých trhoch.

Čo môžete robiť s API Ranktracker

API poskytuje prístup k hlavným zdrojom používaným v účte Ranktracker.

Správa domén

Môžete programovo vytvárať, načítať, aktualizovať a odstraňovať sledované domény.

Vďaka tomu je možné prepojiť Ranktracker s procesom registrácie nových zákazníkov. Keď sa klient pridá do vášho interného systému, jeho doména sa môže automaticky vytvoriť aj v Ranktrackeri.

Koncové body na úrovni domén poskytujú aj históriu pozícií a údaje o podiele na trhu za vybrané obdobie. Žiadosti o históriu a podiel na trhu môžu pokrývať obdobia až 365 dní a je možné ich filtrovať podľa stolných počítačov, mobilných zariadení alebo všetkých zariadení. Správa konkurentov

Pridávajte, vyhľadávajte, aktualizujte alebo odstraňujte konkurentov spojených s každou sledovanou doménou.

Túto funkciu môžete využiť na automatické nastavenie sledovania konkurentov pre nové projekty alebo na synchronizáciu nastavení klientov medzi Ranktrackerom a inou platformou.

Pridávanie a správa kľúčových slov

Vytvorte sledované kľúčové slová pre doménu a určte ich vyhľadávač, lokalitu, jazyk, zariadenie a frekvenciu sledovania.

API podporuje hromadné vytváranie pomocou kombinácie fráz kľúčových slov a konfigurácií vyhľadávačov. Namiesto odosielania stoviek jednotlivých požiadaviek môžete odoslať viacero slov a konfigurácií sledovania naraz. Sledovanie kľúčových slov je možné programovo pozastaviť, obnoviť alebo odstrániť.

Načítanie histórie pozícií

Načítajte najnovšie výsledky pozícií pre každé kľúčové slovo priradené k doméne.

Tieto údaje je možné odoslať do:

• Portály pre vykazovanie klientom
• Tabuľky Google
• Dátové sklady
• Dashboardy pre business intelligence
• Interné oznamovacie systémy
• Vlastné SEO aplikácie

Dokumentácia obsahuje kompletný návod na extrakciu denných pozícií a ich načítanie do skladu údajov alebo do pracovného postupu založeného na súboroch CSV. Prístup k výsledkom SERP

Každé sledované kľúčové slovo poskytuje prístup k svojim najnovším analyzovaným výsledkom vyhľadávania.

Patria sem organické výsledky a funkcie SERP, ktoré ich obklopujú. Ranktracker sleduje funkcie, ako sú odporúčané úryvky, výsledky na mape, videá, nákupné výsledky, výsledky sekcie „Ľudia sa tiež pýtajú“ a prehľady umelej inteligencie. Pre podporované sledované kľúčové slová je k dispozícii aj HTML kód SERP v cache. To znamená, že môžete analyzovať viac než len číselné umiestnenie domény.

Môžete tiež zistiť, aký typ výsledku vyhľadávania sa zobrazuje, ktorí konkurenti obklopujú váš záznam a ktoré funkcie SERP môžu ovplyvňovať mieru preklikov v organických výsledkoch.

Vytvárajte správy o podiele na hlasoch

Koncový bod „podiel na hlasoch“ vráti celkový údaj o viditeľnosti, jeho zmenu za vybrané obdobie a dennú sériu porovnávajúcu vašu doménu so sledovanými konkurentmi.

Tieto údaje sú už štruktúrované pre grafy a reporty. Môžete ich použiť na vytvorenie trendu viditeľnosti, ktorý ukáže, či vaša značka získava alebo stráca pozíciu voči konkurenčným doménam. Usporiadajte kľúčové slová pomocou značiek

Vytvorte tagy na úrovni účtu a aplikujte ich na kľúčové slová v rôznych projektoch.

Značky môžete použiť na oddelenie:

• Kľúčové slová so značkou a bez značky
• Produkty a služby
• Krajiny alebo lokality
• Kampane
• Prioritné kľúčové slová
• Skupiny pre klientské reporty
• Rôzne oblasti webovej stránky

API podporuje hromadné označovanie, čo umožňuje priradiť jednu značku k mnohým kľúčovým slovám v jednej požiadavke. Sledovanie využitia účtu

Koncový bod využitia účtu ukazuje, koľko z vášho plánu bolo spotrebované a koľko kapacity zostáva.

Uvádza limity vrátane:

• Aktívne kľúčové slová
• Riadky údajov
• Kontroly na požiadanie
• Kredity v nástroji SERP Analyser

Každý limit obsahuje aktuálne využitie, celkový limit a zostávajúcu kapacitu. To je obzvlášť užitočné pred importom rozsiahleho zoznamu kľúčových slov. Vaša integrácia môže najskôr skontrolovať dostupnú kapacitu a vyhnúť sa pokusu o import, ktorý by prekročil limit účtu.

Vytvorené pre agentúry

Agentúry patria medzi hlavné skupiny, ktoré môžu z nového API ťažiť.

Typický automatizovaný pracovný postup pri registrácii nových klientov by mohol:

1. Vytvorte doménu klienta.
2. Pridajte jeho konkurentov.
3. Importujte cieľové kľúčové slová.
4. Nastavte lokality, jazyky a zariadenia.
5. Vytvorte tagy špecifické pre klienta.
6. Odosielajte údaje o pozíciách do interného riadiaceho panela.
7. Generujte pravidelné správy o viditeľnosti.

Proces, ktorý predtým zahŕňal viacero manuálnych krokov, je teraz možné prepojiť s vlastným systémom agentúry na riadenie projektov alebo na registráciu klientov.

Agentúry môžu tiež načítať denné snímky pozícií do svojej vlastnej databázy a prezentovať tieto informácie v rámci portálu s vlastnou značkou.

Vytvorené pre interné SEO tímy

Interné tímy môžu prepojiť rebríčky s širšími obchodnými údajmi.

Napríklad výkonnosť kľúčových slov by sa mohla kombinovať s:

• Kliknutia v Google Search Console
• Konverzie na webovej stránke
• Tržby z e-commerce
• Získané potenciálne zákazky
• Výkonnosť vstupnej stránky
• Dátumy publikovania obsahu
• Technické SEO aktualizácie

Vďaka tomu je jednoduchšie prekročiť rámec izolovaných správ o rebríčkoch a pochopiť, ako viditeľnosť vo vyhľadávačoch prispieva k širším obchodným výsledkom.

Vytvorené pre SEO platformy a vývojárov

Vývojári môžu Ranktracker používať ako vrstvu údajov o pozíciách a SERP v rámci interných nástrojov alebo aplikácií určených pre zákazníkov.

API sa riadi konzistentnou štruktúrou REST, pričom všetky produkčné koncové body používajú:

https://api.ranktracker.com/v1

Odpovede používajú formát v štýle JSON:API. Zdroje sa vracajú pod dátami, pričom ich polia sú umiestnené v objekte atribútov. Zoznamové koncové body podporujú stránkovanie až do 1 000 záznamov na stránku a vracajú celkové počty prostredníctvom hlavičiek odpovede. Dokumentácia v súčasnosti poskytuje funkčné príklady pre:

• cURL
• Python
• Node.js

Obsahuje tiež kompletné návody, ktoré pokrývajú vytváranie domén, sledovanie kľúčových slov, exporty do dátového skladu, reportovanie podielu na trhu a hromadné označovanie kľúčových slov.

Ako vytvoriť kľúč API

Začatie trvá len niekoľko krokov:

1. Prihláste sa do svojho účtu Ranktracker.
2. Otvorte nastavenia účtu.
3. Prejdite do sekcie API kľúče.
4. Vytvorte nový kľúč API.
5. Kľúč bezpečne uložte na svojom serveri.

Kľúče API majú formát:

tkn_usr_...

Váš kľúč by mal byť odoslaný priamo v hlavičke Authorization. Nevyžaduje predponu Bearer. e je základná požiadavka, ktorá vypisuje domény vo vašom účte:

Úspešná požiadavka vráti domény, ktoré vlastní účet pripojený k danému kľúču.

S kľúčmi API by sa malo vždy zaobchádzať ako s heslami. Nemali by sa umiestňovať do verejných repozitárov, kódu prehliadača ani mobilných aplikácií.

Navrhnuté pre spoľahlivú automatizáciu

API používa štandardné metódy HTTP a predvídateľné štruktúry odpovedí.

Podporuje:

• GET na načítanie zdrojov
• POST na vytvorenie zdrojov
• PATCH na aktualizáciu zdrojov
• DELETE na odstránenie zdrojov

Chyby obsahujú strojovo čitateľné kódy a popisy, vďaka čomu môžu integrácie určiť, či je potrebné žiadosť opraviť, či účet dosiahol svoj limit alebo či by sa mala dočasná žiadosť zopakovať. Operácie k, stránkovanie a hlásenia o využívaní tiež pomáhajú znížiť počet zbytočných žiadostí pri správe veľkých projektov.

Stručná poznámka o MCP

Ranktracker ponúka aj možnosť MCP servera na pripojenie podporovaných nástrojov umelej inteligencie a asistentov k dátam Ranktrackeru.

O serveri MCP, podporovaných nástrojoch a postupe pripojenia sa budeme venovať v samostatnom článku.

Začnite vytvárať pomocou rozhrania API Ranktracker

Rozhranie API Ranktracker poskytuje odborníkom v oblasti SEO väčšiu kontrolu nad tým, ako zbierajú, organizujú a využívajú svoje údaje o vyhľadávaní.

Môžete automatizovať pracovné postupy sledovania pozícií, synchronizovať projekty, získavať kompletné výsledky Top 100, analyzovať funkcie SERP, porovnávať podiel na trhu a vkladať SEO údaje do systémov, ktoré vaša organizácia už používa.

A čo je najdôležitejšie, prístup k API je teraz súčasťou každého plánu Ranktracker.

Vytvorte si kľúč API vo svojom účte Ranktracker a preštudujte si dokumentáciu na adrese developers.ranktracker.com.