---
title: Search Console and Bing setup
description: Connect Google Search Console and Bing Webmaster Tools to UsherStats with your own access, two ways for Google.
nav: Search Console & Bing
---
# 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](https://search.google.com/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](https://console.cloud.google.com/), 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](https://www.bing.com/webmasters), 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.