Rank Tracker -sovellusliittymä (API)

Johdanto

Sijoitusten seuranta muuttuu aivan erilaiseksi haasteeksi, kun hallinnoit satoja verkkosivustoja, tuhansia avainsanoja tai SEO-raportteja, jotka on päivitettävä automaattisesti.

Dashboardiin kirjautuminen ja tietojen manuaalinen vienti saattavat toimia pienemmissä projekteissa. Suuremmassa mittakaavassa siitä tulee nopeasti pullonkaula.

Siksi olemme kehittäneet Ranktracker-sovellusliittymän.

Ranktracker-sovellusliittymä on nyt käytössä ja tarjoaa kehittäjille, SEO-tiimeille, toimistoille, SaaS-yrityksille ja datatiimeille ohjelmoitavan pääsyn Ranktracker-tietoihinsa.

Voit käyttää API:ta seuraaviin tarkoituksiin:

• Hae 100 parhaan avainsanan sijoitukset
• Käytä SERP-tietoja
• Tunnista AI-yhteenvedot ja muut SERP-ominaisuudet
• Seurattavien verkkotunnusten luominen ja hallinta
• Lisää ja hallinnoi avainsanoja
• Seuraa kilpailijoita
• Käytä sijoitushistoriaa
• Laske Share of Voice
• Järjestä avainsanoja tunnisteiden avulla
• Seuraa tilin käyttöä ja kiintiötä
• Luo automatisoituja SEO-raportointiprosesseja
• Yhdistä sijoitustiedot sisäisiin sovelluksiin ja hallintapaneeleihin

Sen sijaan, että siirtäisit SEO-tietoja manuaalisesti alustojen välillä, Ranktracker-sovellusliittymän avulla oma ohjelmistosi voi toimia suoraan Ranktrackerin taustalla olevan sijoitusinfrastruktuurin kanssa.

Luo tai hallinnoi API-avainta: https://app.ranktracker.com/account/api

Lue API-dokumentaatio: https://developers.ranktracker.com/

Mikä on Ranktracker-API?

Ranktracker Ranktracker-sovellusliittymä on REST-API, joka tarjoaa ohjelmointipohjaisen pääsyn Ranktracker-tiliisi.

Sen sijaan, että avaisit Ranktrackerin joka kerta, kun tarvitset sijoitustietoja, sovelluksesi voi pyytää tiedot automaattisesti.

API on rakennettu samojen ydinresurssien ympärille, joita käytetään koko Ranktrackerissa:

• Tilit
• Verkkotunnukset
• Avainsanat
• Kilpailijat
• Sijoitushistoria
• SERP-tiedot
• Äänen osuus
• Tunnisteet
• Käyttö ja kiintiö

Tämä antaa kehittäjille mahdollisuuden sekä hakea Ranktracker-tietoja että hallita sitä, mitä Ranktracker seuraa.

Esimerkiksi SEO-toimisto voisi luoda automaattisesti Ranktracker-projektin, kun uusi asiakas lisätään sen CRM-järjestelmään, lisätä asiakkaan avainsanat ja kilpailijat ja syöttää sitten niiden sijoitukset sisäiseen raportointipaneeliin.

SaaS-alusta voisi käyttää samaa API:ta sijoitustietojen näyttämiseen suoraan omassa tuotteessaan.

Tietotiimi voisi lähettää päivittäiset sijoitukset automaattisesti BigQueryyn, Snowflakeen, PostgreSQL:ään, Google Sheetsiin tai muuhun tietovarastoon jatkokäsittelyä varten.

Yleiskatsaus resurssien yhteensopivuudesta löytyy Ranktracker-API:n peruskäsitteet -oppaasta.

Oletusarvoisesti 100 parasta sijoitusta

Yksi Ranktracker-sovellusliittymän suurimmista eduista on sijoitustietojen kattavuus.

Jokainen avainsanatarkistus sisältää oletuksena Googlen 100 parasta tulosta.

Tämä tarkoittaa, että voit analysoida kaikkia 10 hakutulossivua sen sijaan, että näkisit vain sen, mikä tällä hetkellä sijoittuu ensimmäiselle sivulle.

Tämä on tärkeää, koska SEO-työn tulokset alkavat yleensä näkyä jo kauan ennen kuin avainsana nousee kymmenen parhaan joukkoon.

Hakusana voi liikkua seuraavasti:

Sija 91 → Sija 63 → Sija 37 → Sija 18 → Sija 9

Tämä edustaa merkittävää SEO-kehitystä.

Jos sijoitustietosi päättyvät 10 ensimmäiseen tulokseen, lähes koko matka jää näkymättömäksi.

Top 100 -seurannan avulla voit seurata:

• Uudet sijoitukset Googlen Top 100 -listalle
• Ensimmäiselle sivulle nousseet avainsanat
• Suuret nousut ja laskut sijoituksissa
• Kilpailijoiden liikkeet
• Long-tail-hakujen näkyvyys
• Uuden sisällön suorituskyky
• Ohjelmoidut SEO-kampanjat
• Laajat avainsanaportfoliot

