API Ranktracker je již v provozu — přístup je zahrnut v každém tarifu

Úvod

API Ranktracker je oficiálně v provozu.

Každý tarif Ranktracker nyní zahrnuje přístup k API, což zákazníkům umožňuje přímo propojit Ranktracker s jejich vlastními dashboardy, platformami pro reporting, interními systémy a SEO pracovními postupy.

K zahájení práce již nepotřebujete samostatné předplatné API ani účet určený pouze pro podniky. Ať už používáte tarif Launch, Growth, Scale nebo Authority, můžete si vytvořit klíč API a programově pracovat s daty dostupnými ve vašem účtu Ranktracker.

API je postaveno na stejných limitech pro klíčová slova, datové řádky a sledování, které jsou součástí vašeho tarifu. Vyšší tarify poskytují větší limity, ale přístup k API je k dispozici všem.

Prohlédněte si kompletní dokumentaci pro vývojáře na adrese developers.ranktracker.com.

Proč jsme vytvořili API Ranktracker

SEO týmy stále častěji potřebují mít svá data o vyhledávání mimo rámec jedné platformy.

Agentury chtějí mít údaje o pozicích v klientských portálech. Interní týmy chtějí kombinovat údaje o pozicích s analytikou, potenciálními zákazníky a tržbami. Vývojáři chtějí automatizovat opakující se úkoly v rámci řízení projektů. Větší organizace chtějí ukládat SEO data do svých vlastních datových skladů a systémů business intelligence.

Ruční exporty mohou občas fungovat, ale stávají se neefektivními, když je třeba každý den aktualizovat přehledy napříč stovkami domén nebo tisíci klíčových slov.

API Ranktracker tento problém řeší tím, že umožňuje vašim systémům komunikovat přímo s Ranktrackerem.

Nyní můžete načítat údaje o pozicích, spravovat sledované projekty, organizovat klíčová slova a vytvářet pracovní postupy pro vytváření reportů, aniž byste museli ručně opakovat stejné akce v ovládacím panelu.

Přístup k API je součástí každého tarifu Ranktracker

Přístup k API není omezen pouze na náš nejvyšší tarif.

Je zahrnut v:

• Spusťte
• Růst
• Rozšiřte
• Autorita

Vaše aktivita v rámci API se řídí limity pro klíčová slova, datové řádky, konkurenty a dalšími limity spojenými s vaším předplatným.

Pokud například přidáte klíčová slova prostřednictvím API, započítávají se tato klíčová slova do stejných limitů účtu jako klíčová slova přidaná prostřednictvím rozhraní Ranktracker. Před odesláním velkého importu můžete programově zkontrolovat aktuální využití a zbývající kapacitu.

To dává každému zákazníkovi možnost experimentovat s automatizací, bez ohledu na velikost společnosti nebo technické zdroje.

Menší firmy mohou propojit Ranktracker s jednoduchým interním dashboardem. Agentury mohou automatizovat onboardování klientů a reporting. Větší týmy mohou kolem svého účtu Ranktracker vybudovat kompletní datové pipeline.

Kompletní data o žebříčku Top 100

Ranktracker je postaven na kompletním sledování Top 100.

Ranktracker se neomezuje pouze na první stránku Googlu, ale sleduje všech deset stránek organických výsledků. To vám pomáhá identifikovat klíčová slova, která začínají získávat viditelnost ještě předtím, než se dostanou na první stránku.

Prostřednictvím API můžete získat nejnovější historii pozic u sledovaného klíčového slova, včetně informací, jako jsou:

• Aktuální pozice v organických výsledcích
• Absolutní pozice v SERP
• URL v žebříčku
• Denní změna pozice
• Týdenní pohyb v žebříčku
• Měsíční pohyb v žebříčku
• Objem vyhledávání
• Odhadovaná návštěvnost
• Cena za proklik
• Konkurence
• Obtížnost klíčových slov

Každé sledované klíčové slovo lze také propojit s nakonfigurovaným vyhledávačem, lokalitou, jazykem a zařízením. To umožňuje týmům vytvářet mnohem podrobnější přehledy než pouhý seznam pozic klíčových slov.

Sledování ve více než 107 000 lokalitách

Ranktracker podporuje více než 107 000 sledovatelných lokalit, včetně sledování na stolních počítačích i mobilních zařízeních a širokého jazykového pokrytí. Díky tomu je API vhodné pro:

• Lokální SEO kampaně
• Monitorování vyhledávání na národní úrovni
• Mezinárodní SEO
• Vícejazyčné webové stránky
• Franšízové a podniky s více pobočkami
• Agentury spravující klienty na různých trzích

Klíčové slovo lze sledovat v různých kombinacích lokality, jazyka a zařízení.

