• Orodja za optimizacijo spletnih strani (SEO)

API za spremljanje uvrstitve

  • Felix Rose-Collins
  • 16 min read

Uvod

Sledenje uvrstitvam postane povsem drugačen problem, ko upravljate s stotinami spletnih strani, tisočimi ključnimi besedami ali poročili o optimizaciji za iskalnike (SEO), ki se morajo samodejno posodabljati.

Prijava v nadzorno ploščo in ročni izvoz podatkov sta morda primerna za manjše projekte. Pri večjih projektih pa to hitro postane ozko grlo.

Zato smo razvili API Ranktracker.

Ranktracker API je zdaj na voljo in razvijalcem, SEO-ekipam, agencijam, podjetjem SaaS ter ekipam za obdelavo podatkov omogoča programski dostop do njihovih podatkov v Ranktrackerju.

API lahko uporabite za:

  • Pridobite uvrstitve 100 najboljših ključnih besed
  • Dostop do podatkov SERP
  • Zaznajte AI preglede in druge funkcije SERP
  • Ustvarjanje in upravljanje spremljanih domen
  • Dodajanje in upravljanje ključnih besed
  • Sledenje konkurentom
  • Dostop do zgodovine uvrstitve
  • Izračunajte delež glasu
  • Razvrščanje ključnih besed z oznakami
  • Spremljajte uporabo računa in kvoto
  • Vzpostavite avtomatizirane poti poročanja o SEO
  • Povezovanje podatkov o uvrstitvah z notranjimi aplikacijami in nadzornimi ploščami

Namesto ročnega prenašanja podatkov o optimizaciji za iskalnike med platformami, Ranktracker API omogoča vaši lastni programski opremi, da neposredno sodeluje z infrastrukturo za uvrščanje, na kateri temelji Ranktracker.

Ustvarite ali upravljajte svoj API-ključ: https://app.ranktracker.com/account/api

Spoznajte Ranktracker

Platforma "vse v enem" za učinkovito SEO

Za vsakim uspešnim podjetjem stoji močna kampanja SEO. Vendar je ob neštetih orodjih in tehnikah optimizacije težko vedeti, kje začeti. Ne bojte se več, ker imam za vas prav to, kar vam lahko pomaga. Predstavljam platformo Ranktracker vse-v-enem za učinkovito SEO

Končno smo odprli registracijo za Ranktracker popolnoma brezplačno!

Ustvarite brezplačen račun

Ali se prijavite s svojimi poverilnicami

Preberite dokumentacijo o API-ju: https://developers.ranktracker.com/

Kaj je API Ranktracker?

API API Ranktracker je REST API, ki omogoča programski dostop do vašega računa Ranktracker.

Namesto da bi vsakič, ko potrebujete podatke o uvrstitvi, odpirali Ranktracker, lahko vaša aplikacija te podatke zahteva samodejno.

API je zasnovan na istih osnovnih virih, ki se uporabljajo v celotnem Ranktrackerju:

  • Računi
  • Domene
  • Ključne besede
  • Konkurenti
  • Zgodovina uvrstitve
  • Podatki SERP
  • Delež glasu
  • Oznake
  • Uporaba in kvota

To razvijalcem omogoča tako pridobivanje podatkov iz Ranktrackerja kot tudi upravljanje tega, kar Ranktracker spremlja.

Na primer, agencija za optimizacijo spletnih strani (SEO) bi lahko samodejno ustvarila projekt v Ranktrackerju, ko se v njen sistem CRM vpiše nova stranka, dodala ključne besede in konkurente te stranke ter nato njihove uvrstitve prenesla v notranjo nadzorno ploščo za poročanje.

Platforma SaaS bi lahko uporabila isti API za prikaz podatkov o uvrstitvah neposredno znotraj lastnega izdelka.

Ekipa za podatke bi lahko dnevne uvrstitve samodejno pošiljala v BigQuery, Snowflake, PostgreSQL, Google Sheets ali drugo skladišče podatkov za nadaljnjo analizo.

Spoznajte Ranktracker

Platforma "vse v enem" za učinkovito SEO

Za vsakim uspešnim podjetjem stoji močna kampanja SEO. Vendar je ob neštetih orodjih in tehnikah optimizacije težko vedeti, kje začeti. Ne bojte se več, ker imam za vas prav to, kar vam lahko pomaga. Predstavljam platformo Ranktracker vse-v-enem za učinkovito SEO

Končno smo odprli registracijo za Ranktracker popolnoma brezplačno!

Ustvarite brezplačen račun

Ali se prijavite s svojimi poverilnicami

Za pregled, kako se viri med seboj povezujejo, si oglejte vodnik Osnovni koncepti API-ja Ranktracker.

Prvih 100 uvrstitev po privzetku

Ena od največjih prednosti Ranktracker API je globina podatkov o uvrstitvah.