Tämä tekee API:sta hyödyllisen sekä yleisen tason SEO-raportoinnissa että yksityiskohtaisessa sijoitusanalyysissä.

Lisätietoja API:sta:

https://developers.ranktracker.com/

Seuraa sijoituksia yli 107 000 sijainnissa

Hakutulokset vaihtelevat merkittävästi sen mukaan, missä haku suoritetaan.

Ranktracker tukee yli 107 000 sijaintia, mikä antaa tiimeille mahdollisuuden seurata paikallista, kansallista ja kansainvälistä näkyvyyttä hakukoneissa API:n kautta.

Avainsanojen seuranta voidaan määrittää muun muassa seuraavien tekijöiden perusteella:

• Hakukone
• Sijainti
• Kieli
• Laite

Esimerkiksi samaa avainsanaa voidaan seurata erikseen seuraavien tekijöiden osalta:

• Yhdysvallat — pöytätietokone
• Yhdysvallat — mobiili
• Iso-Britannia — tietokone
• Saksa — mobiili
• Puola — tietokone

Jokaista määritystä voidaan käsitellä erillisenä seurattavana avainsanana.

Tämä on erityisen hyödyllistä seuraavissa tilanteissa:

• Kansainvälinen hakukoneoptimointi
• Useilla paikkakunnilla toimivat yritykset
• Paikalliset SEO-toimistot
• Verkkokauppayritykset
• Eri markkinoilla toimivat julkaisijat
• Useisiin maihin kohdistuvat SaaS-yritykset
• Yritysten SEO-tiimit

Sen sijaan, että avainsanaa käsiteltäisiin yhtenä yleispätevänä sijoitussijana, voit analysoida, miten näkyvyys muuttuu eri markkinoilla ja laitteilla.

Tietokoneiden ja mobiililaitteiden sijoitusten seuranta

Tietokoneiden ja mobiililaitteiden hakutulokset voivat poiketa toisistaan.

Ranktracker mahdollistaa siksi avainsanojen seurannan segmentoinnin laitteittain.

Tämä tarkoittaa, että integroinnin avulla voidaan analysoida erikseen:

• Tietokoneiden hakutulokset
• Mobiilisijoitukset

Esimerkiksi sivu voi sijoittua korkealle pöytäkoneella, mutta toimia eri tavalla mobiililaitteella SERP-asettelun, paikallisten tulosten tai muiden hakutoimintojen erojen vuoksi.

Näiden tietojoukkojen pitäminen erillään antaa SEO-tiimeille paljon selkeämmän kuvan siitä, miten käyttäjät todellisuudessa kohtaavat heidän verkkosivustonsa hakutuloksissa.

API mahdollistaa laitteiden segmentointia myös käytettäessä esimerkiksi Share of Voice -ominaisuutta.

SERP-ominaisuudet ja tekoälyn tunnistuksen yleiskatsaus

Nykyaikaiset Google-hakutulokset sisältävät paljon enemmän kuin perinteiset orgaaniset listaukset.

SERP-sivut voivat sisältää:

• Tekoälyn yleiskatsaukset
• Esillä olevat katkelmat
• Kartat
• Paikalliset tulokset
• Videot
• Ostostulokset
• Ihmiset kysyvät myös
• Muut hakutoiminnot

Ranktracker-API sisältää avainsanatietojen lisäksi SERP-ominaisuustietoja ja tekoälyn yleiskatsauksen tunnistuksen.

Tämä tarkoittaa, että integrointisi voi analysoida paitsi verkkosivuston sijoitusta myös sitä, mitä muuta kyseisen sijoituksen ympärillä Googlessa näkyy.

Voit esimerkiksi tunnistaa:

• Avainsanat, jotka laukaisevat tekoälyn esikatselun
• Esillä olevia katkelmia sisältävät hakutulossivut
• Videotulokset hallitsevat hakukyselyjä
• Paikallisia tai karttatuloksia tuottavat avainsanat
• Muutokset hakutulossivujen koostumuksessa ajan myötä

Tämä on yhä tärkeämpää, koska pelkkä orgaaninen sijoitus ei aina kerro koko totuutta.

Sivu, joka sijoittuu kolmanneksi perinteisessä SERP:ssä, ja sivu, joka sijoittuu kolmanneksi AI-yleiskatsauksen, karttapaketin, videoiden ja People Also Ask -osion alla, voivat saada hyvin erilaista näkyvyyttä.

API:n avulla nämä erot voidaan ottaa huomioon SEO-analyysissäsi.

Katso API:n täydellinen dokumentaatio:

https://developers.ranktracker.com/

Pääset käsiksi täydellisiin SERP-tietoihin

Ranktracker tarjoaa paljon enemmän kuin pelkkän sijoitusnumeron.

Seurattujen avainsanojen osalta API voi näyttää uusimmat hakutulokset yhdessä niihin liittyvien SERP-tietojen kanssa.

API-resurssirakenne sisältää:

