API di Bing Webmaster Tools: dati, endpoint e limiti

Cos’è l’API di Bing Webmaster Tools?

L’API di Bing Webmaster Tools è l’interfaccia programmatica di Microsoft ai dati di Bing Webmaster Tools per i siti che hai aggiunto e verificato. Restituisce le prestazioni di ricerca (clic, impressioni, posizione), statistiche sulle keyword, conteggi dei link in entrata, informazioni sulla scansione e stato degli URL, e accetta l’invio di URL e sitemap.

Google Search Console descrive solo la tua visibilità su Google. Bing aggiunge la vista di un altro motore di ricerca: query, posizionamenti, comportamento di scansione e link diversi. Conta quando una pagina va normalmente su un motore e male sull’altro. Il confronto non dimostra perché i posizionamenti differiscono, ma ti dice dove guardare per prima cosa.

Microsoft documenta l’API su Microsoft Learn, con un riferimento .NET che elenca ogni metodo nell’interfaccia IWebmasterApi. Non confonderla con le Search API di Bing per sviluppatori, che sono un prodotto separato con chiavi diverse.

Quali dati puoi ottenere dall’API Webmaster di Bing?

L’API copre sei aree: siti, prestazioni di ricerca, keyword, link, scansione e invio di URL. I nomi dei metodi qui sotto vengono dal riferimento dell’interfaccia di Microsoft. Disponibilità e forma dei risultati variano in base al metodo e a quanto tempo fa è stato verificato il sito.

Tre punti pratici sui metodi di prestazioni. GetQueryStats e GetPageStats accettano solo l’URL del sito, senza intervallo di date né parametro di righe, quindi ricevi la finestra che Bing conserva e la filtri tu. Per alcuni report la granularità può essere meno fine di quella giornaliera, quindi controlla le date prima di dare per scontate righe giornaliere. E un sito appena verificato può restituire poco o nulla per diversi giorni.

I dati su keyword e link non sono intercambiabili con quelli di Google. Non trattare le metriche sulle keyword di Bing come impressioni delle query di Google Search Console e non considerare il report sui link di Bing un inventario completo dei link.

Come ottieni l’accesso all’API Webmaster di Bing?

Aggiungi e verifica il tuo sito in Bing Webmaster Tools, poi ti autentichi con una chiave API o con OAuth 2.0. Secondo la sua pagina sull’accesso, Microsoft indica OAuth 2.0 come via consigliata e la chiave API come alternativa.

1. Apri Bing Webmaster Tools e aggiungi il tuo sito. Se è già verificato in Google Search Console, puoi importarlo: il flusso è spiegato nell’annuncio di Bing sull’importazione. In alternativa verifica con un file XML, un meta tag o un record DNS.
2. Per una chiave API, apri Settings, poi API Access, e generala. La documentazione di Microsoft precisa che si può generare una sola chiave per utente.
3. Per OAuth 2.0, registra un client, manda l’utente all’endpoint di autorizzazione, scambia il codice restituito all’endpoint dei token (il codice dura poco, circa cinque minuti) e invia il token di accesso in un header Bearer. Dopo ogni rinnovo, conserva il refresh token più recente.
4. Chiama gli endpoint JSON, per esempio https://ssl.bing.com/webmaster/api.svc/json/GetUserSites?apikey=YOUR_API_KEY. La chiave API viene passata come parametro di query, quindi può finire nei log del server e dei proxy.
5. Tieni la chiave in un gestore di segreti o nelle impostazioni di connessione di uno strumento fidato, mai nel prompt di una chat con l’AI né in un repository.

Un’avvertenza su OAuth: una discussione su Microsoft Q&A di metà ottobre 2026 segnala chiamate all’API Webmaster rifiutate con un errore di token non valido, nonostante i token vengano emessi. Non abbiamo trovato alcun avviso di stato ufficiale, quindi considerala una segnalazione della community non confermata. Se la incontri, la chiave API è l’alternativa documentata.

Che fine hanno fatto le API SOAP e POX?

Microsoft ha dismesso le versioni legacy SOAP e POX/HTTP dell’API Webmaster il 31 agosto 2026. La versione JSON/HTTP continua, e Microsoft dichiara che tutti i metodi restano disponibili con funzionalità identiche. Vedi Bing Webmaster Tools API Services.

