API-integraatiot & kehittäjäopas | GEO-Score by Bloffee

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

https://api.bloffee.com/v1

Vastausmuoto

Kaikki API-vastaukset noudattavat johdonmukaista JSON-rakennetta tilakoodein ja sisäkkäisin tieto-objektein:

{
  "status": "success",
  "data": {
    "url": "https://example.com/page",
    "geoScore": 85,
    "factors": {...}
  }
}

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.

Authorization: Bearer YOUR_API_KEY_HERE

API-avaimesi käyttäminen

Sisällytä API-avaimesi Bearer-tokenina jokaisen pyynnön Authorization-otsakkeessa:

curl -X GET \
  https://api.bloffee.com/v1/urls \
  -H "Authorization: Bearer YOUR_API_KEY"

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ä:

GET/urls

Hae sivutettu lista kaikista analysoiduista URL-osoitteista tililläsi.

GET https://api.bloffee.com/v1/urls?page=1&limit=50

GET/urls/:id

Hae tietyn URL-osoitteen täydet analyysitulokset sen yksilöllisellä tunnuksella.

GET https://api.bloffee.com/v1/urls/abc123

POST/urls

Lähetä uusi URL GEO-analyysiin. Palauttaa analyysin tunnuksen tulosten kyselyä varten.

POST https://api.bloffee.com/v1/urls

PUT/urls/:id/refresh

Käynnistä aiemmin analysoidun URL-osoitteen tuore uudelleenanalyysi.

PUT https://api.bloffee.com/v1/urls/abc123/refresh

GET/compare

Vertaile GEO-pisteitä ja tekijöiden erittelyjä useiden URL-osoitteiden välillä rinnakkain.

GET https://api.bloffee.com/v1/compare?urls=id1,id2,id3

Koodi-esimerkit

Aloita nopeasti näillä valmiilla koodi-esimerkeillä suosituilla ohjelmointikielillä. Kopioi, liitä ja mukauta erityiseen käyttötapaukseesi.

JavaScript (Node.js)

const fetch = require('node-fetch');

const analyzeURL = async (url) => {
  const response = await fetch('https://api.bloffee.com/v1/urls', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ url })
  });

  const data = await response.json();
  console.log('GEO Score:', data.data.geoScore);
  return data;
};

analyzeURL('https://example.com/my-page');

Python

import requests

def analyze_url(url):
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }

    response = requests.post(
        'https://api.bloffee.com/v1/urls',
        headers=headers,
        json={'url': url}
    )

    data = response.json()
    print(f"GEO Score: {data['data']['geoScore']}")
    return data

analyze_url('https://example.com/my-page')

PHP

<?php
$url = 'https://example.com/my-page';

$data = array('url' => $url);
$options = array(
    'http' => array(
        'header'  => "Authorization: Bearer YOUR_API_KEY
" .
                     "Content-Type: application/json
",
        'method'  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents(
    'https://api.bloffee.com/v1/urls',
    false,
    $context
);

$response = json_decode($result, true);
echo "GEO Score: " . $response['data']['geoScore'];
?>

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

{
  "event": "analysis.complete",
  "timestamp": "2025-01-10T12:00:00Z",
  "data": {
    "url_id": "abc123",
    "url": "https://example.com/page",
    "geoScore": 85,
    "previousScore": 78,
    "factors": {
      "readability": 90,
      "comprehensiveness": 82,
      "aiOptimization": 85
    }
  }
}

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 perustuvat tilaukseesi. Rajan ylittävät pyynnöt saavat 429-vastauksen Retry-After-otsakkeella, joka ilmoittaa, milloin voit jatkaa.

Starter

100

pyyntöä tunnissa

Pro

1,000

pyyntöä tunnissa

Enterprise

Mukautettu

ota yhteyttä saadaksesi rajat

Pyyntörajat nollautuvat liukuvalla tunnin ikkunalla. Ryöppypyynnöt jopa 2x tuntirajaasi sallitaan lyhyiksi ajoiksi. 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.