Bing Webmaster Tools Integration
Available on: Solo plans and higher
Connect Bing Webmaster Tools to see Bing search performance alongside Google Search Console and GA4. Bing data powers the Performance Hub, Brand Visibility Score, and agent tools so you get a complete search feedback loop, not just the Google slice.
What You Can Do
- Import Bing search analytics per brand (clicks, impressions, CTR, average position)
- See combined organic KPIs in Performance Hub (Google + Bing summed, with per-engine breakdown on hover)
- Track top Bing queries and pages merged into Performance Hub tables
- Feed Brand Visibility Score with Bing traffic, not just Google
- Query Bing data via agents, MCP, and CLI (
get_bing_performance,cuppa perf bing)
Plan Requirements
| Plan | Bing Webmaster Access |
|---|---|
| Solo | Available |
| Studio | Available |
| Scale | Available |
| Enterprise | Available |
Legacy plans: Power, Business, Agency, and Agency+ include the same access (mapped to Solo, Studio, Scale, and Enterprise). Hobby does not. Legacy plans are no longer available for new purchases.
Bing uses the same integrations feature gate as Google Search Console and Google Analytics 4.
Availability
Bing Webmaster Tools is controlled by a feature flag. It appears in Team Settings and Brand Settings only when NEXT_PUBLIC_BING_WMT_ENABLED=true is set in your Cuppa environment. Production Cuppa enables this after rollout.
Prerequisites
- A Bing Webmaster Tools account with verified sites
- Owner or Full access to the properties you want to connect
- A Cuppa Solo plan or higher
How Connection Works (Two-Tier Model)
Cuppa uses the same pattern as GSC and GA4:
- Team level: OAuth tokens stored once per team in Team Settings
- Brand level: Each brand binds to one verified Bing property
This lets agencies connect one Microsoft account and map different Bing properties to different client brands.
Step 1: Connect Bing at the Team Level
- Go to Team Settings → Integrations
- Find Bing Webmaster Tools
- Click Connect
- Sign in with your Microsoft account
- Authorize Cuppa to read Webmaster data
Tip: Use the same Microsoft account that owns your Bing Webmaster properties.
Step 2: Bind a Property per Brand
- Open Brand Settings for the site you want to connect
- Go to the Basic tab
- Find the Bing Webmaster Tools section
- Select your team Bing connection
- Choose the verified property from the dropdown
- Save
Cuppa triggers an immediate background sync when you save. Data also refreshes on the daily cron.
Step 3: Wait for Initial Sync
| Status | Meaning |
|---|---|
| Syncing… | First pull in progress |
| Connected | Property bound and sync running |
| Last synced | Shows timestamp of most recent successful sync |
First sync timing: Bing’s API returns weekly buckets. Expect up to 24 hours for history to populate after the first successful sync.
What Data Gets Synced
| Bing Data | Cuppa Storage | How Cuppa Uses It |
|---|---|---|
| Query performance | site_bing_queries | Top queries, BVS, agent/MCP/CLI tools |
| Page performance | site_bing_pages | Top pages, merged Performance Hub tables |
| Weekly site traffic | site_bing_traffic_history | KPI trends, period-over-period comparisons |
Important: Weekly Granularity
Unlike Google Search Console (daily), Bing Webmaster Tools reports in weekly buckets (Saturday dates). This means:
- Trend charts show weekly points for Bing-contributed traffic
- KPI totals still reflect the selected date range
- A brand with only Bing connected can still earn a Brand Visibility Score
Performance Hub Behavior
When Bing is connected alongside GSC:
| Metric | Behavior |
|---|---|
| Organic Clicks | Google + Bing combined |
| Organic Impressions | Google + Bing combined |
| KPI hover tooltip | Shows Google vs Bing split |
| Trends (organic series) | Bing weekly history merged in |
| Top Pages / Top Queries | Bing rows merged with Google data |
| Brand Visibility Score | Organic component includes Bing metrics |
If you connect Bing and organic KPIs jump, that is expected: you are now seeing the full search picture, not just Google.
API, MCP, and CLI Access
| Surface | Command / Tool | What It Returns |
|---|---|---|
| REST API | GET /v1/performance/bing | Bing totals, top queries, top pages |
| REST API | GET /v1/performance/overview | Combined KPIs + searchBreakdown |
| MCP | get_bing_performance | Bing-only performance summary |
| MCP | get_brand_performance | Combined overview with engine breakdown |
| CLI | cuppa perf bing | Terminal-friendly Bing performance table |
| Agent Chat | get_bing_performance | Same data for autonomous workflows |
Data Refresh
| Trigger | When |
|---|---|
| Automatic | Daily at 5:30 AM UTC (cron-bing-sync-queries) |
| On property bind | Immediate via bing/sync-site background job |
| Manual | Re-save property or use Bing sync in settings |
Sync order relative to other jobs: GSC (4:00 AM) → GA4 (5:00 AM) → Bing (5:30 AM) → BVS daily (5:00 AM after GSC).
Troubleshooting
”Bing Webmaster Tools not showing in Integrations”
- Confirm your plan is Solo or higher
- Confirm
NEXT_PUBLIC_BING_WMT_ENABLED=truein the Cuppa environment (self-hosted / staging)
“No properties found”
- Verify the correct Microsoft account was used for OAuth
- Confirm sites are verified in Bing Webmaster Tools
- Check you have Owner or Full access to the property
”Connected but no data in Performance Hub”
- Wait for the first sync to complete (up to 24 hours)
- Bing reports weekly; new properties may have sparse history
- Confirm the correct property is bound in Brand Settings
”Organic KPIs jumped after connecting Bing”
- Expected behavior. Combined Search totals now include Bing clicks and impressions.
- Hover KPI cards to see the Google vs Bing split.
”Connection expired”
- Go to Team Settings → Integrations → Bing → Reconnect
- Re-authorize with Microsoft
Privacy and Security
- OAuth 2.0 for secure authentication (scope:
webmaster.read) - Read-only access - Cuppa never modifies your Bing Webmaster settings
- Data stored securely per team, never shared across accounts
- Revoke anytime from Microsoft account permissions or Cuppa disconnect
Revoking Access
From Cuppa: Team Settings → Integrations → Bing Webmaster Tools → Disconnect
From Microsoft: Account security → Apps and services → Remove Cuppa access
FAQ
Do I need Bing if I already have GSC? Yes, if you want the full search picture. Many sites get meaningful traffic from Bing that GSC never shows. Performance Hub combines both when connected.
Which plan includes Bing? Solo plan and higher (same as GSC and GA4 integrations).
Can I connect multiple Bing accounts? One Microsoft OAuth connection per team. Disconnect and reconnect to switch accounts.
How often is data synced? Automatically every 24 hours at 5:30 AM UTC, plus immediately when you bind a property.
Why is Bing data weekly, not daily? Bing Webmaster Tools API returns weekly buckets. This is a Microsoft API limitation, not a Cuppa limitation.
Does connecting affect my Bing rankings? No. Cuppa only reads analytics data.
What if I disconnect Bing? Performance Hub reverts to Google-only organic KPIs. Cached Bing data remains until the next cleanup cycle.
Related Docs
- Performance Hub - Combined Google + Bing dashboard
- Google Search Console - Connect Google search data
- Google Analytics 4 - Sessions and on-site engagement
- Agent Brand Engineering - Use Bing data with AI agents
- MCP Server -
get_bing_performancetool reference - CLI -
cuppa perf bingcommand reference