Vsaka preveritev ključnih besed privzeto vključuje prvih 100 rezultatov v Googlu.

To pomeni, da lahko analizirate vseh 10 strani rezultatov iskanja, namesto da bi videli le tisto, kar se trenutno uvršča na prvi strani.

To je pomembno, ker se napredek pri optimizaciji za iskalnike (SEO) običajno začne že dolgo preden ključna beseda doseže Top 10.

Ključna beseda se lahko premakne:

91. mesto → 63. mesto → 37. mesto → 18. mesto → 9. mesto

To predstavlja znaten napredek pri optimizaciji za iskalnike (SEO).

Če se vaši podatki o uvrstitvi končajo pri prvih 10 rezultatih, je skoraj celotna pot nevidna.

Sledenje prvih 100 rezultatov vam omogoča spremljanje:

  • Nove uvrstitve, ki so se uvrstile med prvih 100 v Googlu
  • Ključne besede, ki se pomikajo proti prvi strani
  • Veliki napredki in padci v uvrstitvah
  • Gibanje konkurentov
  • Vidnost pri iskanju z dolgim repom
  • Uspešnost novih vsebin
  • Programske kampanje SEO
  • Obsežni portfelji ključnih besed

Zato je API uporaben tako za poročanje o SEO na visoki ravni kot za podrobno analizo uvrstitve.

Več o API-ju:

https://developers.ranktracker.com/

Sledenje uvrstitvam na več kot 107.000 lokacijah

Rezultati iskanja se znatno razlikujejo glede na to, kje se iskanje izvede.

Ranktracker podpira več kot 107.000 lokacij, kar ekipam omogoča spremljanje lokalne, nacionalne in mednarodne vidnosti v iskanju prek API-ja.

Sledenje ključnim besedam je mogoče konfigurirati glede na različne dejavnike, med drugim:

  • Iskalnik
  • Lokacija
  • Jezik
  • Naprava

Na primer, isto ključno besedo je mogoče spremljati ločeno za:

  • Združene države Amerike — namizni računalnik
  • Združene države Amerike — mobilna naprava
  • Velika Britanija — namizni računalnik
  • Nemčija — mobilna naprava
  • Poljska — namizni računalnik

Vsako konfiguracijo je mogoče obravnavati kot ločeno spremljano ključno besedo.

To je še posebej koristno za:

  • Mednarodno optimiziranje za iskalnike
  • Podjetja z več lokacijami
  • Lokalne agencije za optimizacijo za iskalnike
  • Podjetja za e-trgovanje
  • Založniki, ki delujejo na različnih trgih
  • Podjetja SaaS, usmerjena v več držav
  • Podjetniške ekipe za optimizacijo spletnih strani

Namesto da ključno besedo obravnavate kot besedo z eno univerzalno uvrstitvijo, lahko analizirate, kako se vidnost spreminja na različnih trgih in napravah.

Sledenje uvrstitvam na namiznih računalnikih in mobilnih napravah

Rezultati iskanja na namiznih računalnikih in mobilnih napravah se lahko razlikujejo.

Ranktracker zato omogoča segmentacijo sledenja ključnih besed po napravah.

To pomeni, da lahko integracija ločeno analizira:

  • Uvrstitve na namiznih računalnikih
  • Uvrstitve na mobilnih napravah

Na primer, stran se lahko visoko uvršča na namiznih računalnikih, vendar se na mobilnih napravah obnaša drugače zaradi razlik v postavitvi strani z rezultati iskanja (SERP), lokalnih rezultatov ali drugih funkcij iskanja.

Ločevanje teh podatkovnih naborov omogoča SEO-ekipam veliko jasnejšo sliko o tem, kako uporabniki dejansko naletijo na njihove spletne strani v iskanju.

API omogoča segmentacijo po napravah tudi pri delu s funkcijami, kot je Share of Voice.

Pregled funkcij SERP in zaznavanje umetne inteligence

Sodobni rezultati Googla vsebujejo veliko več kot tradicionalni organski seznami.

Rezultati iskanja (SERP) lahko vključujejo:

  • Pregledi AI
  • Izpostavljeni odlomki
  • Zemljevidi
  • Lokalni rezultati
  • Videoposnetki
  • Rezultati nakupovanja
  • Ljudje prav tako sprašujejo
  • Druge funkcije iskanja

API Ranktracker poleg podatkov o ključnih besedah vključuje tudi informacije o funkcionalnostih SERP in zaznavanje AI Overview.

To pomeni, da vaša integracija lahko analizira ne le uvrstitev spletne strani, ampak tudi vse, kar obdaja to uvrstitev v Googlu.

Na primer, lahko ugotovite:

  • Ključne besede, ki sprožijo AI Pregled
  • Rezultati iskanja, ki vsebujejo izbrane odlomke
  • Iskalna poizvedovanja, v katerih prevladujejo video rezultati
  • Ključne besede, ki prinašajo lokalne rezultate ali rezultate na zemljevidu
  • Spremembe v sestavi SERP-ov skozi čas

