Bing Webmaster Tools API: data, päätepisteet ja rajat

Mikä on Bing Webmaster Tools API?

Bing Webmaster Tools API on Microsoftin ohjelmallinen rajapinta Bing Webmaster Toolsin dataan sivustoille, jotka olet lisännyt ja vahvistanut. Se palauttaa hakusuorituskyvyn (napsautukset, näyttökerrat, sijainti), avainsanatilastot, saapuvien linkkien määrät, skannaustiedot ja URL-osoitteiden tilan, ja se ottaa vastaan URL-osoitteiden ja sivustokarttojen lähetyksiä.

Google Search Console kuvaa näkyvyyttäsi vain Googlessa. Bing tuo mukaan toisen hakukoneen näkymän: eri kyselyt, sijoitukset, skannauskäyttäytymisen ja linkit. Sillä on merkitystä, kun sivu toimii normaalisti yhdessä hakukoneessa ja huonosti toisessa. Vertailu ei todista, miksi sijoitukset eroavat, mutta se kertoo, mistä kannattaa aloittaa.

Microsoft dokumentoi API:n Microsoft Learnissa, ja .NET-viitteessä on lueteltu jokainen menetelmä IWebmasterApi-rajapinnassa. Älä sekoita sitä Bingin Search API -rajapintoihin kehittäjille, jotka ovat erillinen tuote erilaisine avaimineen.

Mitä dataa Bing Webmaster API:sta saa?

API kattaa kuusi aluetta: sivustot, hakusuorituskyky, avainsanat, linkit, skannauksen ja URL-lähetyksen. Alla olevat menetelmien nimet ovat Microsoftin rajapintaviitteestä. Saatavuus ja tulosten muoto vaihtelevat menetelmän ja sen mukaan, kuinka äskettäin sivusto on vahvistettu.

Kolme käytännön huomiota suorituskykymenetelmistä. GetQueryStats ja GetPageStats ottavat vain sivuston URL-osoitteen ilman aikaväli- tai rivimääräparametria, joten saat sen jakson, jonka Bing säilyttää, ja suodatat sen itse. Rakeisuus voi olla joissain raporteissa karkeampi kuin päivätaso, joten tarkista päivämäärät, ennen kuin oletat rivien olevan päiväkohtaisia. Ja vastikään vahvistettu sivusto voi palauttaa vähän tai ei mitään usean päivän ajan.

Avainsana- ja linkkiluvut eivät ole vaihdettavissa Googlen lukujen kanssa. Älä pidä Bingin avainsanamittareita Google Search Consolen kyselyjen näyttökertoina äläkä Bingin linkkiraporttia täydellisenä linkkiluettelona.

Miten saat pääsyn Bing Webmaster API:in?

Lisäät ja vahvistat sivustosi Bing Webmaster Toolsissa ja todennat sitten joko API-avaimella tai OAuth 2.0:lla. Microsoft listaa pääsysivunsa mukaan OAuth 2.0:n suositeltuna reittinä ja API-avaimen vaihtoehtona.

1. Avaa Bing Webmaster Tools ja lisää sivustosi. Jos se on jo vahvistettu Google Search Consolessa, voit tuoda sen. Bingin tuontiohjeistus selittää kulun. Muussa tapauksessa vahvista XML-tiedostolla, meta-tagilla tai DNS-tietueella.
2. API-avainta varten avaa Settings, sitten API Access, ja luo se. Microsoftin dokumentaation mukaan käyttäjää kohti voi luoda vain yhden avaimen.
3. OAuth 2.0:aa varten rekisteröi asiakas, ohjaa käyttäjä authorize-päätepisteeseen, vaihda palautettu koodi token-päätepisteessä (koodi on lyhytikäinen, noin viisi minuuttia) ja lähetä pääsytunnus Bearer-otsakkeessa. Tallenna uusin päivitystunnus (refresh token) jokaisen päivityksen jälkeen.
4. Kutsu JSON-päätepisteitä, esimerkiksi https://ssl.bing.com/webmaster/api.svc/json/GetUserSites?apikey=YOUR_API_KEY. API-avain välitetään kyselyparametrina, joten se voi päätyä palvelin- ja välityspalvelinlokeihin.
5. Säilytä avainta salaisuuksien hallinnassa tai luotetun työkalun yhteysasetuksissa, älä koskaan tekoälychatin kehotteessa tai repositoriossa.

