Integrate Google Search Console

When you integrate your Google Search Console Account, you will unlock these features:

  • Ability to View the Actual visit counts, impressions, and Average Position beside each tracked data.

  • Ability to Explore already ranking keywords in Google.

  • Ability to View the Stats for the Last 30 days. Easily View the top keywords, countries and pages.

  • Get the Last 7 days' Search Console Data in the notification Email.

To integrate your Google Search Console Account with SerpBear, follow these steps:

Step 1: Create a Google Cloud Project

Create a New Project in Your Google Cloud.

Step 2: Activate the Google Search Console API

Once you have created the project, activate the Google Search Console API by going to your Google Cloud Dashboard > Library.

Then Search for "Google Search Console" and click the "Enable API' button.

Step 3: Create a Service Account Key

  1. Go to Google Service Accounts Dashboard, and then select your Project.

  2. You should already see a service account created. Click the three dots beside it, and click the "Manage Keys" option.

  3. Once you are on the Manage Keys page. Click the Add key button and select JSON.

  4. A JSON file will be downloaded. This file will contain the private_key & the client_email values that we will need for the next step.

Step 4: Connect your Google Cloud Account with your Google Search Console Properties.

  1. Go to your Google Search Console Dashboard, and select the domains you want to connect with SerpBear.

  2. Go to the Settings page, and click the "Users & Permissions" menu.

  3. From the Users and Permissions page, click the "Add User" button.

  4. In the Add User Popup, insert the client_email value you found in the JSON file you downloaded from the Google Cloud account.

Note: You will have to perform step 4 for every domain that you want to connect to SerpBear.

Step 5: Connecting Your Google Search Console Property to SerpBear

There are a few ways to connect your Google Search Console Domain/URL to SerpBear.

Method 1: Connecting through the App Settings UI.

Open the SepBear App Settings Panel, and click the "Search Console" tab, and insert the private_key & the client_email into the relevant fields. These two values will be automatically used globally for all your domains added to SerpBear.

Method 2: Connecting through the Domain Settings UI.

You can connect a specific account to a specific domain by inserting the private_key & the client_email values through the Domain Settings Modal.

Method 3: Connecting through the environment variable

When you pass the private_key & the client_email into values via environment variables, the values are used for all the domains assuming the private key and the client email value have access to all your domains.

If you are deploying locally, you need to open the env.local file and the 2 values this way:

SEARCH_CONSOLE_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\ssssaswdkihadho\nlnb/Kt88qQC6gO638o062+5peN8/UAE1+SbaQ10Vtrh7j9c5HoFjEE3BQjLv37qu\nxFtQ7JJ2IottyRnssrUf7RlmpjaAV0zc27IrQcI5bZQIBHiM1G5qdMThh3eDjKzI\nGvWP0LIQsoyAzoU29D3gS0/9deR0bpxK7/xtk7ClifKguewMWYNd8jVw9TvoNXRI\nSkK7m0sOTgp6f/xCSLcGQkhVN7gHIS5MqMu3a8AGT8iOoYfLtx5sSqp2/pTbwv3l\n8X5ik9tk6gR/tR9oharmW72ttVILk1M/wA6dc+H+8ssMCwseF91V+ZoujZxerrus\nyawSWNj9AgMBAAECggEANHCiAYY3gt2XjUgTmtQNvf78wQEVnO//VfHKtB5Z2YfU\nUWKJylLtGxW6htnmND46cuCWmiESS4N9jzj6sIb5Kf6MfspejIrBXjlkSXqgRiDa\n9LscBg/yA0O39Mm+KuCmnlFvu5FaLJIOUBWQZOGdLrpocS8TvVfdHf5QoFt8Yf0a\n0R+qn2TkGdmfoWqcxTg3LWa4ldb9a922VIj9NKGviiNiFjDFg99XaFliNE7PH1AL\n0q5+5IuuFyGRpCURMXOTpU1K9+sMuMSQfRqYQLMbOQwUJ/wc1B8QLjgBoRlaDOvv\nEOlZ+iPK0M3+H8AikP/x/XyC08b8NNZTYYkh4oQRWwKBgQDSfl4ne5ttgMcNF71Z\nNBLUsaAP0Jh0hy4fmfjDkpl4dkCWkN0R7ukPZ7YzaOTZsKkIyL2fZxxOEWrg+vuG\nQqVXn+1kMMUge5tyb/FNuHaj3PtnR4p2AAc0jbXNHI9tj7YI967C54t67HeHN+mE\n7WO0TINO8ZlABpCht1mYhVe7QwKBgQDLXAFNvf5fJXZVifSBqJqGxWg5YtBJOJjZ\njqWSvqC03x+ahFU91JfLJUwl5B8pRHAsaA7zNKVtuWMRMYd8fnETut8kfi+U/5D4\nLmAg+shajBHY/3EeEvVk6V0vGPX5oSl5ILjoeRwy08V+QngfNuGlrZEeY6MFhtl2\nuKfgicw2vwKBgECLf1OcE40AcAkTvnwb+6o8zVgMHrOcwAfwrtdJnMXTfPqucRuO\npuiSZMxe3c3i3fJTm9HFTGij7qIOVBJXXVwBLkoKqmfLf18X9GZgqgCVQoHo7gxA\n9fSnf5flqhVue+NED9K0LZED8aMFAhZAtNIUpC8Q5m07lh4Amvip6r0BAoGANI1K\nKPT4T043DlPgQ8F2bW2GSY4nlURy+4XJc+qfTR575EpeXOQbdfvlecVB6EAvXMpn\nUqJAPeKynzbVdG6YeijIkX2qfi6tH/WcEem87OlVk2YvrT3o/HLyCcHBjwj+1raG\nEk155Ail+MLkl+xu04nO/rNw5XS7rdp6R6RUibECgYAuuCMfonurnYqzQGhH35TT\ng+Ruk4WaOH/cYavwBbsCrrBBNjcaziGjayJ1+uZ1kKmgfU7DDCF3hZl7iZXqbdbe\n1GWBOcNgsqAG+wqWP4VVXQmEGh/kgG+w1Ck+fT4AnpN2O9+1t/MzxxWq/6vQRG4r\n9vwn1x8VDHvFrKuPYKYv6A==\n-----END PRIVATE KEY-----\n
SEARCH_CONSOLE_CLIENT_EMAIL=myemail@appspot.gserviceaccount.com

If you are deploying with docker, and passing environment directly with the docker run command, you must also pass these 2 variables.

If you use docker-compose, you can simply insert these 2 values in the environment section.

Last updated