Connect Google Search Console

Authorize Google once, then sync real keyword positions from Search Console straight into Seofyme's rank tracker.

6 min read

Connecting Google Search Console lets Seofyme pull the average position for the keywords you track and write them straight into the rank tracker — real Google data instead of numbers you log by hand. The connection uses your own Google OAuth client, so the tokens stay on your WordPress site.

Note

You only do the Google Cloud setup once. After that, connecting is two clicks. Set this up under Seofyme SEO → Settings, then connect from either Settings or Rank tracker.

Before you start

A Google account that already has access to your site in Search Console.
Your site verified as a property in Search Console (URL-prefix or domain property).
Pretty permalinks enabled in WordPress (Settings → Permalinks) so the REST callback URL works.

Step 1 — Create a Google Cloud project

1
Open the Google Cloud Console
Go to console.cloud.google.com and sign in with the Google account that manages your Search Console property.
2
Create (or pick) a project
Click the project switcher in the top bar, then New Project. Name it something like Seofyme SEO and click Create. Select it once it's ready.

Step 2 — Enable the Search Console API

1
Open the API Library
In the left menu choose APIs & Services → Library, or go straight to the API library.
2
Find the Search Console API
Search for Google Search Console API and open it.
3
Click Enable
Press Enable. This lets your project read Search Console data on your behalf.

1
Open the consent screen settings
Go to APIs & Services → OAuth consent screen.
2
Choose the External user type
Pick External and click Create. This is normal even for a single-site setup.
3
Fill in the required fields
Enter an app name (e.g. Seofyme SEO), your support email, and a developer contact email. You can leave the logo and optional links empty.
4
Add the scopes
Add the scope .../auth/webmasters.readonly (read-only Search Console). Seofyme never writes to Search Console.
5
Add yourself as a test user
While the app is in Testing, add your Google address under Test users. That's enough to connect — you don't need to publish or get Google verification for private use.

Step 4 — Create the OAuth client ID

Tip

Copy your exact redirect URI from Seofyme SEO → Settings → Google Search Console first — it's shown there for your site and must match what you paste into Google character-for-character.

1
Open Credentials
Go to APIs & Services → Credentials, click Create Credentials, and choose OAuth client ID.
2
Pick Web application
Set the application type to Web application and give it a name like Seofyme WordPress.
3
Add the authorized redirect URI
Under Authorized redirect URIs, click Add URI and paste your site's callback URL (see the format below). It must match exactly, including https:// and the trailing path.
4
Create and copy the credentials
Click Create. Google shows your Client ID and Client secret — keep this dialog open or copy both values now.

Authorized redirect URI — replace YOUR-DOMAIN with your site (the exact value is shown in Seofyme → Settings).

text

https://YOUR-DOMAIN/wp-json/seofyme/v1/gsc/callback

Step 5 — Connect Seofyme to Search Console

1
Paste the credentials in Seofyme
In WordPress, open Seofyme SEO → Settings → Google Search Console, paste the Client ID and Client Secret, and click Save settings.
2
Click Connect Search Console
Use the Connect Search Console button on the Settings page (or on Rank tracker). You'll be sent to Google to authorize access.
3
Approve access on Google
Sign in, pick the Google account with your property, and approve the read-only Search Console permission. Google returns you to WordPress and the status turns to Connected.
4
Choose your property
Select the correct Search Console property (for example https://example.com/ or sc-domain:example.com) and click Save property.

Careful

Seeing an “unverified app” or “access blocked” screen? Make sure your Google address is listed under Test users on the OAuth consent screen. For testing apps that's expected — you don't need Google verification to use it privately.

Step 6 — Sync keyword positions

1
Add the keywords you care about
On Rank tracker, add the keywords you want to monitor. Matching is by keyword text against Search Console queries.
2
Click Sync positions
Press Sync positions on the Rank tracker page. Seofyme pulls the average position over roughly the last 28 days and updates each tracked keyword's history.

Note

Search Console reports an average position over the selected window, so it won't always match a live check for a single query. Judge trends over time rather than a single number.

Troubleshooting

"redirect_uri_mismatch" when I click Connect: The redirect URI in your Google OAuth client doesn't exactly match your site's callback. Copy the URI shown in Seofyme → Settings → Google Search Console and paste it into the client's Authorized redirect URIs, including https:// and the /wp-json/seofyme/v1/gsc/callback path.
The callback returns a 404: Your permalinks aren't flushed. Open Settings → Permalinks and click Save Changes once so the WordPress REST route resolves.
"Access blocked: app is not verified": Add your Google account under Test users on the OAuth consent screen. Private/testing use does not require Google's verification process.
No property appears in the dropdown: The connected Google account must own or have access to the property in Search Console, and the site must be verified there. Add or verify the property, then reconnect.
Positions didn't change after syncing: Search Console only has data for keywords your site actually appears for, and only after a short delay. Keywords with no impressions in the window are left unchanged.

Good to know

Connected once, you can re-sync any time from Rank tracker. Seofyme stores a refresh token, so you won't need to re-authorize on every visit.