To je vse pomembnejše, saj sama organska pozicija ne pove vedno celotne zgodbe.

Stran, ki se uvršča na tretje mesto na tradicionalnem SERP-u, in stran, ki se uvršča na tretje mesto pod AI Overview, map pack, videoposnetki in People Also Ask, lahko dosežeta zelo različne ravni vidnosti.

API omogoča, da te razlike postanejo del vaše SEO analize.

Oglejte si celotno dokumentacijo API-ja:

https://developers.ranktracker.com/

Dostop do popolnih podatkov SERP

Ranktracker lahko ponudi veliko več kot le eno številčno uvrstitev.

Za spremljane ključne besede lahko API prikaže najnovejše rezultate iskanja skupaj s povezanimi informacijami SERP.

Struktura virov API vključuje:

  • Najnovejši podatki o SERP
  • Informacije o uvrstitvi
  • Značilnosti SERP
  • Shranjeni HTML SERP

To pomeni, da lahko razvijalci oblikujejo delovne tokove na podlagi dejanskih rezultatov iskanja, namesto da bi zgolj shranjevali podatke, kot so:

Položaj: 12

Za napredne SEO-ekipe to pomeni veliko večjo prožnost.

Podatke SERP lahko uporabite za:

  • Analiza konkurenčnih URL-jev
  • Preiskovanje nepričakovanih sprememb uvrstitve
  • Prepoznavanje sprememb v postavitvi rezultatov
  • Izdelava notranjih orodij za analizo SERP
  • Shranjevanje zgodovinskih podatkov o SERP
  • Vnašajte podatke o rezultatih iskanja v druge modele ali analitične sisteme

Celoten seznam končnih točk najdete tukaj:

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

Upravljanje domen prek API-ja

Domene so eden od ključnih virov API-ja Ranktracker.

REST API vam omogoča:

  • Ustvarjanje domen
  • Pridobivanje domen
  • Posodabljanje domen
  • Izbris domen

Domena predstavlja spletno mesto, ki se spremlja znotraj Ranktrackerja.

Vsaka domena lahko vsebuje:

  • Ključne besede
  • Konkurenti
  • Zgodovina uvrstitve
  • Podatki o deležu glasu

To omogoča avtomatizirano vključevanje.

Na primer, agencija bi lahko ustvarila naslednji potek dela:

Nova stranka se prijavi
        ↓
Ustvari domeno v Ranktrackerju
        ↓
Dodaj ključne besede stranke
        ↓
Dodaj konkurente
        ↓
Začni spremljanje uvrstitve
        ↓
Pošlji podatke na nadzorno ploščo za poročanje

Članom ekipe ni treba ročno konfigurirati vsakega novega projekta.

Celoten vodnik je na voljo v vodniku Dodaj domeno in sledi ključnim besedam.

Programsko dodajanje in upravljanje ključnih besed

Ko domena obstaja, je mogoče ključne besede upravljati prek API-ja.

API lahko uporabite za dodajanje ključnih besed, ki jih želite spremljati, ter hkrati določite konfiguracijo iskanja, povezano z njimi.

Podatki o ključnih besedah, ki se spremljajo, lahko vključujejo dejavnike, kot so:

  • Beseda
  • Iskalnik
  • Lokacija
  • Jezik
  • Naprava
  • Rezultati razvrstitve

Upravljate lahko tudi življenjski cikel sledenja obstoječih ključnih besed.

To vključuje možnost:

  • Pridobivanje ključnih besed
  • Preberite informacije o uvrstitvi
  • Zaustavite sledenje
  • Nadaljuj sledenje
  • Ustavite sledenje
  • Dostop do podatkov SERP
  • Dodelite oznake

To vaši lastni aplikaciji omogoča, da nadzira, katere ključne besede spremlja Ranktracker.

Množično spremljanje ključnih besed

Veliki SEO računi ne bi smeli biti prisiljeni pošiljati enega API zahtevka za vsako ključno besedo.

Ranktracker podpira operacije s ključnimi besedami v večjem obsegu.

Končna točka za ustvarjanje ključnih besed sprejema konfiguracijo »besede × iskalniki«, kar omogoča ustvarjanje številnih kombinacij spremljanih ključnih besed v enem samem zahtevku.

Predstavljajte si na primer, da želite spremljati:

  • 100 ključnih besed
  • Namizni računalnik v ZDA
  • Mobilni v ZDA

Te konfiguracije lahko ustvarijo 200 kombinacij ključnih besed za spremljanje, ne da bi bilo potrebnih 200 posameznih zahtevkov za nastavitev.

Množične operacije so še posebej koristne za:

  • Agencije
  • SEO za podjetja
  • Velike spletne trgovine
  • Programatično SEO
  • SaaS platforme za SEO
  • Veliki izdajatelji vsebin

