„Rank Tracker“ API

Įvadas

Reitingų stebėjimas tampa visiškai kitokia problema, kai turite valdyti šimtus svetainių, tūkstančius raktinių žodžių arba SEO ataskaitas, kurias reikia atnaujinti automatiškai.

Prisijungimas prie valdymo skydo ir duomenų eksportavimas rankiniu būdu gali tikti mažesniems projektams. Tačiau dideliu mastu tai greitai tampa kliūtimi.

Būtent todėl sukūrėme „Ranktracker API“.

„Ranktracker“ API jau veikia ir suteikia programuotojams, SEO komandoms, agentūroms, SaaS įmonėms bei duomenų komandoms programinę prieigą prie jų „Ranktracker“ duomenų.

API galite naudoti:

• Gaukite 100 populiariausių raktinių žodžių reitingus
• Prieiga prie SERP duomenų
• Aptikite AI apžvalgas ir kitas SERP funkcijas
• Sukurti ir valdyti stebimus domenus
• Pridėkite ir tvarkykite raktažodžius
• Stebėkite konkurentus
• Prieiga prie reitingų istorijos
• Apskaičiuokite „Share of Voice“
• Rūšiuokite raktažodžius naudodami žymes
• Stebėkite paskyros naudojimą ir kvotą
• Sukurkite automatizuotas SEO ataskaitų teikimo sistemas
• Susieti reitingų duomenis su vidinėmis programomis ir informacinėmis lentelėmis

Vietoj to, kad rankiniu būdu perkeltumėte SEO duomenis iš vienos platformos į kitą, „Ranktracker API“ leidžia jūsų programinei įrangai tiesiogiai dirbti su „Ranktracker“ reitingų infrastruktūra.

Sukurkite arba tvarkykite savo API raktą: https://app.ranktracker.com/account/api

Perskaitykite API dokumentaciją: https://developers.ranktracker.com/

Kas yra „Ranktracker“ API?

„ „Ranktracker“ API yra REST API, suteikiantis programinę prieigą prie jūsų „Ranktracker“ paskyros.

Užuot kaskart atidarinėjus „Ranktracker“, kai reikia reitingų informacijos, jūsų programa gali automatiškai užklausti duomenis.

API struktūra pagrįsta tais pačiais pagrindiniais ištekliais, kurie naudojami visame „Ranktracker“:

• Paskyros
• Domenai
• Raktiniai žodžiai
• Konkurentai
• Reitingų istorija
• SERP duomenys
• Pastebimumo dalis
• Žymės
• Naudojimas ir kvota

Tai suteikia kūrėjams galimybę tiek gauti „Ranktracker“ duomenis, tiek valdyti, ką „Ranktracker“ stebi.

Pavyzdžiui, SEO agentūra galėtų automatiškai sukurti „Ranktracker“ projektą, kai naujas klientas įtraukiamas į jos CRM sistemą, pridėti kliento raktinius žodžius ir konkurentus, o tada perkelti jų reitingus į vidinę ataskaitų suvestinę.

SaaS platforma galėtų naudoti tą pačią API, kad reitingų duomenis pateiktų tiesiogiai savo pačios produkte.

Duomenų komanda galėtų automatiškai siųsti kasdienius reitingus į „BigQuery“, „Snowflake“, „PostgreSQL“, „Google Sheets“ ar kitą duomenų saugyklą tolesnei analizei.

Apžvalgą, kaip šie ištekliai dera tarpusavyje, rasite „Ranktracker API“ pagrindinių sąvokų vadove.

Pagal numatytuosius nustatymus rodomi 100 geriausių reitingai

Vienas iš didžiausių „Ranktracker API“ privalumų – reitingų duomenų išsamumas.

Kiekvienas raktažodžio patikrinimas pagal numatytuosius nustatymus apima 100 geriausių „Google“ rezultatų.

Tai reiškia, kad galite analizuoti visus 10 paieškos rezultatų puslapių, o ne tik matyti, kas šiuo metu yra pirmojo puslapio reitinguose.

Tai svarbu, nes SEO pažanga paprastai prasideda gerokai anksčiau, nei raktažodis patenka į dešimtuką.

Raktinis žodis gali pakilti:

91 vieta → 63 vieta → 37 vieta → 18 vieta → 9 vieta

Tai rodo reikšmingą SEO pažangą.

Jei jūsų reitingo duomenys apsiriboja pirmuoju dešimtuku, beveik visa pažanga lieka nematoma.

100 geriausių rezultatų stebėjimas leidžia jums stebėti:

• Nauji reitingai, patekę į „Google“ 100 geriausių sąrašą
• Raktiniai žodžiai, pakilę į pirmąjį puslapį
• Dideli reitingų pakilimai ir kritimai
• Konkurentų pokyčiai
• „Long-tail“ paieškos matomumas
• Naujo turinio efektyvumas
• Programinės SEO kampanijos
• Didelės raktažodžių kolekcijos