Varoitus OAuthista: Microsoft Q&A -keskustelu lokakuun 2026 puolivälistä kertoo Webmaster API -kutsujen hylkäämisestä invalid-token-virheellä, vaikka tunnuksia myönnetään. Emme löytäneet virallista tilailmoitusta, joten käsittele sitä vahvistamattomana yhteisön raporttina. Jos törmäät siihen, API-avain on dokumentoitu vaihtoehto.

Mitä tapahtui SOAP- ja POX-rajapinnoille?

Microsoft sulki Webmaster API:n vanhat SOAP- ja POX/HTTP-versiot 31. elokuuta 2026. JSON/HTTP-versio jatkaa, ja Microsoft ilmoittaa, että kaikki menetelmät ovat edelleen käytettävissä identtisellä toiminnallisuudella. Katso Bing Webmaster Tools API Services.

Jos sinulla on vanhaa koodia, etsi koodikannastasi merkkijonoa api.svc. Jokainen URL-osoite, joka sisältää /soap/ tai /pox/, on vaikutuksen alainen ja epäonnistuu. POX-kutsujille muutos on yleensä pieni: vaihda polun osa pox osaan json ja jäsennä JSON XML:n sijaan. SOAP-asiakkaat vaativat enemmän työtä, koska generoitu palveluviittaus katoaa päätepisteen mukana. Älä kopioi vanhoja koodiesimerkkejä tarkistamatta, mitä protokollaa ne kutsuvat.

JSON-päätepisteitä voi kutsua GET- tai POST-pyynnöllä. Havainnollistava eräkutsu näyttää tältä (korvaa avain ja URL-osoitteet, äläkä vie avainta versionhallintaan):

curl --request POST \
  "https://ssl.bing.com/webmaster/api.svc/json/SubmitUrlBatch?apikey=YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"siteUrl":"https://example.com","urlList":["https://example.com/new-post"]}'

Mitkä ovat Bing Webmaster API:n rajat?

Microsoft julkaisee tarkan päiväluvun URL-lähetykselle mutta vain vähän lukuja raportointimenetelmille. Lokakuun 2026 tilanteessa suhtaudu varauksella kaikkiin kovakoodattuihin rajoihin ja lue todellinen arvo ajon aikana.

Eräs kehittäjä mittasi uudella sivustolla ensimmäiseksi kiintiöksi 100 URL-osoitetta päivässä. Se on yksi raportti, ei sääntö, mutta se näyttää, miksi kannattaa kutsua GetUrlSubmissionQuota ensin ja käsitellä loppuun käytetty kiintiö sulavasti. Tyhjä URL-lista voi palauttaa HTTP-virheen, mikä voi kaataa ajastetun työn, kun kiintiö on käytetty.

Bingin ohjesivut voivat olla tuotetta jäljessä. Eräässä tuoreessa oppaassa todetaan, että ohjesivu kuvaa yhä kuuden kuukauden dataa, vaikka raportti tarjosi jopa 24 kuukautta, joten luota siihen, mitä oman tilisi raportti näyttää.

Miten URL-lähetys ja IndexNow eroavat?

URL Submission API lähettää URL-osoitteet vain Bingille, kun taas IndexNow on avoin protokolla, joka ilmoittaa mukana oleville hakukoneille kerralla. Bingin ohjesivun mukaan Bing suosittelee rutiinilähetyksiin IndexNow-protokollaa ja varoittaa, että vanhempi API voidaan poistaa käytöstä, kun IndexNow yleistyy.

IndexNow-protokollaa varten luot avaimen (8–128 kirjainta, numeroa tai viivaa), isännöit sen UTF-8-tekstitiedostona verkkotunnuksesi juuressa ja lähetät sitten muuttuneet URL-osoitteet jaettuun päätepisteeseen tai Bingin omaan. Katso Bingin IndexNow-aloitussivu ja IndexNow-dokumentaatio. Mukana olevien hakukoneiden lista muuttuu, joten tarkista se, ennen kuin oletat tietyn hakukoneen kuuluvan joukkoon.