Agentura může například sledovat stejné klíčové slovo na stolních počítačích i mobilních zařízeních v Londýně, Manchesteru a Birminghamu. Každá kombinace je uložena jako samostatný řádek sledování, což agentuře poskytuje přesnější přehled o tom, jak se výkon ve vyhledávání liší podle trhu.

Co můžete dělat s API Ranktracker

API poskytuje přístup k hlavním zdrojům používaným v účtu Ranktracker.

Správa domén

Můžete programově vytvářet, načítat, aktualizovat a odstraňovat sledované domény.

Díky tomu je možné propojit Ranktracker s procesem onboardingu vašich zákazníků. Když je klient přidán do vašeho interního systému, může být jeho doména automaticky vytvořena i v Ranktrackeru.

Koncové body na úrovni domény také poskytují historii pozic a údaje o podílu na trhu za vybrané období. Žádosti o historii a podíl na trhu mohou pokrývat období až 365 dnů a lze je filtrovat podle stolních počítačů, mobilních zařízení nebo všech zařízení. Správa konkurentů

Přidávejte, vyhledávejte, aktualizujte nebo odstraňujte konkurenty spojené s každou sledovanou doménou.

Tuto funkci lze využít k automatické konfiguraci sledování konkurence pro nové projekty nebo k synchronizaci nastavení klientů mezi Ranktrackerem a jinou platformou.

Přidávání a správa klíčových slov

Vytvářejte sledovaná klíčová slova pro doménu a určete jejich vyhledávač, lokalitu, jazyk, zařízení a frekvenci sledování.

API podporuje hromadné vytváření pomocí kombinace klíčových frází a konfigurací vyhledávačů. Místo odesílání stovek jednotlivých požadavků můžete odeslat více slov a konfigurací sledování najednou. Klíčová slova lze také programově pozastavit, obnovit nebo odstranit.

Načtení historie pozic

Načtěte nejnovější výsledky pozic pro každé klíčové slovo přiřazené k doméně.

Tato data lze odeslat do:

• Portály pro reporting pro klienty
• Tabulky Google
• Datové sklady
• Dashboardy pro business intelligence
• Interní oznamovací systémy
• Aplikace pro SEO na míru

Dokumentace obsahuje kompletní návod na extrakci denních pozic a jejich načtení do datového skladu nebo do pracovního postupu založeného na souborech CSV. Přístup k výsledkům SERP

Každé sledované klíčové slovo poskytuje přístup k nejnovějším analyzovaným výsledkům vyhledávání.

To zahrnuje organické výsledky a funkce SERP, které je obklopují. Ranktracker sleduje funkce, jako jsou doporučené úryvky, výsledky na mapě, videa, výsledky nakupování, výsledky „Lidé se také ptají“ a přehledy AI. Pro podporovaná sledovaná klíčová slova je k dispozici také HTML SERP v mezipaměti. To znamená, že můžete analyzovat více než jen číselné hodnocení domény.

Můžete také zjistit, jaký typ výsledku vyhledávání se zobrazuje, kteří konkurenti obklopují váš záznam a které prvky SERP mohou ovlivňovat míru prokliku u organických výsledků.

Vytvářejte přehledy o podílu na hlasu

Endpoint „podíl na hlasu“ vrací celkovou hodnotu viditelnosti, její změnu za vybrané období a denní řadu porovnávající vaši doménu se sledovanými konkurenty.

Tato data jsou již strukturována pro grafy a reporty. Můžete je použít k vytvoření trendu viditelnosti, který ukáže, zda vaše značka vůči konkurenčním doménám získává nebo ztrácí pozice. Uspořádejte klíčová slova pomocí značek

Vytvářejte štítky na úrovni účtu a přiřazujte je klíčovým slovům v různých projektech.

Štítky lze použít k rozlišení:

• Klíčová slova s označením značky i bez označení značky
• Produkty a služby
• Země nebo lokality
• Kampaně
• Prioritní klíčová slova
• Skupiny reportů pro klienty
• Různé části webových stránek

API podporuje hromadné přiřazování značek, což umožňuje přiřadit jednu značku k mnoha klíčovým slovům v rámci jednoho požadavku. Sledujte využití účtu

Koncový bod využití účtu ukazuje, jak velká část vašeho tarifu již byla vyčerpána a kolik kapacity zbývá.

Zobrazuje limity, včetně:

• Aktivní klíčová slova
• Řádky dat
• Kontroly na vyžádání
• Kredity pro SERP Analyser

Každý limit zahrnuje aktuální využití, celkový limit a zbývající kapacitu. To je obzvláště užitečné před importem rozsáhlého seznamu klíčových slov. Vaše integrace může nejprve zkontrolovat dostupnou kapacitu a zabránit tak pokusu o import, který by překročil limit účtu.

Vytvořeno pro agentury