Dėl to API yra naudingas tiek aukšto lygio SEO ataskaitoms, tiek išsamiai reitingų analizei.

Sužinokite daugiau apie API:

https://developers.ranktracker.com/

Reitingų stebėjimas daugiau nei 107 000 vietovių

Paieškos rezultatai labai skiriasi priklausomai nuo to, kur atliekama paieška.

„Ranktracker“ palaiko daugiau nei 107 000 vietovių, suteikdamas komandoms galimybę stebėti vietinį, nacionalinį ir tarptautinį matomumą paieškoje per API.

Raktinių žodžių stebėjimą galima konfigūruoti atsižvelgiant į tokius veiksnius kaip:

• Paieškos sistema
• Vieta
• Kalba
• Įrenginys

Pavyzdžiui, tą pačią raktinę frazę galima stebėti atskirai pagal:

• JAV — stacionarūs kompiuteriai
• JAV — mobilusis įrenginys
• Jungtinė Karalystė — stacionarusis kompiuteris
• Vokietija — mobilusis
• Lenkija — stacionarūs kompiuteriai

Kiekvieną konfigūraciją galima laikyti atskiru stebimu raktiniu žodžiu.

Tai ypač naudinga:

• Tarptautinė SEO
• Įvairiose vietovėse veikiančios įmonės
• Vietinės SEO agentūros
• Elektroninės prekybos įmonės
• Įvairiose rinkose veikiantys leidėjai
• SaaS įmonės, orientuotos į kelias šalis
• Įmonių SEO komandos

Užuot laikę raktinį žodį turinčiu vieną universalią reitingo poziciją, galite analizuoti, kaip matomumas kinta skirtingose rinkose ir skirtinguose įrenginiuose.

Reitingų stebėjimas kompiuteriuose ir mobiliaisiais įrenginiais

Stacionariųjų kompiuterių ir mobiliųjų įrenginių paieškos rezultatai gali skirtis.

Todėl „Ranktracker“ leidžia segmentuoti raktažodžių stebėjimą pagal įrenginį.

Tai reiškia, kad integruota sistema gali atskirai analizuoti:

• Reitingai kompiuteriuose
• Mobilieji reitingai

Pavyzdžiui, puslapis gali užimti aukštą poziciją stacionariuose kompiuteriuose, tačiau mobiliajame įrenginyje jo rezultatai gali skirtis dėl SERP išdėstymo, vietinių rezultatų ar kitų paieškos funkcijų skirtumų.

Atskirų duomenų rinkinių išlaikymas suteikia SEO komandoms daug aiškesnį vaizdą apie tai, kaip vartotojai iš tikrųjų susiduria su jų svetainėmis paieškoje.

API taip pat leidžia segmentuoti pagal įrenginius dirbant su tokiomis funkcijomis kaip „Share of Voice“.

SERP funkcijų ir AI apžvalgos aptikimas

Šiuolaikiniai „Google“ rezultatai apima kur kas daugiau nei tradicinius organinius sąrašus.

SERP gali apimti:

• AI apžvalgos
• Išskirtiniai fragmentai
• Žemėlapiai
• Vietiniai rezultatai
• Vaizdo įrašai
• Pirkimo rezultatai
• Dažnai užduodami klausimai
• Kitos paieškos funkcijos

„Ranktracker“ API, be raktažodžių duomenų, taip pat apima informaciją apie SERP funkcijas ir AI apžvalgos aptikimą.

Tai reiškia, kad jūsų integracija gali analizuoti ne tik tai, kur svetainė užima reitingą, bet ir tai, kas aplink tą reitingą „Google“.

Pavyzdžiui, galite nustatyti:

• Raktiniai žodžiai, kurie suaktyvina AI apžvalgą
• Paieškos rezultatų puslapiai su išskirtiniais fragmentais
• Paieškos užklausos, kuriose dominuoja vaizdo įrašų rezultatai
• Raktiniai žodžiai, generuojantys vietinius arba žemėlapio rezultatus
• Paieškos rezultatų puslapių sudėties pokyčiai laikui bėgant

Tai tampa vis svarbiau, nes vien organinė pozicija ne visada atskleidžia visą vaizdą.

Puslapis, užimantis trečią vietą tradiciniame SERP, ir puslapis, užimantis trečią vietą po „AI Overview“, žemėlapių rinkinio, vaizdo įrašų ir „People Also Ask“, gali sulaukti labai skirtingo matomumo lygio.

API leidžia šiuos skirtumus įtraukti į jūsų SEO analizę.

Peržiūrėkite visą API dokumentaciją:

https://developers.ranktracker.com/

Prieiga prie išsamių SERP duomenų

„Ranktracker“ gali pateikti kur kas daugiau nei vien tik reitingo skaičių.