Molemmat menetelmät auttavat vain löytämisessä. Ne eivät takaa skannausta, indeksointia tai sijoitusta. Luotettava rutiini tavalliselle päivitykselle on:

1. Julkaise vakaa, skannattava sivu, joka palauttaa oikean HTTP-tilan.
2. Sisällytä se XML-sivustokarttaasi ja linkitä siihen asiaankuuluvilta sivuilta.
3. Lähetä muutosilmoitus IndexNow-protokollan tai lähetys-API:n kautta.
4. Tarkista URL-osoitteen tila myöhemmin kutsulla GetUrlInfo tai käyttöliittymästä; älä lähetä sitä toistuvasti todellisen ongelman korjaamisen sijaan.

Googlen Search Console API ei ota vastaan mielivaltaisia indeksointipyyntöjä tavallisille sivuille, kuten selitämme Search Console API -oppaassamme. Vastikään julkaistut sivut, jotka Google ilmoittaa indeksoimattomiksi, käsitellään artikkelissa Search Console ilmoittaa ”ei indeksoitu”: mitä sitten?.

Mikä on Bingin AI Performance -raportti?

AI Performance on Bing Webmaster Toolsin raportti, joka julkaistiin julkisena esikatseluna helmikuussa 2026 ja joka näyttää, kuinka usein sivujasi siteerataan lähteinä Microsoft Copilotissa, Bingin tekoälytiivistelmissä ja valikoiduissa kumppani-integraatioissa. Se mittaa viittauksia, ei liikennettä.

Bingin ilmoituksen ja ohjesivun mukaan se raportoi viittaukset yhteensä, päivittäin siteerattujen yksittäisten sivujen keskimääräisen määrän, sivukohtaiset viittausmäärät ja grounding queries -kyselyt. Grounding queries ovat ilmauksia, joilla tekoäly haki sisältöä, jota se sitten siteerasi. Ne ovat otos, eivätkä ne ole sitä, mitä ihminen kirjoitti. Kesäkuun 2026 päivitys lisäsi esikatseluominaisuudet Intents, Topics, Citation Share ja Compare.

Rajoista kannattaa tietää seuraavat asiat: se kattaa Microsoftin omat pinnat, ei ChatGPT:tä, Perplexityä, Googlen AI Overviews -ominaisuutta eikä Claudea; viittaus ei ole napsautus; emmekä löytäneet dokumentoitua API-menetelmää raportille. Liikennettä, jota tekoälyavustajat todella lähettävät sinulle, seurataan analytiikalla, kuten kuvataan oppaassa ChatGPT- ja Perplexity-liikenteen seuranta GA4:ssä.

Miten vertaat Bingin ja Googlen dataa?

Vertaa pientä joukkoa tärkeitä URL-osoitteita samalla täydellä aikavälillä, pidä kunkin hakukoneen luvut erillisissä sarakkeissa ja käsittele eroja tutkittavina kysymyksinä äläkä johtopäätöksinä.

Tässä kuvitteellinen työkirja (luvut on keksitty):

Älä järjestä mahdollisuuksia pelkkien Bingin ja Googlen suhdelukujen mukaan. Hakukoneilla on eri yleisöt, kyselymäärät ja laitejakaumat, ja korkea suhdeluku voi olla normaali teknisellä aihepiirillä. Perustellumpi työjärjestys:

1. Tarkista, että molemmat hakukoneet raportoivat saman kanonisen URL-osoitteen.
2. Varmista, että sivu on indeksoitu siellä, missä odotat.
3. Vertaa kyselyiden hakutarkoitusta; samankaltaiset avainsanat eivät aina ole vastaavia.
4. Tarkista näyttökerrat, ennen kuin tulkitset napsautuksia, sillä toisella hakukoneella voi yksinkertaisesti olla vähemmän volyymia.
5. Vertaa trendejä kahden tai useamman jakson yli, ei yksittäisen päivän poikkeamaa.
6. Käy läpi kilpailevat tulokset sekä sivun otsikko, sisältö ja sisäiset linkit.

Kolme vertailua kannattaa ajaa säännöllisesti:

• Näkyvyysaukot. Listaa sivut, joilla on merkittävästi Bing-näyttökertoja mutta vähän Google-aktiivisuutta, ja tarkista sijoitus, indeksointi, kyselykysyntä, maantiede ja laitteet.
• Laskut molemmissa hakukoneissa. Jos samat URL-osoitteet laskevat molemmissa, tarkastele saatavuutta, sisältömuutoksia, uudelleenohjauksia, robots-direktiivejä ja kilpailua. Jos laskee vain toinen, tarkastele hakukonekohtaista indeksointia ja sijoituksia. Pelkän Google-laskun osalta aloita Search Consolen liikenteen laskun tarkistuslistasta.
• Skannausvirheet ja uusi sisältö. Käytä skannaus- ja URL-tilatietoja nähdäksesi, onko Bing löytänyt uusimmat sivusi.

Miten tekoälyagentti voi käyttää Bing-dataa?

Agentti voi käyttää Bing-dataa vain liittimen kautta, joka tarjoaa Bingin, ja sen pitäisi nimetä jokaisen mittarin lähde sen sijaan, että se sekoittaisi Bingin ja Googlen hiljaa. Pelkkä Google-liitin ei voi rehellisesti tuottaa Bing-raporttia, vaikka kielimalli osaisi kuvata, miltä sellainen näyttäisi.

GSC Magicin sivustolla Bing-työkalujen joukossa mainitaan Bingin kyselyt ja sivujen suorituskyky, avainsanatutkimuksen avainsanatilastot, saapuvien linkkien määrät ja uusien sivujen IndexNow-lähetykset, ja sivusto kertoo, että jokainen paketti sisältää Googlen, Bingin ja GA4:n. Kirjautumisvaiheiden mukaan liität Bing-avaimen, jos käytät Bing Webmaster Toolsia, ja kirjoitustyökalut, kuten IndexNow-lähetys, ovat käytettävissä maksullisissa paketeissa, joissa tilin omistaja voi kytkeä ne pois kohdassa Settings. Lisätiedot ovat Bing Webmaster Tools MCP -sivulla. Käyttöönottoa varten katso oppaat Claudelle ja ChatGPT:lle.

Pyydä yksi rivi jokaista tärkeää URL-osoitetta kohti: Google-napsautukset, Bing-napsautukset, kummankin hakukoneen näyttökerrat, päivämäärät, indeksointitila, jos se on saatavilla, ja suositeltu seuraava tarkistus. Pidä spekulatiiviset syyt erillisessä sarakkeessa.

Milloin Bing-data ei ole vaivan arvoista?

Jätä Bing-lähtöinen analyysi väliin, kun Bing lähettää sivustollesi tuskin lainkaan liikennettä ja yleisösi painottuu Googleen, tai kun tarvitset vain nopean vastauksen yhdestä sivusta. Silloin Bingin verkkokäyttöliittymä on nopeampi kuin mikään API.

Älä käytä Bing-lukuja Google-sijoitusten ennustamiseen äläkä summaa tai keskiarvoista Bingin ja Googlen avainsana-arvioita. Bing on hyödyllisin löydettävyys- ja indeksointiongelmien havaitsemisessa, teknisillä tai B2B-aloilla, joilla Bingin osuus on suurempi, sekä tarkistuksena siihen, onko lasku hakukonekohtainen.

Mitä teet seuraavaksi?

Vahvista sivustosi Bing Webmaster Toolsissa, jos et ole vielä tehnyt sitä, luo API-avain ja tee yksi kutsu GetUserSites pääsyn varmistamiseksi. Korvaa kaikki SOAP- tai POX-koodi, lisää IndexNow julkaisuprosessiisi ja aja sitten yllä kuvattu 28 päivän vertailu kymmenelle tärkeimmälle sivullesi. Lisää analyysi-ideoita löydät oppaasta 25 käytännön SEO-kehotetta, ja jos haluat ajaa nämä tarkistukset tekoälyagentin kautta, katso Bing Webmaster Tools MCP -sivu.

Usein kysytyt kysymykset

Onko Bing Webmaster Tools API ilmainen?

Bing Webmaster Tools ja sen API ovat ilmaisia käyttää. Rajoja silti on: URL-lähetyksellä on päiväkiintiö, joka riippuu sivustostasi, ja Microsoft julkaisee raportointimenetelmistä vain vähän lukuja. API:n päälle rakennettu kolmannen osapuolen työkalu voi veloittaa oman maksunsa, joten tarkista kyseisen palveluntarjoajan hinnoittelu erikseen.

