Search Console and Bing setup

UsherStats shows your search data beside your traffic, fetched with access you give it and can take back at any time. Connecting needs the search:write scope (owners, admins and members have it). Credentials are encrypted before they are stored and are used only to fetch your own data.

Google Search Console

Choose one of two ways. Both give read-only access to the properties you choose.

Option 1: add the UsherStats service account to your property

The simplest way: you add UsherStats as a user of your property, and can remove it whenever you like.

1. In UsherStats, open the site's Search settings and copy the service-account address shown there.
2. In Search Console, open the property, then Settings → Users and permissions → Add user.
3. Paste the address and choose the Restricted permission (read-only is all UsherStats needs).
4. Back in UsherStats, pick the property from the list and save.

Option 2: upload your own service-account key

Use this if your organisation does not allow adding outside accounts, or you want the access to live in your own Google Cloud project.

1. In the Google Cloud console, choose or create a project and enable the Google Search Console API.
2. Create a service account (no roles are needed in the project) and create a JSON key for it.
3. Add the service account's email address to your Search Console property as in option 1, step 2, with the Restricted permission.
4. In UsherStats, open the site's Search settings, choose Use my own key, upload the JSON file, and pick the property.

Keep the JSON file safe or delete it once uploaded; UsherStats keeps its own encrypted copy. To revoke access, delete the key in Google Cloud or remove the user from the property.

Which property

A domain property (sc-domain:example.com) covers every hostname and protocol of your domain; a URL-prefix property covers only addresses under its prefix. Pick the one that matches the hostnames of your UsherStats site.

Bing Webmaster Tools

1. In Bing Webmaster Tools, open Settings → API access and generate an API key.
2. In UsherStats, open the site's Search settings, paste the key under Bing, and pick the site.

What you get

Queries, impressions, clicks, click-through rate and average position, by page and by week, in the Search view. Search engines publish this data with a delay of a few days, so the latest days fill in later.