Miksi käyttää GEO-Score-API:a?
Vaikka GEO-Score-koontinäyttö on tehokas manuaaliseen analyysiin, API avaa automaation laajassa mittakaavassa. Integroi GEO-analyysi suoraan sisällönhallintajärjestelmääsi, CI/CD-putkeesi tai mukautettuihin raportointityökaluihisi seurataksesi tekoälyhakunäkyvyyttä koko verkkosivustollasi automaattisesti.
Olitpa yksittäinen kehittäjä automatisoimassa omaa työnkulkuasi tai toimisto, joka hallinnoi satoja asiakassivustoja, API antaa sinulle ohjelmallisen pääsyn jokaiseen koontinäytössä saatavilla olevaan ominaisuuteen ja paljon muuhun.
API:n yleiskatsaus
GEO-Score-API noudattaa RESTful-konventioita JSON-pyyntö- ja vastausrungoilla. Kaikki päätepisteet vaativat todennuksen API-avaimella ja palauttavat johdonmukaisia vastausrakenteita.
Perus-URL
Vastausmuoto
Kaikki API-vastaukset noudattavat johdonmukaista JSON-rakennetta tilakoodein ja sisäkkäisin tieto-objektein:
Todennus
Jokaisen API-pyynnön on sisällettävä API-avaimesi Authorization-otsakkeessa. API-avaimet on rajattu tilillesi ja niitä voidaan hallita koontinäytön asetuksista.
API-avaimesi hankkiminen
Siirry kohtaan Koontinäyttö > Asetukset > API-avaimet luodaksesi uuden avaimen. Voit luoda useita avaimia eri oikeuksin eri integraatioille. Jokainen avain voidaan kumota erikseen vaikuttamatta muihin.
API-avaimesi käyttäminen
Sisällytä API-avaimesi Bearer-tokenina jokaisen pyynnön Authorization-otsakkeessa:
Saatavilla olevat päätepisteet
GEO-Score-API tarjoaa päätepisteet URL-osoitteiden lähettämiseen analyysiin, tulosten hakemiseen, uudelleenanalyysien laukaisemiseen ja useiden URL-osoitteiden vertailuun. Tässä yhteenveto kaikista saatavilla olevista päätepisteistä:
Hae sivutettu lista kaikista analysoiduista URL-osoitteista tililläsi.
Hae tietyn URL-osoitteen täydet analyysitulokset sen yksilöllisellä tunnuksella.
Lähetä uusi URL GEO-analyysiin. Palauttaa analyysin tunnuksen tulosten kyselyä varten.
Käynnistä aiemmin analysoidun URL-osoitteen tuore uudelleenanalyysi.
Vertaile GEO-pisteitä ja tekijöiden erittelyjä useiden URL-osoitteiden välillä rinnakkain.
Koodi-esimerkit
Aloita nopeasti näillä valmiilla koodi-esimerkeillä suosituilla ohjelmointikielillä. Kopioi, liitä ja mukauta erityiseen käyttötapaukseesi.
JavaScript (Node.js)
Python
PHP
Webhookit
Webhookit sallivat GEO-Scoren lähettää reaaliaikaisia ilmoituksia palvelimellesi aina kun tärkeitä tapahtumia tapahtuu. Sen sijaan, että kysyisit API:lta päivityksiä, määritä webhook-URL ja vastaanota välittömät takaisinsoitot.
Webhookien asettaminen
Määritä webhook-päätepisteesi kohdassa Koontinäyttö > Asetukset > Webhookit. Voit valita, mitkä tapahtumat laukaisevat ilmoituksia, ja asettaa mukautetun allekirjoitussalaisuuden hyötykuorman todentamiseen.
analysis.complete
Laukaistaan, kun URL-analyysi viimeistelee käsittelyn ja tulokset ovat saatavilla.
score.changed
Laukaistaan, kun uudelleenanalysoitu URL näyttää merkittävän GEO-pistemäärän muutoksen (delta > 5 pistettä).
report.generated
Laukaistaan, kun aikataulutettu tai pyydetty raportti on valmis ladattavaksi.
url.added
Laukaistaan, kun uusi URL lisätään tilillesi seurantaa varten.
Esimerkki webhookin hyötykuormasta
Automaatioideoita
Analysoi automaattisesti jokainen uusi blogikirjoitus, joka julkaistaan CMS:ssäsi ennen kuin se menee live
Aseta Slack-ilmoitukset, kun mikä tahansa seurattu URL putoaa GEO-pistemäärän kynnyksen alle
Luo viikoittaiset PDF-raportit ja lähetä ne sähköpostilla asiakkaillesi tai sidosryhmillesi
Rakenna mukautettu koontinäyttö, joka yhdistää GEO-pistemäärätietosi analyysialustasi kanssa
Käynnistä uudelleenanalyysi sisältöpäivitysten jälkeen mitataksesi optimointiesi vaikutusta
Luo julkaisua edeltävä tarkistuslista, joka vaatii vähimmäis-GEO-pistemäärän ennen sisällön julkaisemista
Kolmannen osapuolen integraatiot
GEO-Score integroituu suosittuihin työkaluihin ja alustoihin sopiakseen saumattomasti olemassa olevaan työnkulkuusi. Käytä natiivi-integraatioitamme tai rakenna omasi API:n avulla.
Zapier
Yhdistä GEO-Score yli 5 000 sovellukseen. Käynnistä Zapeja analyysin valmistumisen, pistemäärämuutosten tai uusien tilillesi lisättyjen URL-osoitteiden yhteydessä.
WordPress
Asenna GEO-Score-laajennus analysoidaksesi sivuja suoraan WordPress-editorista. Näe reaaliaikaiset GEO-pisteet kirjoittaessasi ja julkaistessasi.
Slack
Vastaanota välittömät Slack-ilmoitukset pistemäärämuutoksista, valmistuneista analyyseistä ja viikoittaisista yhteenvetoraporteista valitsemallasi kanavalla.
Google Sheets
Synkronoi automaattisesti GEO-pistemäärätiedot Google Sheetsiin mukautettua raportointia, trendianalyysiä ja helppoa jakamista varten tiimisi kanssa.
HubSpot
Rikasta HubSpot-sisältöstrategiaasi GEO-pistemäärätiedoilla. Seuraa tekoälynäkyvyyttä olemassa olevien markkinointimittariesi rinnalla.
Google Analytics
Korreloi GEO-pistemäärän parannukset orgaanisen liikenteen muutoksiin. Näe miten tekoälyhakuoptimointi vaikuttaa tosielämän liikenteeseesi.
Pyyntörajat
API:n pyyntörajat ovat tilikohtaisia ja jaettu kaikkien pakettien kesken, ilmaisesta tasosta 29,99 €/kk Rajattomaan tilaukseen. Rajan ylittävät pyynnöt saavat 429-vastauksen Retry-After-otsakkeella, joka ilmoittaa, milloin voit jatkaa.
Pyyntörajat nollautuvat liukuvalla tunnin ikkunalla. Ota yhteyttä tukeen, jos tarvitset korkeampia rajoja.
Seuraavat vaiheet
Valmis aloittamaan? Luo API-avaimesi koontinäytön asetussivulta ja kokeile yllä olevia koodi-esimerkkejä. API-dokumentaatiomme sisältää yksityiskohtaiset pyyntö- ja vastausrakenteet jokaiselle päätepisteelle.
Edistyneisiin käyttötapauksiin tutustu webhook-järjestelmäämme tapahtumapohjaisten integraatioiden rakentamiseen. Käytä POST /urls -päätepistettä lähettääksesi sivuja analyysiin ja GET /urls/:id -päätepistettä yksityiskohtaisten tulosten hakemiseen.