Miksi sivu sijoittuu Bingissä mutta ei Googlessa?

Kullakin hakukoneella on oma skannaajansa, indeksinsä, sijoitusjärjestelmänsä ja yleisönsä, joten erot ovat normaaleja. Mahdollisia syitä ovat indeksointitila, kyselykysyntä, kanonisen osoitteen valinta, sijainti ja laitejakauma. Yksittäinen avainsanavertailu ei erota syytä. Tarkista ensin indeksointi ja kanoniset URL-osoitteet molemmissa hakukoneissa ja vertaa sitten hakutarkoitusta, näyttökertoja ja trendejä usean jakson yli.

Voinko käyttää Bingin linkkidataa täydellisenä linkkiauditointina?

Et. Jokainen hakukone löytää ja tallentaa linkkejä eri tavalla, joten Bingin linkkiraportit kattavat vain linkit, jotka Bing on löytänyt. Käytä niitä yhtenä signaalina muiden lähteiden rinnalla. API tarjoaa sivukohtaiset linkkimäärät ja tietyn URL-osoitteen saapuvat linkit, mutta ei täydellistä luetteloa jokaisesta sivustoosi osoittavasta linkistä.

Ovatko Bingin avainsanaluvut samoja kuin Google Keyword Plannerin?

Eivät. Bingin avainsanatyökalu ja API:n avainsanamenetelmät käyttävät Bingin hakudataa ja eri menetelmiä kuin Googlen työkalut. Käsittele lukuja suhteellisina signaaleina Bingin kysynnästä, validoi ne omia näyttökertojasi vasten äläkä keskiarvoista tai summaa Bingin ja Googlen arvioita yhdeksi yleiseksi hakumääräksi.

Sulkiko Bing SOAP- ja POX-Webmaster-rajapinnat?

Kyllä. Microsoft sulki vanhat SOAP- ja POX/HTTP-Webmaster-rajapinnat 31. elokuuta 2026. JSON/HTTP-API säilyy samoilla menetelmillä Microsoftin mukaan. Jos koodisi kutsuu edelleen osoitteita api.svc/soap tai api.svc/pox, kutsut epäonnistuvat ja ne pitää siirtää polkuun api.svc/json.

Kuinka monta URL-osoitetta voin lähettää Bingille päivässä?

Bingin ohjesivun mukaan enintään 10 000 URL-osoitetta verkkotunnusta kohti päivässä, ja yksi eräpyyntö voi sisältää enintään 500 URL-osoitetta. Todellinen kiintiösi riippuu sivustostasi ja voi olla paljon pienempi, etenkin uusilla sivustoilla. Lue oma sallimasi kutsulla GetUrlSubmissionQuota. Bing suosittelee rutiinilähetyksiin myös IndexNow-protokollaa.

Voiko URL-osoitteen lähettäminen pakottaa Bingin sijoittamaan sen?

Ei. Lähetys, olipa se tehty API:n tai IndexNow-protokollan kautta, ilmoittaa Bingille vain, että URL-osoite on uusi tai muuttunut. Skannaus, indeksointi ja sijoitus ovat erillisiä vaiheita, ja lähetetty URL-osoite voidaan silti ohittaa tai sijoittaa huonosti. Korjaa todelliset ongelmat, kuten estetyt sivut tai heikko sisältö, sen sijaan että lähetät samaa URL-osoitetta toistuvasti.

Sisältääkö Bing Webmaster API AI Performance -datan?

Bingin AI Performance -raportti, joka julkaistiin julkisena esikatseluna helmikuussa 2026, näyttää, kuinka usein sivujasi siteerataan Microsoft Copilotin ja Bingin tekoälyvastauksissa. Emme löytäneet dokumentoitua API-menetelmää sille, joten käsittele sitä toistaiseksi käyttöliittymäraporttina ja tarkista Microsoft Learnista päivitykset, ennen kuin rakennat automaatiota.

Tee tämä GSC Magic -palvelulla

GSC Magic tarjoaa koko Bing Webmaster API:n sekä IndexNow-protokollan MCP-työkaluina Search Consolen rinnalla: lisätiedot Bing Webmaster Tools MCP -sivulla ja Google vs. Bing -vertailuraportissa.