• Uusimmat hakutulostietojen tiedot
• Sijoitustiedot
• SERP-ominaisuudet
• Välimuistissa oleva SERP-HTML

Tämä tarkoittaa, että kehittäjät voivat rakentaa työnkulkuja todellisten hakutulosten ympärille sen sijaan, että vain tallentaisivat esimerkiksi seuraavaa:

Sijoitus: 12

Kokeneille SEO-tiimeille tämä tarjoaa huomattavasti enemmän joustavuutta.

SERP-tietoja voi käyttää esimerkiksi seuraaviin tarkoituksiin:

• Kilpailevien URL-osoitteiden analysointi
• Tutki odottamattomia sijoitusmuutoksia
• Tunnista muutokset tulosten asettelussa
• Sisäisten SERP-analyysityökalujen rakentaminen
• Tallenna historialliset SERP-tiedot
• Syötä hakutulostietoja muihin malleihin tai analytiikkajärjestelmiin

Täydellinen päätepisteviite löytyy täältä:

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

Verkkotunnusten hallinta API:n kautta

Verkkotunnukset ovat yksi Ranktracker-API:n keskeisistä resursseista.

REST-API:n avulla voit:

• Luo verkkotunnuksia
• Hae verkkotunnuksia
• Päivitä verkkotunnuksia
• Poista verkkotunnuksia

Verkkotunnus edustaa Ranktrackerissa seurattavaa sivustoa.

Jokaisella verkkotunnuksella voi olla omat:

• Avainsanat
• Kilpailijat
• Sijoitushistoria
• Share of Voice -tiedot

Tämä mahdollistaa automatisoidun käyttöönoton.

Esimerkiksi toimisto voisi luoda seuraavan työnkulun:

Uusi asiakas rekisteröityy
        ↓
Luo Ranktracker-verkkotunnus
        ↓
Lisää asiakkaan avainsanat
        ↓
Lisää kilpailijat
        ↓
Aloita sijoitusten seuranta
        ↓
Lähetä tiedot raportointipaneeliin

Tiimin jäsenen ei tarvitse määrittää jokaista uutta projektia manuaalisesti.

Kattava opas löytyy Lisää verkkotunnus ja seuraa avainsanoja -oppaassa.

Avainsanojen lisääminen ja hallinta ohjelmoimalla

Kun verkkotunnus on luotu, avainsanoja voidaan hallita sovellusliittymän (API) kautta.

Voit käyttää API:ta seurattavien avainsanojen lisäämiseen ja määrittää samalla niihin liittyvät hakukonfiguraatiot.

Seurattavien avainsanojen tiedot voivat sisältää esimerkiksi seuraavia tekijöitä:

• Sana
• Hakukone
• Sijainti
• Kieli
• Laite
• Sijoitustulokset

Voit myös hallita olemassa olevien avainsanojen seurannan elinkaarta.

Tähän sisältyy mahdollisuus:

• Hae avainsanoja
• Lue niiden sijoitustiedot
• Keskeytä seuranta
• Jatka seurantaa
• Lopeta seuranta
• Käytä SERP-tietoja
• Määritä tunnisteet

Tämän ansiosta oma sovelluksesi voi hallita, mitä avainsanoja Ranktracker seuraa.

Avainsanojen joukkoseuranta

Suurten SEO-tilien ei pitäisi joutua tekemään yhtä API-pyyntöä jokaisesta avainsanasta.

Ranktracker tukee avainsanojen joukkotoimintoja.

Avainsanojen luontipäätepiste hyväksyy muodon ”sanat × hakukoneet”, jolloin yhdellä pyynnöllä voidaan luoda useita seurattavia avainsanayhdistelmiä.

Kuvittele esimerkiksi, että haluat seurata:

• 100 avainsanaa
• Yhdysvallat (tietokone)
• Yhdysvallat (mobiili)

Nämä asetukset voivat tuottaa 200 seurattavaa avainsanayhdistelmää ilman, että tarvitaan 200 erillistä asetuspyyntöä.

Joukko-operaatiot ovat erityisen hyödyllisiä seuraavissa tilanteissa:

• Toimistot
• Yritysten hakukoneoptimointi
• Suuret verkkokaupat
• Ohjelmoitu hakukoneoptimointi
• SaaS-SEO-alustat
• Suuret sisällöntuottajat

Ranktracker tukee myös avainsanojen joukkotunnistamista.

Lue kattava joukkotoimintojen opas:

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

SEO-kilpailijoiden seuranta

Sijoitukset ovat paljon hyödyllisempiä, kun niihin sisältyy kilpailutilanne.

Ranktracker-sovellusliittymän (API) avulla kilpailijoita voidaan hallita seurattavien verkkotunnusten suhteen.

Tämän ansiosta voit analysoida hakukoneiden suorituskykyäsi automaattisesti suhteessa kilpaileviin verkkosivustoihin.

Voit käyttää kilpailijatietoja seuraavien seurantaan:

• Mitkä kilpailijat ovat saamassa näkyvyyttä
• Mitkä sivustot ohittavat verkkotunnuksesi
• Muutokset jaetuissa avainsanaryhmissä
• Kilpailijoiden sijoitustrendit
• Suhteellinen näkyvyys hakutuloksissa
• Äänenvoimakkuuden muutokset

Mainostoimistoille tämä voi tulla osaksi automatisoitua asiakasraportointijärjestelmää.

Sen sijaan, että asiakasta verrataan manuaalisesti kilpailijoihin kuukausittain, asiaankuuluvat tiedot voidaan integroida suoraan raportointiprosessiin.

Pääsy historiallisiin sijoitustietoihin

Nykyiset sijoitukset kertovat vain siitä, mitä tällä hetkellä tapahtuu.

Historialliset sijoitustiedot osoittavat, mihin suuntaan SEO-suorituskyky on kehittymässä.

Ranktracker tarjoaa verkkotunnusten sijoitushistorian API:n kautta, jolloin kehittäjät voivat analysoida näkyvyyttä ajan mittaan.

Historiatietojen avulla voidaan selvittää:

• Sijoitusten nousut
• Sijoitusten heikkenemiset
• Näkyvyyden trendit
• Avainsanojen muutokset
• Muutokset SEO-kampanjoiden jälkeen
• Googlen päivityksen vaikutus
• Kampanjoiden pitkän aikavälin tulokset

Voit myös käyttää sijoitushistoriaa luodaksesi mukautettuja kaavioita ja hallintapaneeleita.

Esimerkiksi:

Ranktracker-API
       ↓
Päivittäisten sijoitustietojen kerääminen
       ↓
Tietovarasto
       ↓
Historiallinen SEO-tietojoukko
       ↓
Kojelauta / Hälytykset / Analyysi

Ranktracker tarjoaa erillisen oppaan, jossa näytetään, miten päivittäiset sijoitukset haetaan tietovarastoon:

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

Ranktracker-tietojen lähettäminen tietovarastoon

Yksi hyödyllisimmistä API-työnkuluista on Ranktracker-tietojen automaattinen tallentaminen omaan tietokantaan tai tietovarastoon.

Esimerkiksi sijoitustiedot voidaan lähettää:

• BigQuery
• Snowflake
• PostgreSQL
• MySQL
• Google Sheets
• Sisäiset analytiikkatietokannat

Nämä tiedot voidaan sitten yhdistää muihin liiketoimintatietoihin.

Esimerkiksi:

Ranktracker
     ↓
Ranktracker-API
     ↓
Tietovarasto
     ↓
Google Search Console
Analytics
Konversiot
Liikevaihto
CRM-tiedot
     ↓
Liiketoimintatiedon hallintapaneeli

Tämä luo paljon kattavamman kuvan SEO-suorituskyvystä.

Sen sijaan, että tietäisit vain, että avainsana nousi sijalta 8 sijalle 3, voisit analysoida, johti muutos myös seuraaviin seikkoihin:

• Lisää orgaanisia klikkauksia
• Lisää liidejä
• Korkeammat konversioprosentit
• Lisääntyneet tulot

The Rankings to Warehouse -opas esittelee esimerkin tällaisen prosessiketjun rakentamisesta.

Luo Share of Voice -raportteja

Ranktracker-sovellusliittymä tarjoaa myös Share of Voice -tietoja.

Share of Voice tarjoaa laajemman mittauksen siitä, kuinka näkyvä verkkotunnus on seurattujen avainsanojen joukossa.

Sen sijaan, että kysyisit:

Missä sijalla olemme tämän avainsanan osalta?

voit kysyä:

Kuinka näkyviä olemme koko hakumarkkinalla?

Tämä on erityisen tehokasta, kun mukaan otetaan kilpailijoiden tiedot.

Share of Voice -sovellusliittymää voidaan käyttää seuraavien analysointiin:

• Yleinen näkyvyytesi
• Kilpailijoiden näkyvyys
• Näkyvyyden muutokset ajan myötä
• Suhteellinen markkina-asema
• Näkyvyys pöytäkoneilla
• Mobiilinäkyvyys

Päätepiste tukee päivämäärävälejä ja laitesegmentointia, minkä ansiosta Share of Voice voidaan sisällyttää mukautettuihin SEO-raportteihin.

Täydellinen toteutusesimerkki on saatavilla täällä:

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

Järjestä avainsanat tunnisteiden avulla

Suuria avainsanaportfolioita on vaikea hallita ilman järjestystä.

Ranktracker tarjoaa tilitason tunnisteita, jotka voidaan liittää seurattaviin avainsanoihin.

Voit luoda tunnisteita esimerkiksi:

• Tuoteryhmät
• Hakutarkoitus
• Sijainnit
• Sisältötyypit
• Kampanjat
• Asiakkaat
• Myyntiputken vaiheet
• Liiketoimintayksiköt
• SEO-tiimit

Esimerkiksi:

"osta juoksukengät" → Kaupallinen
"parhaat juoksukengät" → Vertailu
"miten puhdistaa juoksukengät" → Tiedottava