Ranktracker podpira tudi množično označevanje ključnih besed.

Preberite celoten vodnik po operacijah v večjem obsegu:

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

Sledenje SEO konkurentom

Uvrstitve postanejo veliko bolj uporabne, če vključujejo konkurenčni kontekst.

API Ranktracker omogoča upravljanje konkurentov v primerjavi s spremljanimi domenami.

To omogoča samodejno analizo vaše učinkovitosti v iskanju v primerjavi s konkurenčnimi spletnimi stranmi.

Podatke o konkurentih lahko uporabite za spremljanje:

  • Kateri konkurenti pridobivajo vidnost
  • Katera spletna mesta prehitevajo vašo domeno
  • Spremembe v skupnih skupinah ključnih besed
  • Trendi uvrstitve konkurentov
  • Relativna vidnost v iskanju
  • Spremembe v deležu glasu

Za agencije lahko to postane del avtomatiziranega sistema poročanja strankam.

Namesto da bi vsak mesec ročno primerjali stranko s konkurenti, se lahko ustrezni podatki neposredno vključijo v proces poročanja.

Dostop do zgodovinskih podatkov o uvrstitvah

Trenutne uvrstitve prikazujejo le, kaj se dogaja zdaj.

Zgodovinski podatki o uvrstitvah kažejo, v katero smer se giblje učinkovitost optimizacije za iskalnike (SEO).

Ranktracker prek API-ja zagotavlja zgodovino uvrstitve domen, kar razvijalcem omogoča analizo vidnosti skozi čas.

Zgodovinski podatki lahko pomagajo pri ugotavljanju:

  • Izboljšave uvrstitve
  • Izgube uvrstitve
  • Trendi vidnosti
  • Gibanje ključnih besed
  • Spremembe po izvedbi SEO kampanj
  • Vpliv posodobitve Googla
  • Dolgoročna uspešnost kampanj

Zgodovino uvrstitve lahko uporabite tudi za ustvarjanje prilagojenih grafikonov in nadzornih plošč.

Na primer:

API Ranktracker
       ↓
Dnevno pridobivanje uvrstitev
       ↓
Podatkovno skladišče
       ↓
Zgodovinski nabor podatkov o SEO
       ↓
Nadzorna plošča / Opozorila / Analiza

Ranktracker ponuja poseben vodič, ki prikazuje, kako dnevne uvrstitve prenesti v podatkovno skladišče:

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

Pošiljanje podatkov Ranktrackerja v podatkovno skladišče

Eden od najbolj uporabnih API-delovnih tokov je samodejno shranjevanje podatkov Ranktrackerja v lastno bazo podatkov ali skladišče.

Podatke o uvrstitvah lahko na primer pošljete v:

  • BigQuery
  • Snowflake
  • PostgreSQL
  • MySQL
  • Google Sheets
  • Notranje analitične baze podatkov

Te informacije se nato lahko združijo z drugimi poslovnimi podatki.

Na primer:

Ranktracker
     ↓
Ranktracker API
     ↓
Podatkovno skladišče
     ↓
Google Search Console
Analytics
Konverzije
Prihodki
Podatki CRM
     ↓
Nadzorna plošča poslovne inteligence

Tako se ustvari veliko bolj celovita slika uspešnosti SEO.

Namesto da bi zgolj vedeli, da se je ključna beseda premaknila z 8. na 3. mesto, bi lahko analizirali, ali je ta sprememba povzročila tudi:

  • Več organskih klikov
  • Več potencialnih strank
  • Višje stopnje konverzije
  • Večji prihodki

Vodnik Vodnik »Od uvrstitev do skladišča podatkov« ponuja primer vzpostavitve takšnega procesa.

Priprava poročil o deležu glasu

API Ranktracker omogoča tudi dostop do podatkov o deležu glasu.

Delež glasu omogoča širše merjenje vidnosti domene v sklopu spremljanih ključnih besed.

Namesto da bi se vprašali:

Kje se uvrščamo za to ključno besedo?

lahko vprašate:

Kako vidni smo na celotnem trgu iskanja?

To postane še posebej močno orodje, ko so vključeni podatki o konkurentih.

API Share of Voice se lahko uporabi za analizo:

  • Vaša splošna vidnost
  • Vidnost konkurentov
  • Spremembe vidnosti skozi čas
  • Relativni položaj na trgu
  • Vidnost na namiznih računalnikih
  • Vidnost na mobilnih napravah

Končna točka podpira časovna obdobja in segmentacijo po napravah, kar omogoča vključitev Share of Voice v prilagojena poročila o optimizaciji za iskalnike (SEO).

Celoten primer implementacije je na voljo tukaj:

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

Razvrščanje ključnih besed z oznakami

Velika portfelja ključnih besed je brez organizacije težko upravljati.

Ranktracker ponuja oznake na ravni računa, ki jih je mogoče dodati spremljanim ključnim besedam.