Stebimų raktinių žodžių atveju API gali pateikti naujausius paieškos rezultatus kartu su susijusia SERP informacija.

API išteklių struktūra apima:

• Naujausi SERP duomenys
• Reitingų informacija
• SERP funkcijos
• SERP HTML iš talpyklos

Tai reiškia, kad kūrėjai gali kurti darbo eigas, pagrįstas tikrais paieškos rezultatais, o ne tik saugoti tokius duomenis kaip:

Pozicija: 12

Pažengusioms SEO komandoms tai suteikia daug daugiau lankstumo.

SERP informaciją galite naudoti:

• Konkuruojančių URL adresų analizė
• Tyrimas dėl netikėtų reitingo pokyčių
• Rezultatų išdėstymo pokyčių nustatymas
• Sukurti vidinius SERP analizės įrankius
• Serp istorinių duomenų saugojimas
• Įtraukite paieškos rezultatų informaciją į kitus modelius ar analizės sistemas

Išsamią galinių taškų nuorodą rasite čia:

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

Domenų valdymas per API

Domenai yra vienas iš pagrindinių „Ranktracker“ API išteklių.

REST API leidžia jums:

• Sukurti domenus
• Išgauti domenus
• Atnaujinti domenus
• Ištrinti domenus

Domenas reiškia svetainę, kuri yra stebima „Ranktracker“ sistemoje.

Kiekvienas domenas gali turėti:

• Raktiniai žodžiai
• Konkurentai
• Reitingų istorija
• „Share of Voice“ duomenys

Tai leidžia automatizuoti naujų domenų įtraukimą.

Pavyzdžiui, agentūra galėtų sukurti tokį darbo srautą:

Naujas klientas užsiregistruoja
        ↓
Sukurti „Ranktracker“ domeną
        ↓
Pridėti kliento raktažodžius
        ↓
Pridėti konkurentus
        ↓
Pradėti reitingų stebėjimą
        ↓
Siųsti duomenis į ataskaitų skydą

Komandos nariui nereikia rankiniu būdu konfigūruoti kiekvieno naujo projekto.

Išsamus vadovas pateikiamas „Domeno pridėjimas ir raktažodžių stebėjimas“.

Raktinių žodžių pridėjimas ir valdymas programiškai

Sukūrus domeną, raktažodžius galima valdyti per API.

Naudodami API galite pridėti stebimus raktinius žodžius, nurodydami su jais susijusią paieškos konfigūraciją.

Stebimų raktinių žodžių duomenys gali apimti tokius veiksnius kaip:

• Žodis
• Paieškos sistema
• Vieta
• Kalba
• Įrenginys
• Rezultatų reitingas

Taip pat galite valdyti esamų raktinių žodžių stebėjimo ciklą.

Tai apima galimybę:

• Rasti raktažodžius
• Peržiūrėti reitingo informaciją
• Pristabdyti stebėjimą
• Atnaujinti stebėjimą
• Nutraukti stebėjimą
• Prieiti prie SERP informacijos
• Paskirti žymes

Tai leidžia jūsų pačių programai kontroliuoti, kurias raktines frazes stebi „Ranktracker“.

Masinis raktinių žodžių stebėjimas

Didelės SEO paskyros neturėtų turėti pateikti po vieną API užklausą kiekvienai raktažodžiui.

„Ranktracker“ palaiko masines raktinių žodžių operacijas.

Raktinių žodžių kūrimo galinis taškas priima „žodžių × paieškos sistemų“ konfigūraciją, leidžiančią vienu užklausimu sukurti daug stebimų raktinių žodžių derinių.

Pavyzdžiui, įsivaizduokite, kad norite stebėti:

• 100 raktinių žodžių
• JAV stacionarūs kompiuteriai
• JAV mobilieji įrenginiai

Šios konfigūracijos gali sukurti 200 stebimų raktinių žodžių derinių, nereikalaujant 200 atskirų nustatymo užklausų.

Masinės operacijos ypač naudingos:

• Agentūros
• Įmonių SEO
• Didelės elektroninės prekybos parduotuvės
• Programinis SEO
• SaaS SEO platformos
• Dideli turinio leidėjai

„Ranktracker“ taip pat palaiko masinį raktinių žodžių žymėjimą.

Perskaitykite išsamų masinių operacijų vadovą:

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

SEO konkurentų stebėjimas

Reitingai tampa daug naudingesni, kai juose atsižvelgiama į konkurencinę aplinką.

„Ranktracker“ API leidžia valdyti konkurentus, lyginant juos su stebimais domenais.

Tai leidžia automatiškai analizuoti jūsų paieškos rezultatus kartu su konkurentų svetainėmis.

Konkurentų duomenis galite naudoti stebėti:

• Kokie konkurentai tampa vis labiau matomi
• Kokios svetainės lenkia jūsų domeną
• Pokyčiai bendrose raktažodžių grupėse
• Konkurencinių reitingų tendencijos
• Santykinis matomumas paieškoje
• „Share of Voice“ pokyčiai

Agentūroms tai gali tapti automatizuotos klientų ataskaitų teikimo sistemos dalimi.

Vietoj to, kad kas mėnesį rankiniu būdu lygintumėte klientą su konkurentais, atitinkamus duomenis galima tiesiogiai integruoti į ataskaitų rengimo procesą.

Prieiga prie istorinių reitingų duomenų

Dabartiniai reitingai rodo tik tai, kas vyksta šiuo metu.

Istoriniai reitingų duomenys rodo, kokia kryptimi kinta SEO rezultatai.

„Ranktracker“ per API teikia domeno reitingų istoriją, leidžiančią kūrėjams analizuoti matomumą laikui bėgant.

Istoriniai duomenys gali padėti nustatyti:

• Reitingo padidėjimai
• Reitingo praradimai
• Matomumo tendencijos
• Raktinių žodžių pokyčiai
• Pokyčiai po SEO kampanijų
• „Google“ atnaujinimo poveikis
• Ilgalaikiai kampanijos rezultatai

Taip pat galite naudoti reitingų istoriją, kad sukurtumėte individualizuotus grafikus ir informacijos suvestines.

Pavyzdžiui:

„Ranktracker“ API
       ↓
Kasdienis reitingų išgavimas
       ↓
Duomenų saugykla
       ↓
Istorinių SEO duomenų rinkinys
       ↓
Prietaisų skydas / Įspėjimai / Analizė

„Ranktracker“ pateikia specialų vadovą, kuriame parodoma, kaip kasdienius reitingus perkelti į duomenų saugyklą:

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

„Ranktracker“ duomenų siuntimas į duomenų saugyklą

Vienas iš naudingiausių API darbo srautų – automatinis „Ranktracker“ duomenų saugojimas jūsų pačių duomenų bazėje ar saugykloje.

Pavyzdžiui, reitingų duomenys gali būti siunčiami į:

• „BigQuery“
• „Snowflake“
• „PostgreSQL“
• „MySQL“
• „Google“ skaičiuoklės
• Vidinės analitikos duomenų bazės

Tą informaciją vėliau galima sujungti su kitais verslo duomenimis.

Pavyzdžiui:

„Ranktracker“
     ↓
„Ranktracker“ API
     ↓
Duomenų saugyklą
     ↓
„Google Search Console“
„Analytics“
Konversijas
Pajamas
CRM duomenis
     ↓
Verslo analitikos informacijos suvestinę

Tai suteikia daug išsamesnį SEO veiklos vaizdą.

Užuot tiesiog žinoję, kad raktažodis pakilo iš 8-os vietos į 3-ią, galėtumėte išanalizuoti, ar šis pokytis taip pat lėmė:

• Daugiau natūralių paspaudimų
• Daugiau potencialių klientų
• Aukštesni konversijos rodikliai
• Padidėjusios pajamos

„ „Rankings to Warehouse“ vadovas pateikiamas pavyzdys, kaip sukurti tokio tipo duomenų srautą.

„Share of Voice“ ataskaitų kūrimas

„Ranktracker“ API taip pat pateikia „Share of Voice “ duomenis.

„Share of Voice“ suteikia platesnį matą, leidžiantį įvertinti, kiek domenas yra matomas stebimų raktinių žodžių rinkinyje.

Vietoj to, kad klaustumėte:

Kokią poziciją užimame pagal šį raktinį žodį?

galite paklausti:

Kiek esame matomi visoje paieškos rinkoje?

Tai tampa ypač naudinga, kai įtraukiami konkurentų duomenys.

„Share of Voice“ API galima naudoti analizuojant:

• Jūsų bendras matomumas
• Konkurentų matomumas
• Matomumo pokyčiai laikui bėgant
• Santykinė padėtis rinkoje
• Matomumas kompiuteriuose
• Matomumas mobiliajame įrenginyje

Galutinis taškas palaiko datų intervalus ir įrenginių segmentavimą, todėl „Share of Voice“ galima įtraukti į individualizuotas SEO ataskaitas.

Išsamus įgyvendinimo pavyzdys pateikiamas čia:

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

Raktinių žodžių tvarkymas naudojant žymes

Didelį raktinių žodžių rinkinį sunku valdyti, jei jis nėra susistemintas.

„Ranktracker“ siūlo paskyros lygio žymes, kurias galima priskirti stebimiems raktiniams žodžiams.

Galite sukurti žymes:

• Produktų kategorijos
• Paieškos tikslas
• Vietovės
• Turinio tipai
• Kampanijos
• Klientai
• Pardavimo proceso etapai
• Verslo padaliniai
• SEO komandos

