Setup guide
Get your API keys
NovaScope.io is bring-your-own-keys. A one-time license does not include hosted Gemini or SerpAPI. After checkout, paste keys into the setup form. You can change them later in Settings. We never ask you to email a secret code — only open the provider dashboard, copy, and put them here.
Recommended starter: Gemini + Groq + SerpAPI. Then add Yelp and Crawly if you want NAP and backlinks. Search Console, GA4, Business Profile, CrUX, Bing, and IndexNow are optional performance connections; OpenAI, Claude, Perplexity, Moz, and SpyFu are optional paid extras.
1. Google Gemini
Recommended · Free tier available (Google AI Studio)Answer Engine Audit, extraction, and report drafting.
- Open Google AI Studio and sign in with a Google account.
- Accept the Gemini API terms if prompted.
- Open API keys and click Create API key (new keys are auth keys).
- Copy the key once, then paste it into NovaScope.io setup (or Settings → Google Gemini).
- Click Save settings. The key is stored in this workspace only.
2. Groq
Recommended · Free tier — no credit card for typical starter useSecond free answer engine (open-weight model) for visibility testing.
- Create a Groq account at console.groq.com.
- Open API Keys.
- Create an API key and copy it.
- Paste it into NovaScope.io setup (or Settings → Groq), then save.
3. SerpAPI
Recommended · Small free monthly credit, then paidGoogle AI Overviews, local pack, GBP completeness, and citation search.
- Sign up at serpapi.com.
- Open your dashboard and copy the API key.
- Paste it into NovaScope.io setup (or Settings → SerpAPI), then save.
- One key is shared across AI Overviews, local pack, GBP, and NAP searches.
4. Yelp Fusion
Recommended · Yelp Fusion has a free developer appYelp listings in the NAP citation finder.
- Create a Yelp Developers account.
- Create or open an app under Manage App.
- Copy the API Key.
- Paste it into NovaScope.io setup (or Settings → Yelp Fusion), then save.
5. Crawly
Recommended · Free daily request allowance (confirm on Crawly’s site)Backlink profile data on automated checks.
- Sign up at getcrawly.com.
- Open the API section and copy your key.
- Paste it into NovaScope.io setup (or Settings → Crawly), then save.
6. PageSpeed Insights
Optional — scans still run without this key; Google’s API is freeHigher rate limits for Core Web Vitals during the site scan.
- Open the PageSpeed Insights API get-started page.
- Create or select a Google Cloud project and enable the PageSpeed Insights API.
- Create an API key under Credentials.
- Paste it into NovaScope.io setup (or Settings → PageSpeed Insights), then save.
7. Google Maps
Optional — reports export without a map if unset; Google's Static Maps API has a free monthly quota, then pay-per-useLocation map on the Executive Summary of PDF/DOCX report exports.
- Open the Maps Static API get-started page.
- Create or select a Google Cloud project and enable the Maps Static API.
- Create an API key under Credentials, and restrict it to the Maps Static API.
- Paste it into Settings → Google Maps, then save.
8. Google Search Console connection
Free — requires verified Search Console accessSearch clicks, impressions, CTR, average position, and query opportunities on the performance dashboard.
- Verify the site in Google Search Console and make sure your Google account can read the property.
- Create or select a Google Cloud project, enable the Google Search Console API, and configure an OAuth consent screen.
- Create an OAuth client and authorize the https://www.googleapis.com/auth/webmasters.readonly scope.
- Paste the resulting access token into Settings → Google Search Console access token. Access tokens expire, so reconnect when NovaScope reports an authorization error.
- For Google Search Console property, paste the exact property identifier shown in Search Console: sc-domain:example.com for a Domain property or the complete https:// URL-prefix property including its trailing slash.
9. Google Analytics 4 connection
Free — requires read access to the GA4 propertyOrganic sessions, active users, and key events on the performance dashboard.
- In Google Cloud, enable the Google Analytics Data API for your project and configure OAuth consent.
- Create an OAuth client and authorize the https://www.googleapis.com/auth/analytics.readonly scope with a Google account that can read the property.
- Paste the access token into Settings → Google Analytics access token. Access tokens expire and must be reauthorized when the connection reports an authentication error.
- In Google Analytics, open Admin → Property details and copy the numeric Property ID—not the G- measurement ID.
- Paste that number into Settings → GA4 property ID, save, then sync Google Analytics from the dashboard.
10. Google Business Profile Performance connection
Free API — Google approval and location access requiredBusiness Profile impressions, calls, and website clicks for a connected location.
- Request and obtain access to the Google Business Profile APIs for your Google Cloud project.
- Configure OAuth and authorize the https://www.googleapis.com/auth/business.manage scope with an account that manages the location.
- Paste the access token into Settings → Google Business Profile access token. Reauthorize when the token expires.
- Use the Business Information API accounts.locations.list method to find the location resource name, such as locations/123456789.
- Paste only the unobfuscated ID after locations/ into Settings → Google Business Profile location ID.
11. Bing Webmaster connection
Free — connector currently limited during Bing's OAuth migrationBing search performance and indexing data when the replacement OAuth API is available to the account.
- Verify the site in Bing Webmaster Tools.
- Review Bing's current OAuth migration documentation before creating credentials; legacy Webmaster API keys are being retired.
- Do not create a new legacy key solely for NovaScope. The integration card remains Limited until NovaScope can use Bing's replacement OAuth flow.
- For Bing Webmaster site URL, use the exact verified site URL shown in Bing Webmaster Tools.
12. Chrome UX Report (CrUX)
Free Google API quotaReal-user Core Web Vitals collected from eligible Chrome users.
- Create or select a Google Cloud project.
- Enable the Chrome UX Report API.
- Create an API key under APIs & Services → Credentials and restrict it to the Chrome UX Report API.
- Paste it into Settings → Chrome UX Report API key and save.
- CrUX only returns data for origins with enough real-user Chrome traffic; no data is a valid result for smaller sites.
13. IndexNow
Free — requires a verification file on the client siteNotify participating search engines when public URLs are added, updated, or deleted.
- Generate a hexadecimal key between 8 and 128 characters.
- Create a UTF-8 text file named exactly KEY.txt whose contents are that same key.
- Publish the file at the audited site's root, for example https://example.com/KEY.txt, and confirm it loads publicly.
- Paste the key into Settings → IndexNow key and save.
- Submit only URLs on the same verified host. IndexNow is a notification action, not a rankings or analytics dataset.
14. Anthropic Claude
Paid — pay-per-token, billing requiredOptional Claude engine for Answer Engine Audit and drafting fallback.
- Create an Anthropic Console account and add billing.
- Open API keys and create a key.
- Copy it and paste into NovaScope.io setup (or Settings → Anthropic Claude), then save.
15. OpenAI
Paid — pay-per-token, billing requiredOptional ChatGPT visibility engine.
- Sign in to platform.openai.com and add billing.
- Open API keys and create a new secret key.
- Copy it once and paste into NovaScope.io setup (or Settings → OpenAI), then save.
16. Perplexity
Paid — API credits requiredOptional Perplexity visibility engine with live search.
- Sign in to Perplexity and open API settings.
- Create an API key.
- Copy it and paste into NovaScope.io setup (or Settings → Perplexity), then save.
17. Moz (Access ID + Secret Key)
Optional / paid — Moz has a small free row allowance, then paidOptional domain authority metrics. Paste both fields.
- Sign in to Moz and open API keys.
- Copy Access ID and Secret Key.
- Paste both into NovaScope.io setup (or Settings: Moz Access ID and Moz Secret Key), then save.
18. SpyFu (API ID + Secret Key)
Optional / paid — SpyFu Pro+ with API creditsOptional competitive keyword data. Paste both fields.
- Sign in to SpyFu (Pro+ with API credits).
- Open Account → API and copy API ID and Secret Key.
- Paste both into NovaScope.io setup (or Settings), then save.
Provider free tiers and dashboards change. This page is a setup checklist, not a billing guarantee. NovaScope.io does not run API keys for paying customers in this launch.