Se hai codice più vecchio, cerca nel tuo codebase la stringa api.svc. Qualsiasi URL che contenga /soap/ o /pox/ è interessato e fallirà. Per chi chiamava POX la modifica di solito è piccola: cambia il segmento di percorso da pox a json e interpreta JSON invece di XML. I client SOAP richiedono più lavoro, perché il riferimento al servizio generato sparisce insieme all’endpoint. Non copiare vecchi esempi di codice senza controllare quale protocollo chiamano.

Gli endpoint JSON si possono chiamare con GET o POST. Un invio in batch a titolo illustrativo si presenta così (sostituisci chiave e URL, e non fare commit della chiave):

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"]}'

Quali sono i limiti dell’API Webmaster di Bing?

Microsoft pubblica un numero giornaliero preciso per l’invio di URL, ma pochi dati per i metodi di reporting. A ottobre 2026, tratta con cautela qualsiasi limite scritto nel codice e leggi il valore reale in fase di esecuzione.

Uno sviluppatore ha misurato una quota iniziale di 100 URL al giorno su un sito nuovo. È una sola segnalazione, non una regola, ma mostra perché conviene chiamare prima GetUrlSubmissionQuota e gestire con eleganza una quota esaurita. Un elenco di URL vuoto può restituire un errore HTTP, che può interrompere un job pianificato una volta esaurita la quota.

Le pagine di assistenza di Bing possono essere in ritardo rispetto al prodotto. Una guida recente nota che la pagina di assistenza descrive ancora sei mesi di dati mentre il report ne offriva fino a 24, quindi fidati di ciò che mostra il report del tuo account.

In cosa differiscono l’invio di URL e IndexNow?

L’API di invio URL manda gli URL solo a Bing, mentre IndexNow è un protocollo aperto che avvisa in una volta sola i motori di ricerca aderenti. La pagina di assistenza di Bing dice che raccomanda IndexNow per gli invii di routine e avverte che la vecchia API potrebbe essere dismessa man mano che l’adozione di IndexNow cresce.

Per IndexNow crei una chiave (da 8 a 128 lettere, cifre o trattini), la ospiti come file di testo UTF-8 nella root del dominio, poi invii gli URL modificati all’endpoint condiviso o a quello di Bing. Vedi la pagina introduttiva di IndexNow su Bing e la documentazione di IndexNow. L’elenco dei motori aderenti cambia, quindi controllalo prima di dare per scontato che un motore specifico sia coperto.

Entrambi i metodi aiutano solo con la scoperta. Non garantiscono scansione, indicizzazione o posizionamento. Per un normale aggiornamento, un processo affidabile è questo:

1. Pubblica una pagina stabile e scansionabile che restituisca il giusto stato HTTP.
2. Includila nella sitemap XML e collegala dalle pagine pertinenti.
3. Invia una notifica di modifica tramite IndexNow o l’API di invio.
4. Controlla più avanti lo stato dell’URL con GetUrlInfo o dall’interfaccia; non reinviarlo ripetutamente al posto di risolvere un problema reale.

L’API di Search Console di Google non accetta richieste di indicizzazione arbitrarie per le pagine normali, come spiegato nella nostra guida all’API di Search Console. Le pagine appena pubblicate che Google segnala come non indicizzate sono trattate in Search Console dice «non indicizzata»: e adesso?.

Cos’è il report AI Performance di Bing?

AI Performance è un report di Bing Webmaster Tools, lanciato in anteprima pubblica a febbraio 2026, che mostra quanto spesso le tue pagine vengono citate come fonti in Microsoft Copilot, nei riepiloghi generati dall’AI di Bing e in alcune integrazioni di partner. Misura le citazioni, non il traffico.

Secondo l’annuncio e la pagina di assistenza di Bing, riporta le citazioni totali, il numero medio di pagine uniche citate al giorno, i conteggi di citazioni per pagina e le grounding queries. Le grounding queries sono le frasi che l’AI ha usato per recuperare i contenuti che poi ha citato. Sono un campione e non sono ciò che una persona ha digitato. Un aggiornamento di giugno 2026 ha aggiunto funzionalità in anteprima chiamate Intents, Topics, Citation Share e Compare.