Agentury patří mezi hlavní skupiny, které mohou z nového API těžit.

Typický automatizovaný pracovní postup při zapojení nového klienta by mohl:

1. Vytvořte doménu klienta.
2. Přidejte jeho konkurenty.
3. Importujte cílová klíčová slova.
4. Nastavte lokality, jazyky a zařízení.
5. Vytvořte značky specifické pro klienta.
6. Odesílejte údaje o pozicích do interního dashboardu.
7. Vytvářejte pravidelné přehledy o viditelnosti.

Proces, který dříve zahrnoval několik ručních kroků, lze nyní propojit s vlastním systémem agentury pro správu projektů nebo onboardování klientů.

Agentury mohou také načítat denní přehledy pozic do své vlastní databáze a prezentovat tyto informace v portálu s vlastním brandingem.

Vytvořeno pro interní SEO týmy

Interní týmy mohou propojit žebříčky s širšími obchodními daty.

Například výkonnost klíčových slov lze kombinovat s:

• Kliknutí v Google Search Console
• Konverze na webu
• Tržby z e-commerce
• Získané potenciální zákazníky
• Výkonnost vstupních stránek
• Data zveřejnění obsahu
• Technické SEO aktualizace

Díky tomu je snazší překročit rámec izolovaných reportů o pozicích ve vyhledávačích a pochopit, jak viditelnost ve vyhledávačích přispívá k širším obchodním výsledkům.

Vytvořeno pro SEO platformy a vývojáře

Vývojáři mohou Ranktracker využívat jako vrstvu s údaji o pozicích a SERP v rámci interních nástrojů nebo aplikací určených pro zákazníky.

API se řídí jednotnou strukturou REST, přičemž všechny produkční koncové body používají:

https://api.ranktracker.com/v1

Odpovědi používají formát ve stylu JSON:API. Zdroje jsou vraceny pod daty, přičemž jejich pole jsou uvnitř objektu atributů. Koncové body seznamu podporují stránkování až 1 000 záznamů na stránku a vrací celkové počty prostřednictvím hlaviček odpovědí. Dokumentace v současné době poskytuje funkční příklady pro:

• cURL
• Python
• Node.js

Zahrnuje také kompletní návody pokrývající vytváření domén, sledování klíčových slov, exporty do datového skladu, reporty o podílu na trhu a hromadné označování klíčových slov.

Jak vytvořit svůj API klíč

Začátek vyžaduje jen několik kroků:

1. Přihlaste se ke svému účtu Ranktracker.
2. Otevřete nastavení účtu.
3. Přejděte do sekce API klíče.
4. Vytvořte nový klíč API.
5. Klíč bezpečně uložte na svém serveru.

API klíče mají formát:

tkn_usr_...

Váš klíč by měl být předán přímo v hlavičce Authorization. Nepotřebuje předponu Bearer. Následuje základní požadavek, který vypisuje domény ve vašem účtu:

Úspěšný požadavek vrátí domény, které vlastní účet připojený k tomuto klíči.

S API klíči je třeba zacházet vždy jako s hesly. Neměly by být umisťovány do veřejných repozitářů, kódu prohlížeče ani mobilních aplikací.

Navrženo pro spolehlivou automatizaci

API využívá standardní metody HTTP a předvídatelné struktury odpovědí.

Podporuje:

• GET pro načítání zdrojů
• POST pro vytváření zdrojů
• PATCH pro aktualizaci zdrojů
• DELETE pro odstranění zdrojů

Chyby obsahují strojově čitelné kódy a popisy, takže integrační systémy mohou určit, zda je třeba požadavek opravit, zda účet dosáhl svého limitu nebo zda by měl být dočasný požadavek zopakován. Operace k, stránkování a reporty o využití také pomáhají omezit zbytečné požadavky při správě velkých projektů.

Stručná poznámka o MCP

Ranktracker také nabízí možnost MCP serveru pro připojení podporovaných AI nástrojů a asistentů k datům Ranktrackeru.

O serveru MCP, podporovaných nástrojích a postupu připojení se budeme zabývat v samostatném článku.

Začněte pracovat s API Ranktracker

API Ranktracker poskytuje odborníkům na SEO větší kontrolu nad tím, jak shromažďují, organizují a využívají svá data z vyhledávačů.

Můžete automatizovat pracovní postupy sledování pozic, synchronizovat projekty, načítat kompletní výsledky Top 100, analyzovat prvky SERP, porovnávat podíl na hlasu a vkládat SEO data do systémů, které vaše organizace již používá.

A co je nejdůležitější, přístup k API je nyní součástí každého tarifu Ranktracker.

Vytvořte si API klíč ve svém účtu Ranktracker a prostudujte si dokumentaci na adrese developers.ranktracker.com.