Oznake lahko ustvarite za:

  • Kategorije izdelkov
  • Namen iskanja
  • Lokacije
  • Vrste vsebin
  • Kampanje
  • Stranke
  • Stopnje nakupnega lijaka
  • Poslovne enote
  • Ekipe za optimizacijo za iskalnike (SEO)

Na primer:

»kupi tekaške čevlje« → Komercialno
»najboljši tekaški čevlji« → Primerjava
»kako očistiti tekaške čevlje« → Informativno

Iste oznake je mogoče ponovno uporabiti v različnih domenah in skupinah ključnih besed.

Ranktracker omogoča tudi množično označevanje, tako da je mogoče organizirati velike skupine ključnih besed brez potrebe po posameznih zahtevkih.

Poseben vodič je na voljo tukaj:

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

Spremljanje uporabe računa in kvote

Avtomatizirani sistemi morajo razumeti tudi vire računa, ki so jim na voljo.

API Ranktrackerja omogoča:

GET /v1/account/usage

Ta končna točka poroča o uporabi računa in omejitvah.

Podatki o trenutni uporabi lahko vključujejo:

  • Stanje dostopa do API-ja
  • Ključne besede
  • Vrstice podatkov
  • Uporaba na zahtevo
  • Uporaba SERP Analyserja

Vsaka kvota lahko zagotavlja vrednosti, kot so:

  • Uporaba
  • Omejitev
  • Preostalo

To omogoča aplikaciji, da pred začetkom obsežne operacije preveri razpoložljivo zmogljivost.

Na primer, pred uvozom tisočih ključnih besed lahko vaš sistem preveri uporabo računa in ugotovi, koliko zmogljivosti je še na voljo.

Preberite celoten vodnik:

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

Kako deluje avtentifikacija API-ja Ranktracker

Zahtevki za REST API Ranktrackerja se avtentificirajo z API ključem.

Ključe lahko ustvarjate in upravljate neposredno v Ranktrackerju:

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

Svoj API ključ morate vedno obravnavati kot geslo.

Osnovni URL API-ja v produkcijskem okolju je:

https://api.ranktracker.com

Viri API se nahajajo pod potjo /v1.

Na primer:

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

API ključ se pošlje neposredno v glavi Authorization.

Za standardne zahteve REST API ni predpone »Bearer «.

Primer:

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

API ključ Ranktrackerja je treba hraniti na strežniški strani in ga nikoli ne smete razkriti prek:

  • JavaScript v brskalniku
  • Izvorna koda front-enda
  • Javna skladišča
  • Koda mobilne aplikacije
  • Javne konfiguracijske datoteke

Za več informacij preberite:

Hitri začetek: https://developers.ranktracker.com/guides/quickstart/

Preverjanje pristnosti: https://developers.ranktracker.com/guides/authentication/

Ustvarjanje/upravljanje API ključev: https://app.ranktracker.com/account/api

Struktura virov API

Ranktracker uporablja UUID-je za identifikacijo virov.

To vključuje vire, kot so:

  • Domene
  • Ključne besede
  • Konkurenti
  • Oznake

Poenostavljen prikaz je naslednji:

Račun
│
├── Uporaba
├── Oznake
│
└── Domene
    │
    ├── Zgodovina uvrstitve
    ├── Delež glasu
    ├── Konkurenti
    │
    └── Ključne besede
        │
        ├── SERP
        ├── Shranjeni HTML SERP
        └── Oznake

To omogoča predvidljivo strukturo API-ja.

Domena ima ključne besede in konkurente.

Ključna beseda pripada spremljani domeni in ima povezane informacije o SERP in uvrstitvi.

Oznake obstajajo na ravni računa in jih je mogoče dodati ključnim besedam.

Več informacij:

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

Odgovori JSON API

Odgovori Ranktrackerja uporabljajo enoten format JSON:API.

Viri so vrnjeni pod »data«, medtem ko so njihova polja shranjena pod »attributes«.

Na primer:

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

Razvijalci morajo upoštevati tudi pomembno konvencijo poimenovanja:

  • Odgovori API uporabljajo camelCase
  • Vsebina zahtevkov za pisanje uporablja snake_case

Odgovor lahko na primer vsebuje:

projectName

medtem ko zahteva za pisanje uporablja:

project_name

Ta konvencija velja za celoten API.

Glej:

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

Stranjenje

Končne točke seznama so razvrščene po straneh, tako da lahko aplikacije učinkovito delujejo z velikimi računi Ranktracker.

Stranjenje se nanaša na vire, vključno z:

  • Domene
  • Ključne besede
  • Konkurenti
  • Oznake

Dva glavna parametra sta:

  • stran
  • na_stran

per_page podpira do 1.000 zapisov na stran.

Podatki o razdelitvi na strani se vrnejo prek odzivnih glav, vključno z:

  • X-Skupno število
  • X-Skupno število strani
  • X-na-stran
  • X-Trenutna-stran