Samoja tunnisteita voidaan käyttää uudelleen eri verkkotunnuksissa ja avainsanaryhmissä.

Ranktracker tarjoaa myös joukkotunnistuksen, joten suuria avainsanaryhmiä voidaan järjestellä ilman yksittäisiä pyyntöjä.

Erillinen opas on saatavilla täällä:

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

Seuraa tilin käyttöä ja kiintiötä

Automatisoitujen järjestelmien on myös ymmärrettävä käytettävissä olevat tiliresurssit.

Ranktracker-sovellusliittymä tarjoaa:

GET /v1/account/usage

Tämä päätepiste raportoi tilin käytön ja rajoitukset.

Nykyiset käyttötiedot voivat sisältää:

• API-käyttöoikeuksien tila
• Avainsanat
• Tietorivit
• Käyttö tarpeen mukaan
• SERP Analyser -käyttö

Jokainen kiintiö voi tarjota esimerkiksi seuraavia arvoja:

• Käyttö
• Raja
• Jäljellä

Tämän avulla sovellus voi tarkistaa käytettävissä olevan kapasiteetin ennen suuren toiminnon aloittamista.

Esimerkiksi ennen tuhansien avainsanojen tuontia järjestelmäsi voi kysyä tilin käyttöä ja selvittää, kuinka paljon kapasiteettia on jäljellä.

Lue koko opas:

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

Miten Ranktracker-API:n todennus toimii

Ranktracker REST API -pyynnöt todennetaan API-avaimella.

Voit luoda ja hallita avaimia suoraan Ranktrackerissa:

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

API-avainta tulee aina käsitellä kuin salasanaa.

Tuotantoympäristön API:n perus-URL on:

https://api.ranktracker.com

API-resurssit sijaitsevat /v1 -polun alla.

Esimerkiksi:

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

API-avain lähetetään suoraan Authorization -otsikossa.

Tavallisissa REST-API-pyynnöissä ei ole Bearer -etuliitettä.

Esimerkki:

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

Ranktracker-API-avain tulee säilyttää palvelinpuolella, eikä sitä saa koskaan paljastaa seuraavien kautta:

• Selaimen JavaScript
• Front-end-lähdekoodi
• Julkiset arkistot
• Mobiilisovelluksen koodi
• Julkiset konfiguraatiotiedostot

Lisätietoja:

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

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

API-avainten luominen ja hallinta: https://app.ranktracker.com/account/api

API-resurssien rakenne

Ranktracker käyttää UUID-tunnisteita resurssien tunnistamiseen.

Tämä koskee esimerkiksi seuraavia resursseja:

• Verkkotunnukset
• Avainsanat
• Kilpailijat
• Tunnisteet

Yksinkertaistettu esitys näyttää tältä:

Tili
│
├── Käyttö
├── Tunnisteet
│
└── Verkkotunnukset
    │
    ├── Sijoitushistoria
    ├── Näkyvyysosuus
    ├── Kilpailijat
    │
    └── Avainsanat
        │
        ├── SERP
        ├── Välimuistissa oleva SERP-HTML
        └── Tunnisteet

Tämä tekee API-rakenteesta ennustettavan.

Verkkotunnuksella on avainsanoja ja kilpailijoita.

Avainsana kuuluu seurattavaan verkkotunnukseen, ja siihen liittyy SERP- ja sijoitustietoja.

Tunnisteet ovat tilitasolla, ja ne voidaan liittää avainsanoihin.

Lue lisää:

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

JSON-API-vastaukset

Ranktracker-vastaukset käyttävät yhdenmukaista JSON:API-tyylistä kehystä.

Resurssi palautetaan data-kohdassa, kun taas sen kentät tallennetaan attributes-kohdassa.

Esimerkiksi:

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

Kehittäjien tulisi myös olla tietoisia tärkeästä nimeämiskäytännöstä:

• API-vastauksissa käytetään camelCase-merkintätapaa
• Kirjoituspyyntöjen sisällössä käytetään snake_case-merkintätapaa

Vastaus voi esimerkiksi sisältää seuraavaa:

projectName

kun taas kirjoituspyynnössä käytetään:

project_name

Tätä käytäntöä sovelletaan koko API:ssa.

Katso:

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

Sivutus

Luettelopäätelaitteet on sivutettu, jotta sovellukset voivat toimia tehokkaasti suurten Ranktracker-tilien kanssa.

Sivutus koskee muun muassa seuraavia resursseja:

• Verkkotunnukset
• Avainsanat
• Kilpailijat
• Tunnisteet

Kaksi pääparametria ovat:

• sivu
• sivua_kohta

per_page tukee enintään 1 000 tietuetta sivua kohti.

Sivutustiedot palautetaan vastauksen otsikoissa, mukaan lukien:

• X-kokonaismäärä
• X-Sivujen kokonaismäärä
• X-sivukohtainen
• X-nykyinen sivu

Suurten vientien yhteydessä sovellukset voivat siten jatkaa sivujen pyytämistä, kunnes koko tietojoukko on haettu.