Pavyzdžiui:

„pirkti bėgimo batelius“ → Komercinis
„geriausi bėgimo bateliai“ → Palyginimas
„kaip valyti bėgimo batelius“ → Informacinis

Tos pačios žymos gali būti pakartotinai naudojamos skirtinguose domenuose ir raktažodžių grupėse.

„Ranktracker“ taip pat siūlo masinį žymėjimą, todėl dideles raktinių žodžių grupes galima tvarkyti be atskirų užklausų.

Specialus vadovas pateikiamas čia:

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

Paskyros naudojimo ir kvotos stebėjimas

Automatizuotos sistemos taip pat turi žinoti, kokiais paskyros ištekliais jos gali naudotis.

„Ranktracker“ API teikia:

GET /v1/account/usage

Šis galinis taškas pateikia ataskaitą apie paskyros naudojimą ir limitus.

Dabartinė naudojimo informacija gali apimti:

• API prieigos būsena
• Raktiniai žodžiai
• Duomenų eilutės
• Naudojimas pagal užsakymą
• „SERP Analyser“ naudojimas

Kiekviena kvota gali pateikti tokias reikšmes kaip:

• Naudojimas
• Ribos
• Liko

Tai leidžia programai patikrinti turimą talpą prieš pradedant didelę operaciją.

Pavyzdžiui, prieš importuodama tūkstančius raktinių žodžių, jūsų sistema gali patikrinti paskyros naudojimą ir nustatyti, kiek talpos dar liko.

Perskaitykite išsamų vadovą:

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

Kaip veikia „Ranktracker“ API autentifikavimas

„Ranktracker“ REST API užklausos autentiškumas patvirtinamas naudojant API raktą.

Raktus galite kurti ir valdyti tiesiogiai „Ranktracker“ sistemoje:

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

Savo API raktą visada turėtumėte laikyti kaip slaptažodį.

Produkcijos API bazinis URL adresas yra:

https://api.ranktracker.com

API ištekliai yra /v1 kelyje.

Pavyzdžiui:

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

API raktas siunčiamas tiesiogiai „Authorization“ antraštėje.

Standartiniuose REST API užklausose nėra „Bearer“ priešdėlio.

Pavyzdys:

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

„Ranktracker“ API raktas turėtų būti saugomas serverio pusėje ir niekada neturėtų būti atskleidžiamas per:

• Naršyklės JavaScript
• Front-end šaltinio kodas
• Vieši repozitorijai
• Mobilioji programėlė
• Vieši konfigūracijos failai

Daugiau informacijos rasite čia:

Pradžios vadovas: https://developers.ranktracker.com/guides/quickstart/

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

API raktų kūrimas ir valdymas: https://app.ranktracker.com/account/api

API išteklių struktūra

„Ranktracker“ naudoja UUID identifikuoti išteklius.

Tai apima tokius išteklius kaip:

• Domenai
• Raktiniai žodžiai
• Konkurentai
• Žymės

Supaprastintas vaizdas atrodo taip:

Paskyra
│
├── Naudojimas
├── Žymės
│
└── Domenai
    │
    ├── Reitingų istorija
    ├── Rinkos dalis
    ├── Konkurentai
    │
    └── Raktažodžiai
        │
        ├── SERP
        ├── SERP HTML iš talpyklos
        └── Žymės

Tai leidžia numatyti API struktūrą.

Domenas turi raktinius žodžius ir konkurentus.

Raktinis žodis priklauso stebimam domenui ir turi susijusią SERP bei reitingo informaciją.

Žymės egzistuoja paskyros lygiu ir gali būti priskirtos raktiniams žodžiams.

Skaityti daugiau:

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

JSON API atsakymai

„Ranktracker“ atsakymai naudoja nuoseklų JSON:API stiliaus apvalkalą.

Ištekliai grąžinami „data“ dalyje, o jų laukai saugomi „attributes“ dalyje.

Pavyzdžiui:

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

Kūrėjai taip pat turėtų žinoti apie svarbią pavadinimų suteikimo taisyklę:

• API atsakymai naudoja „camelCase“
• Rašant užklausų tekstą, naudokite „snake_case“

Pavyzdžiui, atsakyme gali būti:

projectName

o rašymo užklausoje naudojama:

project_name

Ši taisyklė taikoma visoje API.

Žr.:

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

Puslapių skirstymas

Sąrašų galiniai taškai yra suskirstyti į puslapius, kad programos galėtų efektyviai dirbti su didelėmis „Ranktracker“ paskyromis.

Puslapių skirstymas taikomas šiems ištekliams:

• Domenai
• Raktiniai žodžiai
• Konkurentai
• Žymės

Du pagrindiniai parametrai yra:

• puslapis
• viename_puslapyje

per_page palaiko iki 1 000 įrašų viename puslapyje.