Pri velikih izvozih lahko aplikacije zato nadaljujejo z zahtevanjem strani, dokler ni pridobljen celoten nabor podatkov.

Preberite vodnik po razvrščanju po straneh:

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

Obravnavanje napak in omejitve hitrosti

API Ranktracker uporablja standardne HTTP-statusne kode, da je napake lažje obravnavati programsko.

Pogosti odgovori vključujejo:

StanjePomenPrimer
400Neveljavna zahtevaManjka obvezen parameter ali je nepravilno oblikovan
402Presežena kvotaZahtevana operacija bi presegla dovoljeno kvoto za račun
403PrepovedanoZahteva ni pooblaščena ali dostop do API ni na voljo
404Ni bilo najdenoViri v računu ne obstajajo
422Napaka pri preverjanjuZahteva je v veljavnem formatu JSON, vendar vsebuje neveljavne podatke
429Preveč zahtevkovIntegracija je omejena glede na število zahtevkov

Ko se pojavi odgovor 429, morajo integracije upoštevati vrnjene informacije Retry-After, preden poskusijo ponovno.

To omogoča produkcijskim aplikacijam, da se spopadejo z začasnim omejevanjem brez preprostega neuspeha.

Celotna dokumentacija o napakah in omejitvah hitrosti je na voljo tukaj:

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

Ranktracker REST API v primerjavi z MCP

REST API ni edini način za povezavo zunanje programske opreme z Ranktrackerjem.

Ranktracker ponuja tudi gostovani MCP-strežnik.

MCP pomeni Model Context Protocol in omogoča združljivim aplikacijam in agentom AI, da delujejo neposredno s podatki Ranktrackerja.

To vključuje združljive odjemalce, kot so:

  • ChatGPT
  • Claude
  • Cursor
  • Druge aplikacije umetne inteligence, združljive z MCP

REST in MCP črpata iz istih osnovnih podatkov Ranktrackerja, vendar sta zasnovana za različne delovne tokove.

REST API RanktrackerRanktracker MCP
Najbolj primerno zaAplikacije, nadzorne plošče, skladišča podatkov in načrtovane nalogeAI pomočniki in agenti
KlicateljVaš backend ali HTTP-odjemalecChatGPT, Claude, Cursor ali drug MCP-odjemalec
VmesnikREST končne točkeOrodja MCP
REST pot/v1/.../mcp
Tipična uporabaSamodejno premikanje in upravljanje podatkov SEORaziskovanje podatkov SEO v obliki pogovora

Na primer, REST je boljša izbira, če želite:

  • Izvoz lestvic vsako noč
  • Posodabljanje nadzorne plošče BI
  • Samodejno ustvarjanje projektov SEO
  • Dodajanje ključnih besed iz vaše aplikacije
  • Sinhronizacija podatkov o uvrstitvah z bazo podatkov

MCP je primernejši za vprašanja, kot so:

Katera od mojih spremljanih ključnih besed je ta teden najbolj padla?

ali:

Kateri konkurenti so pridobili največjo prepoznavnost?

AI-odjemalec lahko izbere ustrezno orodje Ranktracker in poizveduje ustrezne podatke.

Mnoge napredne ekipe za optimizacijo spletnih strani (SEO) lahko uporabljajo obe rešitvi.

REST skrbi za infrastrukturo in avtomatizacijo. MCP omogoča AI-agentom dostop do podatkov Ranktrackerja.

Več informacij:

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

Povezava MCP-odjemalca: https://developers.ranktracker.com/mcp/connect/

Referenca orodja MCP: https://developers.ranktracker.com/mcp/tools/

Kaj lahko ustvarite z API-jem Ranktracker?

API Ranktrackerja se lahko uporablja za veliko več kot le prikazovanje pozicije ključnih besed.

Tukaj je nekaj najbolj uporabnih aplikacij.

Avtomatizirano poročanje o SEO

Agencija lahko podatke o uvrstitvah samodejno prenese v svojo platformo za poročanje.

Namesto:

Odpreti Ranktracker
↓
Izvoziti CSV
↓
Urediti preglednico
↓
Naložiti poročilo
↓
Poslati stranki

lahko vzpostavite:

API Ranktracker
↓
Platforma za poročanje
↓
Samodejno posodobljeno poročilo za stranko

To je še posebej koristno za agencije, ki upravljajo z velikim številom strank.

Prilagojene SEO nadzorne plošče

Vaše podjetje morda že uporablja notranjo platformo za poročanje ali poslovno inteligenco.

API omogoča, da podatki Ranktrackerja postanejo še en vir podatkov znotraj tega okolja.

Lahko ustvarite nadzorne plošče, ki prikazujejo:

  • Uvrstitve ključnih besed
  • Spremembe uvrstitve
  • Top 3 ključne besede
  • 10 najboljših ključnih besed
  • 100 najbolj iskanih ključnih besed
  • Delež glasu
  • Vidnost konkurentov
  • Funkcije SERP
  • Pojavnosti v pregledu AI