Lue sivutuksen opas:

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

Virheiden käsittely ja käyttörajoitukset

Ranktracker-sovellusliittymä käyttää tavallisia HTTP-tilakoodeja, jotta virheitä on helpompi käsitellä ohjelmoinnin avulla.

Yleisiä vastauksia ovat:

Tila	Merkitys	Esimerkki
400	Virheellinen pyyntö	Vaadittu parametri puuttuu tai on virheellinen
402	Kiintiö ylitetty	Pyydetty toiminto ylittäisi tilin kiintiön
403	Kielletty	Pyynnöllä ei ole valtuutusta tai API-käyttöoikeutta ei ole käytettävissä
404	Ei löydy	Resurssia ei ole tilillä
422	Vahvistusvirhe	Pyyntö on kelvollista JSON-muotoa, mutta sisältää virheellisiä tietoja
429	Liian monta pyyntöä	Integraatiolle on asetettu pyyntörajoitus

Kun 429-vastaus ilmenee, integraatioiden tulisi noudattaa palautettua Retry-After- tietoa ennen uuden yrityksen tekemistä.

Tämä mahdollistaa tuotantokäytössä olevien sovellusten käsitellä tilapäistä rajoitusta ilman, että ne yksinkertaisesti epäonnistuvat.

Täydellinen virhe- ja käyttörajoitusten dokumentaatio on saatavilla täällä:

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

Ranktracker REST API vs. MCP

REST-rajapinta ei ole ainoa tapa yhdistää ulkoista ohjelmistoa Ranktrackeriin.

Ranktracker tarjoaa myös isännöidyn MCP-palvelimen.

MCP tarkoittaa Model Context Protocolia, ja sen avulla yhteensopivat tekoälysovellukset ja agentit voivat käsitellä Ranktrackerin tietoja suoraan.

Tähän kuuluvat esimerkiksi seuraavat yhteensopivat asiakasohjelmat:

• ChatGPT
• Claude
• Cursor
• Muut MCP-yhteensopivat tekoälysovellukset

REST ja MCP käyttävät samaa taustalla olevaa Ranktracker-tietokantaa, mutta ne on suunniteltu erilaisille työnkulkuille.

	Ranktracker REST API	Ranktracker MCP
Sopii parhaiten	Sovelluksiin, hallintapaneeleihin, tietovarastoihin ja ajoitettuihin tehtäviin	Tekoälyavustajat ja -agentit
Soittaja	Oma taustapalvelusi tai HTTP-asiakasohjelmasi	ChatGPT, Claude, Cursor tai muu MCP-asiakasohjelma
Rajapinta	REST-päätetiedot	MCP-työkalut
REST-polku	/v1/...	/mcp
Tyypillinen käyttö	SEO-tietojen automaattinen siirtäminen ja hallinta	SEO-tietojen tutkiminen keskustelumuodossa

Esimerkiksi REST on parempi valinta, jos haluat:

• Vie rankingit joka yö
• Päivitä BI-koontinäyttö
• Luo SEO-projekteja automaattisesti
• Lisää avainsanoja sovelluksestasi
• Synkronoi sijoitustiedot tietokantaan

MCP sopii paremmin esimerkiksi seuraavanlaisiin kysymyksiin:

Mitkä seuratuista avainsanoistani ovat laskeneet eniten tällä viikolla?

tai:

Mitkä kilpailijat ovat saaneet eniten näkyvyyttä?

Tekoälyasiakas voi valita sopivan Ranktracker-työkalun ja hakea tarvittavat tiedot.

Monet edistyneet SEO-tiimit voivat käyttää molempia.

REST huolehtii infrastruktuurista ja automaatiosta. MCP tarjoaa Ranktracker-tiedot tekoälyagenttien käyttöön.

Lisätietoja:

MCP:n yleiskatsaus: https://developers.ranktracker.com/mcp/

MCP-asiakkaan liittäminen: https://developers.ranktracker.com/mcp/connect/

MCP-työkalun ohjeet: https://developers.ranktracker.com/mcp/tools/

Mitä voit rakentaa Ranktracker-sovellusliittymän avulla?

Ranktracker-sovellusliittymää voidaan käyttää paljon muuhunkin kuin avainsanojen sijoitusten näyttämiseen.

Tässä on joitakin hyödyllisimpiä sovelluksia.

Automatisoitu SEO-raportointi

Mainostoimisto voi hakea sijoitustiedot automaattisesti omaan raportointialustaansa.

Sen sijaan, että:

Avaa Ranktracker
↓
Vie CSV-tiedosto
↓
Muokkaa taulukkoa
↓
Lataa raportti
↓
Lähetä asiakkaalle

voit rakentaa:

Ranktracker-sovellusliittymä
↓
Raportointialusta
↓
Automaattisesti päivitettävä asiakasraportti

Tämä on erityisen arvokasta toimistoille, jotka hallinnoivat suurta määrää asiakkaita.

Räätälöidyt SEO-koontinäytöt