Informacija apie puslapių skirstymą grąžinama per atsakymo antraštes, įskaitant:

• X-Bendras skaičius
• X-Bendras puslapių skaičius
• X-Puslapių skaičius viename puslapyje
• X-Dabartinis puslapis

Todėl eksportuojant didelius duomenų kiekius programos gali toliau prašyti puslapių, kol bus gautas visas duomenų rinkinys.

Perskaitykite puslapių skirstymo vadovą:

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

Klaidų tvarkymas ir greičio apribojimai

„Ranktracker“ API naudoja standartinius HTTP būsenos kodus, kad programiškai būtų lengviau tvarkyti nesėkmes.

Dažniausiai pasitaikantys atsakymai:

Būklė	Reikšmė	Pavyzdys
400	Neteisingas užklausimas	Trūksta privalomo parametro arba jis yra netinkamai suformuotas
402	Viršyta kvota	Prašoma operacija viršytų paskyros limitą
403	Draudžiama	Prašymas nėra autorizuotas arba prieiga prie API yra neprieinama
404	Nerasta	Išteklių nėra paskyroje
422	Patikrinimo klaida	Užklausa yra tinkamo JSON formato, tačiau joje yra neteisingų duomenų
429	Per daug užklausų	Integracijai taikomas prašymų skaičiaus apribojimas

Kai gaunamas 429 atsakymas, integracijos turėtų atsižvelgti į grąžintą „Retry-After“ informaciją prieš bandant dar kartą.

Tai leidžia gamybinėms programoms tvarkyti laikinus srauto apribojimus, o ne tiesiog patirti nesėkmę.

Išsami dokumentacija apie klaidas ir srauto apribojimus pateikta čia:

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

„Ranktracker“ REST API ir MCP

REST API nėra vienintelis būdas prijungti išorinę programinę įrangą prie „Ranktracker“.

„Ranktracker“ taip pat teikia hostuojamą MCP serverį.

MCP reiškia „Model Context Protocol“ (Modelio konteksto protokolas) ir leidžia suderinamoms AI programoms bei agentams tiesiogiai dirbti su „Ranktracker“ duomenimis.

Tai apima suderinamus klientus, pvz.:

• ChatGPT
• Claude
• Cursor
• Kitos su MCP suderinamos AI programos

REST ir MCP naudoja tuos pačius pagrindinius „Ranktracker“ duomenis, tačiau jos yra skirtos skirtingiems darbo srautams.

	„Ranktracker“ REST API	„Ranktracker“ MCP
Tinka	Programoms, informacijos suvestinėms, duomenų saugykloms ir suplanuotoms užduotims	AI asistentams ir agentams
Skambintojas	Jūsų užkulisinė sistema arba HTTP klientas	„ChatGPT“, „Claude“, „Cursor“ ar kitas MCP klientas
Sąsaja	REST galiniai taškai	MCP įrankiai
REST kelias	/v1/...	/mcp
Tipinis naudojimas	Automatinis SEO duomenų perkėlimas ir valdymas	SEO duomenų tyrinėjimas pokalbio forma

Pavyzdžiui, REST yra geresnis pasirinkimas, jei norite:

• Kiekvieną naktį eksportuoti reitingus
• Atnaujinti BI informacijos suvestinę
• Automatiškai kurti SEO projektus
• Raktinių žodžių pridėjimas iš jūsų programos
• Reitingų duomenų sinchronizavimas su duomenų baze

MCP labiau tinka tokiems klausimams kaip:

Kurios iš mano stebimų raktinių žodžių reitingai šią savaitę nukrito labiausiai?

arba:

Kurie konkurentai tapo labiausiai matomi?

AI klientas gali pasirinkti tinkamą „Ranktracker“ įrankį ir užklausti atitinkamus duomenis.

Daugelis pažengusių SEO komandų gali naudoti abu.

REST tvarko infrastruktūrą ir automatizavimą. MCP užtikrina, kad „Ranktracker“ duomenys būtų prieinami AI agentams.

Sužinokite daugiau:

MCP apžvalga: https://developers.ranktracker.com/mcp/

Prijunkite MCP klientą: https://developers.ranktracker.com/mcp/connect/

MCP įrankio aprašymas: https://developers.ranktracker.com/mcp/tools/

Ką galima sukurti naudojant „Ranktracker“ API?

„Ranktracker“ API galima naudoti ne tik raktažodžių pozicijoms rodyti.

Štai keletas naudingiausių taikymų.

Automatinės SEO ataskaitos

Agentūra gali automatiškai importuoti reitingų informaciją į savo ataskaitų platformą.

Vietoj to:

Atidaryti „Ranktracker“
↓
Eksportuoti į CSV
↓
Redaguoti skaičiuoklę
↓
Įkelti ataskaitą
↓
Siųsti klientui

galite sukurti:

„Ranktracker“ API
↓
Ataskaitų platformą
↓
Automatiškai atnaujinamą kliento ataskaitą

Tai ypač naudinga agentūroms, kurios aptarnauja daug klientų.

Individualizuotos SEO informacijos suvestinės

Jūsų įmonė galbūt jau naudoja vidinę ataskaitų rengimo ar verslo analitikos platformą.

API leidžia „Ranktracker“ duomenis paversti dar vienu duomenų šaltiniu toje aplinkoje.

Galite sukurti informacijos suvestines, kuriose būtų rodomi:

• Raktinių žodžių reitingai
• Reitingų pokyčiai
• 3 populiariausios raktinės frazės
• 10 populiariausių raktinių žodžių
• 100 populiariausių raktinių žodžių
• Rinkos dalis
• Konkurentų matomumas
• SERP funkcijos
• AI apžvalgos pasirodymai

Sukurta informacinė panelė gali būti pritaikyta specialiai pagal jūsų įmonės ataskaitų rengimo poreikius.

Automatizuotas klientų įtraukimas

SEO agentūros gali integruoti „Ranktracker“ į savo klientų įtraukimo procesą.

Pavyzdžiui:

Klientas perka SEO paketą
↓
CRM sukuria kliento įrašą
↓
„Ranktracker“ API sukuria domeną
↓
Pridedami raktažodžiai
↓
Pridedami konkurentai
↓
Pradedamas stebėjimas

Tai pašalina pasikartojančius rankinius projekto nustatymus.

SEO duomenų saugyklos

Reitingai tampa vertingesni, kai jie susiejami su kitais rinkodaros ir verslo duomenimis.

„Ranktracker“ informaciją galima derinti su:

• „Google Search Console“
• Analitika
• CRM duomenys
• Konversijų duomenys
• Elektroninės prekybos pajamos
• Potencialių klientų duomenys
• Turinio efektyvumas

Tai gali padėti atsakyti į kur kas svarbesnius klausimus nei paprasčiausias reitingo patikrinimas.

Pavyzdžiui:

Kokie reitingo pagerinimai generavo didžiausias pajamas?

arba:

Kokios raktinių žodžių grupės didina matomumą, bet nesukuria konversijų?

Reitingų įspėjimai

Istoriniai reitingų duomenys taip pat gali būti naudojami pritaikytoms įspėjimų sistemoms.

Integracija galėtų automatiškai nustatyti, kada:

• Raktinis žodis iškrito iš pirmųjų 3 vietų
• Puslapis patenka į dešimtuką
• Raktinis žodis patenka į 100 geriausių
• Pagrindinis raktinis žodis išnyksta iš 100 geriausių
• Konkurentas aplenkia jūsų svetainę
• Paieškos matomumas smarkiai sumažėja

Įspėjimai galėtų būti siunčiami į jūsų el. paštą, „Slack“, vidinę valdymo skydą arba stebėjimo sistemą.

Konkurencinė žvalgyba

Derinant:

• Reitingai
• Konkurentų stebėjimas
• Reitingų istorija
• Rinkos dalis

sukuria pagrindą automatizuotai konkurencinei SEO stebėjimo sistemai.

Vietoj to, kad konkurentus vertintumėte kartą per kelis mėnesius, jų matomumas paieškoje gali tapti nuolat stebimu rodikliu.

Programinis SEO stebėjimas

Programinis SEO gali sukurti tūkstančius ar šimtus tūkstančių nukreipimo puslapių.

Stebėti tuos projektus rankiniu būdu yra nerealu.

„Ranktracker“ API leidžia programuotojams kurti reitingavimo darbo srautus, galinčius apdoroti didelius raktažodžių duomenų rinkinius ir automatiškai perduoti gautą informaciją į vidines analitikos sistemas.

AI pagrįsta SEO analizė

„Ranktracker“ REST API ir MCP serveris taip pat gali tapti AI pagrįstų SEO darbo srautų dalimi.

Pavyzdžiui, AI sistemos galėtų padėti:

• Reitingų praradimų nustatymas
• Reitingų pokyčių apibendrinimas
• Greitai populiarėjančių raktinių žodžių paieška
• Palyginti konkurentų matomumą
• Analizuokite SERP pokyčius
• Nustatyti SEO galimybių prioritetus
• Sukurkite vidines ataskaitas
• Išnagrinėkite neįprastus reitingų pokyčius

API teikia struktūrizuotus duomenis, o AI gali padėti juos interpretuoti.

Kam skirta „Ranktracker“ API?

„Ranktracker“ API ypač naudinga:

• SEO agentūros
• Įmonių SEO komandos
• SaaS įmonės
• SEO programinės įrangos įmonės
• Programuotojai
• Duomenų inžinieriai
• BI komandos
• Elektroninės komercijos įmonės
• Partnerių rinkodaros specialistai
• Leidėjai
• Įvairiose vietovėse veikiančios įmonės
• Programinės SEO komandos
• Dirbtinio intelekto automatizavimo komandos