Limiti da conoscere: copre le superfici di Microsoft, non ChatGPT, Perplexity, Google AI Overviews o Claude; una citazione non è un clic; e non abbiamo trovato alcun metodo API documentato per il report. Per il traffico che gli assistenti AI ti mandano davvero, usa analytics, come descritto in come tracciare il traffico da ChatGPT e Perplexity in GA4.

Come confronti i dati di Bing e di Google?

Confronta un piccolo insieme di URL importanti sullo stesso intervallo di date completo, tieni i numeri di ciascun motore in colonne separate e considera le differenze come domande da indagare, non come conclusioni.

Ecco un foglio di lavoro inventato (i numeri sono di fantasia):

Non ordinare le opportunità solo in base ai rapporti grezzi tra Bing e Google. I motori hanno pubblici, volumi di query e distribuzioni dei dispositivi diversi, e un rapporto alto può essere normale per un argomento tecnico. Un ordine di lavoro più solido:

1. Verifica che entrambi i motori riportino lo stesso URL canonico.
2. Controlla che la pagina sia indicizzata dove ti aspetti.
3. Confronta l’intento delle query; keyword simili non sono sempre equivalenti.
4. Controlla le impressioni prima di interpretare i clic, perché un motore può semplicemente avere meno volume.
5. Confronta l’andamento su due o più periodi, non l’anomalia di un solo giorno.
6. Rivedi i risultati concorrenti e title, contenuto e link interni della pagina.

Tre confronti vale la pena eseguirli con regolarità:

• Divari di visibilità. Elenca le pagine con impressioni significative su Bing ma poca attività su Google, e controlla posizionamento, indicizzazione, domanda sulle query, area geografica e dispositivi.
• Cali su entrambi i motori. Se gli stessi URL calano su entrambi, guarda disponibilità, modifiche ai contenuti, reindirizzamenti, direttive robots e concorrenza. Se cala solo uno, guarda l’indicizzazione e i posizionamenti specifici di quel motore. Per un calo solo su Google, parti dalla checklist di Search Console per il calo di traffico.
• Errori di scansione e contenuti nuovi. Usa i dati di scansione e di stato degli URL per vedere se Bing ha scoperto le tue pagine più recenti.

Come può un agente AI usare i dati di Bing?

Un agente può usare i dati di Bing solo tramite un connettore che espone Bing, e dovrebbe indicare la fonte di ogni metrica invece di mescolare in silenzio Bing e Google. Un connettore solo per Google non può produrre in modo onesto un report su Bing, anche se un modello linguistico sa descrivere come sarebbe.

Il sito di GSC Magic elenca tra i suoi tool per Bing le query e le prestazioni delle pagine di Bing, le statistiche sulle keyword per la ricerca, i conteggi dei link in entrata e gli invii a IndexNow per le pagine nuove, e dice che ogni piano include Google, Bing e GA4. Secondo i passaggi di accesso, incolli una chiave di Bing se usi Bing Webmaster Tools, e i tool di scrittura come l’invio a IndexNow sono disponibili sui piani a pagamento, dove il proprietario dell’account può disattivarli in Settings. I dettagli sono nella pagina MCP per Bing Webmaster Tools. Per la configurazione, vedi le guide per Claude e ChatGPT.

Chiedi una riga per ogni URL importante con clic su Google, clic su Bing, impressioni di ciascun motore, date, stato dell’indice dove disponibile e prossimo controllo consigliato. Tieni le cause ipotetiche in una colonna separata.

Quando i dati di Bing non valgono lo sforzo?

Salta un’analisi centrata su Bing quando Bing manda quasi nessun traffico al tuo sito e il tuo pubblico è orientato a Google, oppure quando ti serve solo una risposta veloce per una pagina. In quel caso l’interfaccia web di Bing è più rapida di qualsiasi API.

Non usare i numeri di Bing per prevedere i posizionamenti su Google e non sommare né mediare le stime sulle keyword di Bing e di Google. Bing è più utile per individuare problemi di scoperta e di indicizzazione, per i siti di nicchie tecniche o B2B in cui la quota di Bing è più alta e come verifica per capire se un calo riguarda un solo motore.

Cosa fare ora?