Nastali nadzorni panel je mogoče prilagoditi posebej potrebam poročanja vašega podjetja.

Avtomatizirano vključevanje strank

Agencije za optimizacijo spletnih strani (SEO) lahko Ranktracker povežejo s svojim procesom vključevanja strank.

Na primer:

Stranka kupi SEO paket
↓
CRM ustvari stranko
↓
API Ranktracker ustvari domeno
↓
Dodajo se ključne besede
↓
Dodajo se konkurenti
↓
Začne se sledenje

S tem se odpravijo ponavljajoče se ročne nastavitve projektov.

Skladišča podatkov SEO

Uvrstitve postanejo bolj dragocene, ko so povezane z drugimi tržnimi in poslovnimi podatki.

Podatke Ranktrackerja je mogoče kombinirati z:

  • Google Search Console
  • Analitika
  • Podatki CRM
  • Podatki o konverzijah
  • Prihodki iz e-trgovine
  • Podatki o potencialnih strankah
  • Učinkovitost vsebin

To lahko pomaga odgovoriti na veliko pomembnejša vprašanja kot zgolj preverjanje uvrstitve.

Na primer:

Katera izboljšanja uvrstitve so ustvarila največ prihodkov?

ali:

Kateri sklopi ključnih besed povečujejo vidnost, vendar ne ustvarjajo konverzij?

Opozorila o uvrstitvah

Zgodovinski podatki o uvrstitvah lahko poganjajo tudi prilagojene sisteme opozarjanja.

Integracija bi lahko samodejno zaznala, kdaj:

  • Ključna beseda izpade iz prve trojice
  • Stran se uvrsti med prvih 10
  • Ključna beseda se uvrsti med prvih 100
  • Pomembna ključna beseda izgine iz prve stotice
  • Konkurent prehiti vašo spletno stran
  • Vidnost v iskalnikih se močno zmanjša

Opozorila se nato lahko pošljejo na vaš e-poštni naslov, v Slack, na notranjo nadzorno ploščo ali v sistem za spremljanje.

Konkurenčna obveščanja

Kombinacija:

  • Uvrstitve
  • Sledenje konkurentom
  • Zgodovina uvrstitev
  • Delež glasu

ustvarja temelj za avtomatiziran sistem spremljanja konkurenčnega SEO.

Namesto da bi konkurente ocenjevali enkrat na nekaj mesecev, lahko njihova vidnost v iskalnikih postane kazalnik, ki se nenehno spremlja.

Programsko spremljanje SEO

Programsko optimiziranje za iskalnike (SEO) lahko ustvari tisoče ali sto tisoče ciljnih strani.

Ročno spremljanje teh projektov je nerealno.

API Ranktracker omogoča razvijalcem, da ustvarijo delovne tokove za uvrščanje, ki so sposobni obdelovati velike nize podatkov ključnih besed in samodejno posredovati pridobljene informacije v interne analitične sisteme.

Analiza SEO na podlagi umetne inteligence

REST API in MCP strežnik Ranktrackerja lahko postaneta tudi del delovnih tokov SEO, ki jih poganja umetna inteligenca.

Na primer, sistemi umetne inteligence bi lahko pomagali:

  • Prepoznajte padce uvrstitve
  • Povzetek sprememb uvrstitve
  • Iskanje ključnih besed, ki se hitro izboljšujejo
  • Primerjava vidnosti konkurentov
  • Analizirajte spremembe v SERP
  • Določite prednostne naloge za SEO
  • Ustvarjanje notranjih poročil
  • Preučite nenavadna gibanja v uvrstitvah

API zagotavlja strukturirane podatke, umetna inteligenca pa lahko pomaga pri njihovi interpretaciji.

Za koga je namenjen API Ranktracker?

API Ranktracker je še posebej uporaben za:

  • Agencije za SEO
  • Podjetniške ekipe za SEO
  • Podjetja SaaS
  • Podjetja za SEO programsko opremo
  • Razvijalci
  • Inženirji za obdelavo podatkov
  • Ekipe za poslovno inteligenco
  • Podjetja za e-trgovino
  • Affiliate tržniki
  • Založniki
  • Podjetja z več lokacijami
  • Ekipe za programsko optimizacijo za iskalnike (SEO)
  • Ekipe za avtomatizacijo z umetno inteligenco

Če je treba podatke o uvrstitvah samodejno pridobiti, prenesti, analizirati ali upravljati, je API običajno veliko bolj prilagodljiva rešitev kot ročni izvozi.

Zakaj uporabljati Ranktracker namesto da si sami zgradite lastno infrastrukturo za sledenje uvrstitvam?

Zbiranje uvrstitev v iskalnikih v velikem obsegu vključuje veliko več kot le iskanje v Googlu.