Yrityksesi saattaa jo käyttää sisäistä raportointi- tai liiketoimintatiedon hallinta-alustaa.

API:n avulla Ranktracker-tiedot voidaan liittää kyseisen ympäristön toiseksi tietolähteeksi.

Voit luoda hallintapaneeleita, jotka näyttävät:

• Avainsanojen sijoitukset
• Sijoitusten muutokset
• Kolme suosituinta avainsanaa
• 10 suosituinta avainsanaa
• 100 suosituinta avainsanaa
• Äänen osuus
• Kilpailijoiden näkyvyys
• SERP-ominaisuudet
• AI-yleiskatsauksen esiintymiset

Tuloksena oleva hallintapaneeli voidaan räätälöidä nimenomaan yrityksesi raportointitarpeisiin.

Automatisoitu asiakkaan käyttöönotto

SEO-toimistot voivat integroida Ranktrackerin asiakkaan perehdyttämisprosessiin.

Esimerkiksi:

Asiakas ostaa SEO-paketin
↓
CRM luo asiakastiedot
↓
Ranktracker-API luo verkkotunnuksen
↓
Avainsanat lisätään
↓
Kilpailijat lisätään
↓
Seuranta alkaa

Tämä poistaa toistuvat manuaaliset projektin asetukset.

SEO-tietovarastot

Sijoitukset saavat lisää arvoa, kun ne yhdistetään muihin markkinointi- ja liiketoimintatietoihin.

Ranktracker-tietoja voidaan yhdistää seuraaviin:

• Google Search Console
• Analytiikka
• CRM-tiedot
• Konversiotiedot
• Verkkokaupan liikevaihto
• Liiditiedot
• Sisällön suorituskyky

Tämä voi auttaa vastaamaan paljon tärkeämpiin kysymyksiin kuin pelkkä sijoitusten tarkistaminen.

Esimerkiksi:

Mitkä sijoitusten parannukset tuottivat eniten liikevaihtoa?

tai:

Mitkä avainsanaryhmät lisäävät näkyvyyttä, mutta eivät tuota konversioita?

Sijoitushälytykset

Historialliset sijoitustiedot voivat myös toimia pohjana räätälöityille hälytysjärjestelmille.

Integraatio voisi tunnistaa automaattisesti, kun:

• Avainsana putoaa kolmen parhaan joukosta
• Sivu nousee kymmenen parhaan joukkoon
• Hakusana nousee 100 parhaan joukkoon
• Tärkeä avainsana katoaa 100 parhaan joukosta
• Kilpailija ohittaa verkkosivustosi
• Hakunäkyvyys laskee jyrkästi

Hälytykset voidaan sitten lähettää omaan sähköpostiisi, Slackiin, sisäiseen hallintapaneeliin tai seurantajärjestelmään.

Kilpailutiedustelu

Yhdistämällä:

• Sijoitukset
• Kilpailijoiden seuranta
• Sijoitushistoria
• Äänen osuus

luo perustan automatisoidulle kilpailijoiden SEO-seurantajärjestelmälle.

Sen sijaan, että kilpailijoita arvioitaisiin muutaman kuukauden välein, niiden näkyvyys hakukoneissa voi muuttua jatkuvasti seurattavaksi mittariksi.

Ohjelmoitu SEO-seuranta

Ohjelmoitu hakukoneoptimointi voi tuottaa tuhansia tai satoja tuhansia aloitussivuja.

Näiden projektien manuaalinen seuranta on epärealistista.

Ranktracker-sovellusliittymän avulla kehittäjät voivat rakentaa sijoitustyönkulkuja, jotka pystyvät käsittelemään suuria avainsanajoukkoja ja siirtämään tuloksena saadut tiedot automaattisesti sisäisiin analytiikkajärjestelmiin.

Tekoälypohjainen SEO-analyysi

Ranktrackerin REST-sovellusliittymä ja MCP-palvelin voivat myös olla osa tekoälypohjaisia SEO-työnkulkuja.

Esimerkiksi tekoälyjärjestelmät voivat auttaa seuraavissa asioissa:

• Tunnista sijoitusten lasku
• Yhteenveto sijoitusten muutoksista
• Löydä nopeasti parantuvat avainsanat
• Kilpailijoiden näkyvyyden vertailu
• Analysoi SERP-muutokset
• Priorisoi SEO-mahdollisuudet
• Luo sisäisiä raportteja
• Tutki epätavallisia sijoitusten muutoksia

API tarjoaa jäsennellyt tiedot, kun taas tekoäly voi auttaa niiden tulkinnassa.

Kenelle Ranktracker-sovellusliittymä on tarkoitettu?

Ranktracker-API on erityisen hyödyllinen seuraavissa tilanteissa:

• SEO-toimistot
• Yritysten SEO-tiimit
• SaaS-yritykset
• SEO-ohjelmistoyritykset
• Kehittäjät
• Data-insinöörit
• BI-tiimit
• Verkkokauppayritykset
• Affiliate-markkinoijat
• Julkaisijat
• Useilla toimipaikoilla toimivat yritykset
• Ohjelmoitu SEO-tiimit
• Tekoälyautomaatiotiimit

