Troubleshooting
Common errors and how to fix them — organised by where the problem occurs.
Sync & Content Audit Errors
I'm getting a 403 Forbidden error during sync
A 403 means something on your WordPress server is actively blocking Occasio's requests. First check for a WordPress security plugin (Wordfence, iThemes Security, All-In-One Security, WP Cerber) and temporarily deactivate it to test. If it works, whitelist the path /wp-json/occasio-connector/v1/posts or add Occasio's user agent Occasio/1.0 to the allowlist.
If your site is behind Cloudflare, go to Security → WAF → Custom Rules, create a rule with the expression http.user_agent contains "Occasio", set the action to Skip (all custom rules and all managed rules), save and deploy, then retry your sync.
I'm getting a 401 Unauthorized error during sync
A 401 usually means the site URL saved in Occasio doesn't exactly match your actual WordPress address. Open your WordPress site in a browser, copy the URL exactly as it appears, go to Settings → Sites in Occasio, paste the URL, remove any trailing slash, save and retry.
Sync fails with "Check that the plugin is active, the token is correct, and the site is reachable"
Check that the Occasio Connector plugin is active in WordPress Admin → Plugins. Copy the API token fresh from the plugin settings and paste it into Occasio. Confirm your security plugin isn't blocking the WordPress REST API for logged-out users.
Sync fails with "returned an HTML page instead of JSON"
A caching plugin (WP Rocket, LiteSpeed Cache, W3 Total Cache) may be serving a cached HTML page in response to REST API requests. Temporarily deactivate your caching plugin, retry the sync, then re-activate it. Also check if your site is in maintenance mode.
My sync completes but fewer posts show up than I have on my site
Check Settings → Sites for any category exclusions. Occasio only syncs published posts — drafts, scheduled, and private posts are excluded. If your site has more than 2,000 posts, you'll need the Occasio Connector plugin (which streams all posts without pagination limits).
Sync works but my GSC data isn't showing
Confirm the Search Console property URL in Occasio Settings exactly matches the property URL in Google Search Console (including www, trailing slash, and protocol). If you see "quota exceeded", wait until the next day and sync again.
Keyword Search Errors
I searched a keyword but see no data / empty results
Very low volume keywords have no measurable monthly search volume — try a broader variation. Also check that the location and language selectors match your target audience. Very recently coined terms may not yet have enough search history.
I hit a daily limit on keyword searches
Your plan includes fair use access to all data features. A daily rate limit applies to protect system performance — it resets overnight. Repeat searches on a keyword you've already looked up are always free, as they pull from a local cache.
Connection & Login
My Google account shows as disconnected after reconnecting
Go to myaccount.google.com/permissions and remove the Occasio entry. Return to Occasio Settings and click Connect Google again, completing the Google consent screen and granting all requested permissions.
I can't sign in / my session keeps expiring
Clear cookies for occasio.digital in your browser settings, then sign in again. Try signing in in a private/incognito window to rule out extension interference. If you signed up with Google, you'll need to continue using Google sign-in.