Proizvodni sistem za sledenje uvrstitvam mora upoštevati:

  • Lokacije
  • Jeziki
  • Naprave
  • Zbirka 100 najboljših rezultatov
  • Funkcije SERP
  • Pregledi AI
  • Konfiguracija ključnih besed
  • Zgodovinski podatki o uvrstitvah
  • Konkurenti
  • Načrtovanje
  • Spremembe v rezultatih iskanja
  • Shranjevanje podatkov
  • Poročanje

Vzpostavitev in vzdrževanje vse te infrastrukture znotraj podjetja lahko zahteva znatne razvojne vire.

Ranktracker skrbi za infrastrukturo za sledenje uvrstitvam in pridobljene podatke posreduje prek strukturiranega API-ja.

Vaši razvijalci se tako lahko osredotočijo na razvoj aplikacije, nadzorne plošče, delovnega toka ali analize, ki jih vaše podjetje dejansko potrebuje.

Kako začeti z API-jem Ranktracker

Za začetek je potrebnih le nekaj korakov.

1. Odprite nastavitve API-ja

Pojdite neposredno na:

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

Ustvarite API ključ in ga varno shranite.

2. Preberite vodnik za hiter začetek

Sledite uradnemu vodniku za hiter začetek:

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

3. Pošljite svojo prvo zahtevo

Na primer:

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

4. Preučite referenco API-ja

Celoten priročnik za REST API je na voljo tukaj:

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

5. Začnite z izdelavo

Od tam lahko začnete povezovati Ranktracker z:

  • Vaša aplikacija
  • Vaš nabor orodij za poročanje
  • Vaše skladišče podatkov
  • Vaš CRM
  • Vaša interna orodja
  • Vaši delovni tokovi umetne inteligence

Dokumentacija API-ja Ranktracker

Celotna dokumentacija za razvijalce je na voljo na:

Dokumentacija za razvijalce: https://developers.ranktracker.com/

Ustvarjanje in upravljanje API ključev: https://app.ranktracker.com/account/api

Hitri začetek: https://developers.ranktracker.com/guides/quickstart/

Preverjanje pristnosti: https://developers.ranktracker.com/guides/authentication/

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

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

Napake in omejitve hitrosti: https://developers.ranktracker.com/guides/errors-and-rate-limits/

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

Množične operacije: https://developers.ranktracker.com/guides/bulk-operations/

Vodnik za sledenje domeni: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Vodnik za prenos lestvic v skladišče: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Vodnik za Share of Voice: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Vodnik za množično označevanje: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

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

Strežnik MCP: https://developers.ranktracker.com/mcp/

Povezava MCP odjemalca: https://developers.ranktracker.com/mcp/connect/

Referenca orodja MCP: https://developers.ranktracker.com/mcp/tools/

Začnite razvijati z API-jem Ranktracker

API Ranktracker spremeni Ranktracker iz nadzorne plošče za SEO v infrastrukturo, ki se lahko nahaja neposredno znotraj vašega tehnološkega sklada.

Z njim lahko upravljate domene in ključne besede, spremljate konkurente, pridobivate uvrstitve v top 100, analizirate SERP-je, zaznavate AI-preglede, spremljate Share of Voice, dostopate do zgodovinskih podatkov o uvrstitvah, organizirate ključne besede, ustvarjate poročevalne poti in integrirate informacije o SEO v ostale dele vašega poslovanja.

Razvijalcem odpravlja potrebo po ročnem izvozu in prenosu podatkov o uvrstitvah.

Agencijam omogoča avtomatizacijo storitev za stranke v velikem obsegu.

Podjetniškim SEO-ekipam omogoča, da informacije o uvrstitvah postanejo del notranje analitike in podatkovne infrastrukture.

Spoznajte Ranktracker

Platforma "vse v enem" za učinkovito SEO

Za vsakim uspešnim podjetjem stoji močna kampanja SEO. Vendar je ob neštetih orodjih in tehnikah optimizacije težko vedeti, kje začeti. Ne bojte se več, ker imam za vas prav to, kar vam lahko pomaga. Predstavljam platformo Ranktracker vse-v-enem za učinkovito SEO

Končno smo odprli registracijo za Ranktracker popolnoma brezplačno!

Ustvarite brezplačen račun

Ali se prijavite s svojimi poverilnicami

Z MCP-strežnikom Ranktrackerja pa se isti osnovni podatki o SEO lahko dajo na voljo tudi AI-pomočnikom in agentom.

Ustvarite svoj API-ključ za Ranktracker: https://app.ranktracker.com/account/api

Preberite dokumentacijo: https://developers.ranktracker.com/

Oglejte si referenco 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 uporabljati Ranktracker... brezplačno!

Ugotovite, kaj preprečuje uvrstitev vašega spletnega mesta.

Ustvarite brezplačen račun

Ali se prijavite s svojimi poverilnicami

Different views of Ranktracker app