Jos sijoitustietoja on haettava, siirrettävä, analysoitava tai hallinnoitava automaattisesti, API on yleensä paljon skaalautuvampi ratkaisu kuin manuaaliset vientitoiminnot.

Miksi käyttää Ranktrackeria oman sijoitusten seuranta-infrastruktuurin rakentamisen sijaan?

Hakusijoitusten kerääminen laajassa mittakaavassa vaatii paljon enemmän kuin pelkkää Google-hakua.

Tuotantokäytössä olevan sijoitusten seurantajärjestelmän on otettava huomioon seuraavat seikat:

• Toimipaikat
• Kielet
• Laitteet
• 100 parhaan tuloksen kokoelma
• SERP-ominaisuudet
• Tekoälyn yleiskatsaukset
• Avainsanojen määrittely
• Historialliset sijoitustiedot
• Kilpailijat
• Aikataulutus
• Hakutulosten muutokset
• Tietojen tallennus
• Raportointi

Kaiken tämän infrastruktuurin rakentaminen ja ylläpito sisäisesti voi vaatia huomattavia kehitysresursseja.

Ranktracker hoitaa sijoitusten seurannan infrastruktuurin ja tarjoaa tuloksena saadut tiedot jäsennellyn sovellusrajapinnan (API) kautta.

Kehittäjät voivat siten keskittyä rakentamaan sovellusta, hallintapaneelia, työnkulkua tai analyysia, jota yrityksesi todella tarvitsee.

Kuinka pääset alkuun Ranktracker-API:n kanssa

Aloittaminen vaatii vain muutaman vaiheen.

1. Avaa API-asetukset

Siirry suoraan osoitteeseen:

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

Luo API-avain ja säilytä se turvallisesti.

2. Lue pikaopas

Seuraa virallista pikaopasta:

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

3. Tee ensimmäinen pyyntösi

Esimerkiksi:

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

4. Tutustu API-viitteeseen

Täydellinen REST-API-ohje on saatavilla täällä:

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

5. Aloita rakentaminen

Sieltä voit aloittaa Ranktrackerin yhdistämisen:

• Sovelluksesi
• Raportointijärjestelmäsi
• Tietovarastosi
• CRM-järjestelmäsi
• Sisäiset työkalusi
• Tekoälytyönkulut

Ranktracker-API-dokumentaatio

Kattava kehittäjädokumentaatio löytyy osoitteesta:

Kehittäjän dokumentaatio: https://developers.ranktracker.com/

API-avainten luominen ja hallinta: https://app.ranktracker.com/account/api

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

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

Peruskäsitteet: https://developers.ranktracker.com/guides/concepts/

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

Virheet ja käyttörajoitukset: https://developers.ranktracker.com/guides/errors-and-rate-limits/

Käyttö ja kiintiöt: https://developers.ranktracker.com/guides/usage-and-quota/

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

Opetusohjelma verkkotunnuksen seurannasta: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Opas sijoitusten siirtämisestä varastoon: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

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

Merkintöjen joukkokäsittelyopas: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

REST-sovellusliittymän viite: https://developers.ranktracker.com/rest-api/

MCP-palvelin: https://developers.ranktracker.com/mcp/

MCP-asiakkaan yhdistäminen: https://developers.ranktracker.com/mcp/connect/

MCP-työkalun ohjeet: https://developers.ranktracker.com/mcp/tools/

Aloita kehittäminen Ranktracker-sovellusliittymän avulla

Ranktracker-API muuttaa Ranktrackerin SEO-hallintapaneelista infrastruktuuriksi, joka voidaan sijoittaa suoraan teknologiapinoosi.

Voit käyttää sitä verkkotunnusten ja avainsanojen hallintaan, kilpailijoiden seurantaan, 100 parhaan sijoituksen hakemiseen, SERP-tulosten analysointiin, AI-yleiskatsausten tunnistamiseen, Share of Voice -osuuden seurantaan, historiallisten sijoitustietojen tarkasteluun, avainsanojen järjestämiseen, raportointiprosessien rakentamiseen sekä SEO-tietojen integroimiseen muuhun liiketoimintaasi.

Kehittäjille se poistaa tarpeen viedä ja siirtää sijoitustietoja manuaalisesti.

Mainostoimistoille se mahdollistaa laajamittaisen asiakaspalvelun automatisoinnin.

Yritysten SEO-tiimeille se mahdollistaa sijoitustietojen sisällyttämisen osaksi sisäistä analytiikkaa ja datainfrastruktuuria.

Ranktrackerin MCP-palvelimen avulla samat taustalla olevat SEO-tiedot voidaan myös asettaa tekoälyavustajien ja -agenttien saataville.

Luo Ranktracker-API-avain: https://app.ranktracker.com/account/api

Lue ohjeet: https://developers.ranktracker.com/

Tutustu REST-API-viitteeseen: https://developers.ranktracker.com/rest-api/