Jei reitingų duomenis reikia gauti, perkelti, analizuoti ar valdyti automatiškai, API paprastai yra kur kas labiau pritaikomas sprendimas nei rankinis eksportavimas.

Kodėl verta naudoti „Ranktracker“, o ne kurti savo pačių reitingų stebėjimo infrastruktūrą?

Reitingų rinkimas dideliu mastu apima kur kas daugiau nei paprastą paiešką „Google“.

Veikianti reitingų stebėjimo sistema turi atsižvelgti į:

• Vietovės
• Kalbos
• Įrenginiai
• 100 geriausių rezultatų rinkinys
• SERP funkcijos
• AI apžvalgos
• Raktinių žodžių konfigūracija
• Istoriniai reitingų duomenys
• Konkurentai
• Planavimas
• Paieškos rezultatų pokyčiai
• Duomenų saugojimas
• Ataskaitos

Visos šios infrastruktūros kūrimas ir priežiūra viduje gali pareikalauti nemažai programavimo išteklių.

„Ranktracker“ tvarko reitingų stebėjimo infrastruktūrą ir pateikia gautus duomenis per struktūrizuotą API.

Todėl jūsų programuotojai gali sutelkti dėmesį į programos, valdymo skydo, darbo eigos ar analizės, kurių iš tikrųjų reikia jūsų verslui, kūrimą.

Kaip pradėti naudoti „Ranktracker“ API

Pradėti reikia atlikti tik keletą veiksmų.

1. Atidarykite savo API nustatymus

Eikite tiesiai į:

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

Sukurkite API raktą ir saugiai jį išsaugokite.

2. Perskaitykite greitojo pradžios vadovą

Vadovaukitės oficialiu greitojo pradžios vadovu:

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

3. Pateikite pirmąjį užklausimą

Pavyzdžiui:

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

4. Susipažinkite su API žinynu

Išsami REST API žinynas pateikiamas čia:

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

5. Pradėkite kurti

Nuo čia galite pradėti jungti „Ranktracker“ prie:

• Jūsų programa
• Jūsų ataskaitų sistema
• Jūsų duomenų sandėlis
• Jūsų CRM
• Jūsų vidiniai įrankiai
• Jūsų AI darbo srautai

„Ranktracker“ API dokumentacija

Išsamią kūrėjų dokumentaciją rasite čia:

Kūrėjų dokumentacija: https://developers.ranktracker.com/

API raktų kūrimas ir valdymas: https://app.ranktracker.com/account/api

Greitasis pradžios vadovas: https://developers.ranktracker.com/guides/quickstart/

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

Pagrindinės sąvokos: https://developers.ranktracker.com/guides/concepts/

Puslapių numeravimas: https://developers.ranktracker.com/guides/pagination/

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

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

Masinės operacijos: https://developers.ranktracker.com/guides/bulk-operations/

Pamoka apie domeno sekimą: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Vadovas „Rankings to warehouse“: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

„Share of Voice“ vadovas: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Mokomasis vadovas apie masinį žymėjimą: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

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

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

MCP kliento prijungimas: https://developers.ranktracker.com/mcp/connect/

MCP įrankio žinynas: https://developers.ranktracker.com/mcp/tools/

Pradėkite kurti naudodami „Ranktracker“ API

„Ranktracker“ API paverčia „Ranktracker“ iš SEO valdymo skydo į infrastruktūrą, kuri gali būti integruota tiesiai į jūsų technologijų paketą.

Jį galite naudoti domenams ir raktažodžiams valdyti, konkurentams stebėti, „Top 100“ reitingams gauti, SERP analizuoti, AI apžvalgoms aptikti, „Share of Voice“ stebėti, prieigai prie istorinių reitingų duomenų gauti, raktažodžiams tvarkyti, ataskaitų teikimo procesams kurti ir SEO informaciją integruoti su likusia jūsų verslo dalimi.

Programuotojams tai pašalina būtinybę rankiniu būdu eksportuoti ir perkelti reitingų duomenis.

Agentūroms tai leidžia įgyvendinti didelio masto klientų aptarnavimo automatizavimą.

Įmonių SEO komandoms tai leidžia reitingų informaciją įtraukti į vidinę analitiką ir duomenų infrastruktūrą.

O naudojant „Ranktracker“ MCP serverį, tie patys pagrindiniai SEO duomenys taip pat gali būti prieinami AI asistentams ir agentams.

Sukurkite savo „Ranktracker“ API raktą: https://app.ranktracker.com/account/api

Perskaitykite dokumentaciją: https://developers.ranktracker.com/

Peržiūrėkite REST API žinyną: https://developers.ranktracker.com/rest-api/