Verifica il tuo sito in Bing Webmaster Tools se non l’hai ancora fatto, genera una chiave API ed esegui una chiamata a GetUserSites per confermare l’accesso. Sostituisci ogni codice SOAP o POX, aggiungi IndexNow al tuo flusso di pubblicazione, poi esegui il confronto sui 28 giorni descritto sopra sulle tue dieci pagine più importanti. Per altre idee di analisi vedi i 25 prompt SEO pratici, e per eseguire questi controlli tramite un agente AI vedi la pagina MCP per Bing Webmaster Tools.

Domande frequenti

L’API di Bing Webmaster Tools è gratuita?

Bing Webmaster Tools e la sua API sono gratuiti. Restano però dei limiti: l’invio di URL ha una quota giornaliera che dipende dal tuo sito, e Microsoft pubblica pochi numeri per i metodi di reporting. Uno strumento di terze parti che si appoggia all’API può far pagare una propria tariffa, quindi verifica separatamente i prezzi di quel fornitore.

Perché una pagina si posiziona su Bing ma non su Google?

Ogni motore ha un proprio crawler, un proprio indice, propri sistemi di ranking e un proprio pubblico, quindi le differenze sono normali. Tra le ragioni possibili ci sono lo stato di indicizzazione, la domanda sulle query, la scelta del canonical, l’area geografica e la distribuzione dei dispositivi. Il confronto su una sola keyword non può isolare la causa. Controlla prima indicizzazione e URL canonici su entrambi i motori, poi confronta intento, impressioni e andamento su più periodi.

Posso usare i dati sui backlink di Bing come audit completo dei link?

No. Ogni motore di ricerca scopre e memorizza i link in modo diverso, quindi i report sui link di Bing coprono solo i link che Bing ha trovato. Usali come un segnale tra gli altri. L’API espone il conteggio dei link per pagina e i link in entrata verso un dato URL, ma non produce un inventario completo di tutti i link al tuo sito.

I numeri sulle keyword di Bing sono uguali a quelli di Google Keyword Planner?

No. Lo strumento per le keyword di Bing e i metodi dell’API sulle keyword usano dati di ricerca di Bing e metodi diversi da quelli degli strumenti di Google. Considera le cifre come segnali relativi della domanda su Bing, convalidale con le tue impressioni e non fare la media né la somma delle stime di Bing e di Google in un unico volume di ricerca universale.

Bing ha dismesso le API Webmaster SOAP e POX?

Sì. Microsoft ha dismesso le API Webmaster legacy SOAP e POX/HTTP il 31 agosto 2026. L’API JSON/HTTP resta, con gli stessi metodi secondo Microsoft. Se il tuo codice chiama ancora api.svc/soap o api.svc/pox, quelle chiamate falliranno e vanno spostate sul percorso api.svc/json.

Quanti URL posso inviare a Bing al giorno?

La pagina di assistenza di Bing indica un massimo di 10.000 URL per dominio al giorno, con un limite di 500 URL per richiesta in batch. La quota che ottieni davvero dipende dal tuo sito e può essere molto più bassa, soprattutto per i siti più recenti. Chiama GetUrlSubmissionQuota per leggere la tua soglia effettiva. Bing consiglia inoltre IndexNow per gli invii di routine.

Inviare un URL può costringere Bing a posizionarlo?

No. L’invio, tramite l’API o IndexNow, notifica soltanto a Bing che un URL è nuovo o modificato. Scansione, indicizzazione e posizionamento sono passaggi separati, e un URL inviato può comunque essere saltato o posizionarsi male. Risolvi i problemi reali, come pagine bloccate o contenuti deboli, invece di reinviare lo stesso URL più volte.

L’API Webmaster di Bing include i dati di AI Performance?

Il report AI Performance di Bing, lanciato in anteprima pubblica a febbraio 2026, mostra quanto spesso le tue pagine vengono citate nelle risposte di Microsoft Copilot e dell’AI di Bing. Non abbiamo trovato alcun metodo API documentato per questo report, quindi per ora consideralo un report dell’interfaccia e controlla Microsoft Learn per gli aggiornamenti prima di costruire automazioni.

Fallo con GSC Magic

GSC Magic espone l’intera API Webmaster di Bing, più IndexNow, come tool MCP accanto a Search Console: i dettagli sono nella pagina MCP per Bing Webmaster Tools e nel report di confronto Google vs Bing.