Before you start
A Microsoft account with your website verified in Bing Webmaster Tools. One API key covers every site verified in that account, so connect it once per app and reuse the same key.
Set it up
A. Verify the site
- Open Bing Webmaster Tools and sign in.
- Already using Search Console? On My Sites choose Import, sign in with Google, then pick your sites. They arrive verified, with their sitemaps.
- Otherwise Add a site and follow one of the verification methods shown.
B. Create the API key
- Click the Settings gear (top right), then API Access.
- First time: accept the terms, then choose API Key and Generate API Key.
- Copy the key. There is one per Microsoft account.
Connect to Sprid
sprid connect bing --app <slug> --key-from-clipboard --site https://example.com--site is the address of this app’s website as verified in Bing. Leave it out when the app already has its website set in Sprid.
Typing the command yourself? Copy the key last, as Keys from your clipboard explains, with the fallback for a shell without a clipboard.
Check the connection
Run sprid status, then ask your agent: “Read recent Bing search results for this website through Sprid.” A saved key confirms setup; only the live read confirms access. A newly verified site can take up to 48 hours to show traffic.
If Sprid cannot reach Bing
Sprid reads Bing on its servers. Should Bing ever refuse them, your agent’s marketing review can read Bing from your computer instead. Save the key in a private file and point the app’s local secrets at it:
{ "bingWebmasterApiKeyPath": "~/.config/bing-webmaster/api_key" }That line goes in ~/.sprid/secrets/<slug>.json. One file serves every app on the same Bing account. Keep it out of any repository. Only the review on your computer reads it: sprid connect --from-local does not send it to Sprid, so sprid connect bing above stays the way Sprid gets the key.
If something goes wrong
- Invalid key: generate a new one under Settings → API Access and connect again. Deleting a key in Bing stops every connection that used it.
- Site not found or not verified: the website saved in Sprid must match a verified site in the same Bing account, including
wwwandhttps. - No traffic yet: try again after 48 hours; Bing only reports days that had data.
- Bing refuses Sprid’s servers (ThrottleIP): set
bingWebmasterApiKeyPathas above; the review then reads Bing locally until Sprid gets through again.
Reading the numbers
Bing reports query and page rows in buckets of about a week, so a period’s edge is approximate, and a single query can show more clicks than impressions. Read click-through rate on the totals. Copilot citations are a separate Bing report that Sprid does not read yet.
Sources and verification
Prefer your terminal? sprid docs bing reads this same guide.