Skip to content

Nozzle documentation

Find the answer. Keep moving.

Practical guidance for setting up Nozzle, understanding the data, and resolving issues without losing momentum.

Browse documentation

Product guide

Getting Started

Set up Nozzle and learn the core product workflow.

View category
  1. Getting Started with your WorkspaceA tour of your new Nozzle workspace: adding keywords, brands, and segments, inviting users, managing projects, and finding your dashboards.
  2. How do I create a new Project for each of my clients?How to create a separate Nozzle Project for each client in your Workspace. Projects are free and unlimited; keywords count against your billing plan.
  3. How do I invite other users?How to invite other users to your Nozzle Workspace from Settings, one at a time or in bulk. Invited users get access to every Project in the Workspace.
  4. Nozzle Complete Overview [Video]A complete video walkthrough of Nozzle, covering its dashboards, keyword tracking, and workspace features in one guided overview.
  5. Nozzle Dashboards OverviewNozzle has a variety of dashboards that deliver important insights. This is a quick tour of the dashboards.
  6. What is the difference between a Workspace and a Project?I want to track keywords for a new project or client. Should I create a new Workspace or a new Project?
  7. Your PAA Content Idea Report and How to Use ItA walkthrough of the three pages in the PAA Content Idea Report, from question frequency in the SERPs to the keywords and URLs that trigger each PAA.

Product guide

Keywords

Add, organize, and cluster the keywords Nozzle tracks for you.

View category
  1. Do I need hourly rank tracking?When hourly rank tracking in Nozzle is worth the SERP spend, such as Black Friday, launches, and algorithm updates, and how to schedule it.
  2. Does Keyword Clustering use up my credits/SERPs in Nozzle?Keyword clustering does not use up your SERP credits in Nozzle. Clustering and rank tracking share the same credits and data, so there are no added fees.
  3. How can I see who my top competitors are in the SERPs?Nozzle collects information on every website that ranks in the top 5 pages (50-60 results) for your keywords, so you can easily find your competition.
  4. How can I track specific URLs that had ranking declines?How to find the URLs behind a rankings drop using the Landing Pages dashboard, drill into their keywords, and build a segment to track a list of URLs.
  5. How do I add keywords?Step-by-step instructions for adding keywords in Nozzle: create a keyword set, paste phrases, assign keyword groups, and set schedule, device, and locale.
  6. How do I add the location from which I want to monitor my keywords?How to set the locations Nozzle tracks your keywords from, adding locales in Basic or Advanced mode, and why each extra locale pulls more SERPs.
  7. How do I combine keyword groups?Two ways to combine keyword groups in Nozzle: move one group into another, or add its keywords to a second group while keeping the original group intact.
  8. How do I create a custom schedule using an RRULE?How to create a custom tracking schedule in Nozzle with an RRULE, using a free online generator and pasting the rule into the Schedules section.
  9. How do I create and edit keyword groups?How to create and edit keyword groups in Nozzle's Keyword Manager: assign groups as you add phrases, then rename, move, or remove groups in the tables.
  10. How do I get the PAA Content Idea Report?The PAA Content Idea Report is a simple and effective way to discover the questions you need to answer on your website.
  11. How do I schedule hourly tracking for a short time?Track your keywords hourly during specific timeframes and stay on top of any changes in your rankings.
  12. How do I see which keyword groups a keyword belongs to?Filter the Keywords dashboard to your keyword, then hover the Keyword Groups column — or export the list to a spreadsheet.
  13. How do I set the tracking schedule?How to set how often Nozzle pulls SERPs for a keyword set, from hourly to quarterly, with custom start and end dates and a caveat for hourly tracking.
  14. How Does Nozzle’s Keyword Clustering Work?How Nozzle builds keyword clusters by finding SERPs that share matching URLs, showing which keywords Google treats as the same topic for one page.
  15. How far back in time can I review the SERP HTML?Nozzle stores every SERP HTML forever, so you can review results back to the day you first entered your keywords, even if you leave and come back.
  16. How many SERPs do I need each month?Are you tracking too many keywords too often, or can you get more out of Nozzle by exploring more SERPs every month?
  17. How specific are the locations I can track from?Nozzle can track rankings from almost any country, state, county, city, or zip code, plus options like neighborhoods, boroughs, and universities.
  18. How to Import Keywords from Google Search ConsoleHow to import keywords from Google Search Console into Nozzle, filtering by clicks, impressions, CTR, and rank to pick the phrases you want to track.
  19. Import large lists of keywords and keyword groups with ExcelSteps and a video for building large keyword lists in Excel, tying each phrase to its keyword groups, and pasting them into Nozzle in one pass.
  20. Keyword Clustering OverviewAn overview of Nozzle's Keyword Clustering Tool: the clusters chart, filters like URL count and traffic opportunity, and the data inside each cluster.
  21. Keyword Input ModesThe Basic, Advanced, and Template Generator keyword input modes in Nozzle, what each one does, and how to choose the right one for your keyword set.
  22. Should I organize my keywords into projects, keyword sets, or keyword groups?When to organize keywords into projects, keyword sets, or keyword groups in Nozzle: groups act as categories, sets handle schedules, projects separate clients.
  23. What is the Focus Domain?The Focus Domain sets which of your Brands a keyword cluster reports on, showing the average rank and focus metrics for each cluster in Nozzle.
  24. Which dates does Nozzle use for comparing numbers in the change columns?Nozzle change columns compare the first date in your selected date range with the most recent one. How to change the range and graph changes over time.
  25. Why are there so many “duplicate” clusters?Nozzle names each keyword cluster after its highest-volume keyword, so clusters can share a name while holding different URLs, keywords, and metrics.

Product guide

Dashboards & Metrics

Build and read Nozzle dashboards, and understand the metrics and segments behind them.

View category
  1. Competitors DashboardHow to use the Nozzle Competitors dashboard to analyze competitor rankings, filter by Focus, Segment, and Keyword Group, and spot rising domains.
  2. Export Column DefinitionsA key to every column in the keyword table export from the Overview or Keywords dashboards, mapping raw field names to the metrics in the Nozzle UI.
  3. Google Search Console Overview DashboardHow the Google Search Console Overview dashboard shows your GSC clicks, impressions, CTR, and rank inside Nozzle, and how it differs from Google's view.
  4. How can I see the search volume for all of my keywords?Nozzle shows search volume only for keywords you rank for, unless you set the Focus to the google.com domain on the Overview or Keywords dashboard.
  5. How Do I Add Or Remove Metrics On A Dashboard?How to use the Metrics picker to add or remove metrics like Base Rank on any Nozzle dashboard, and why the currently selected metric is greyed out.
  6. How do I create custom segments (filters) in Nozzle?Segments filter your SERP data in Nozzle. How to create a custom segment with conditions like rank, domain, video, or device, beyond the built-in list.
  7. How do I export data from the Dashboard?How to export any dashboard chart's data to CSV in Nozzle, choosing latest or full-history samples and column sets like Basic Ranking Data.
  8. How does Nozzle calculate CTR?How Nozzle calculates CTR: a per-SERP model that weighs every element by pixel coverage and position, built on up-to-date clickthrough studies.
  9. How does Nozzle calculate Estimated Traffic?How Nozzle calculates Estimated Traffic: monthly search volume multiplied by per-SERP CTR, summed across every result a domain has on the SERP.
  10. How does Nozzle calculate Search Volume?How Nozzle calculates Search Volume using the Google Ads API, based on the keyword and location you track, and why localized volumes can look lower.
  11. How To Analyze AI OverviewsLearn everything there is to know about how to analyze AI Overviews within Nozzle across all the relevant dashboards.
  12. How To Customize The Dashboard MetricsYou can choose which metrics you want to show up in the Metrics bar and in all tables across all dashboards.
  13. Keyword Groups DashboardOnce you've set up your keyword groups in Nozzle, you can use this dashboard to get some important data.
  14. Keywords DashboardHow to use the Keywords dashboard to analyze each keyword in your project, with Top, Winners, and Losers views and drill-downs.
  15. Landing Pages DashboardHow to use the Landing Pages dashboard to analyze URL performance for you and your competitors, with Top, Winners, and Losers charts and a sortable table.
  16. Metric DefinitionsWhat each metric on your Nozzle dashboards measures, from Rank and Pixels from Top to SERP %, CTR, Estimated Traffic, PPC Value, and Search Volume.
  17. Nozzle Vision: Highlight and Compare Multiple Results with Custom ColorsLearn how Nozzle Vision helps you quickly visualize ownership and competition directly in the SERP using custom color highlighting.
  18. Performance - Single Keyword DashboardHow to analyze one keyword in Nozzle's Single Keyword dashboard, from history charts and the SERP Results table to full SERP snapshots with Nozzle Vision.
  19. Performance Overview DashboardA tour of Nozzle's Performance Overview dashboard, from the metrics bar and summary chart to the sortable Keywords table and competitor charts.
  20. Segments DashboardUse the Segments dashboard to filter through your data and discover more about your online visibility.
  21. What are all those Focus options in the dashboards?What each option in the Nozzle dashboard Focus dropdown means, from Brand Type, Brand, and Brand Property to Domain and URL, and when to use each one.
  22. What is Base Rank?Base Rank counts only organic results and featured snippets, ignoring ads and PAA boxes. How to add it to a Nozzle dashboard from the Metrics picker.
  23. What is Item Rank?Item Rank tracks each clickable item inside a pack or SERP feature, like local packs, PAA boxes, and sitelinks, and how to view it in Nozzle Vision.
  24. What is Nozzle Vision?Nozzle Vision overlays metrics like Rank, Pixels From Top, and CTR on a rendered SERP snapshot, with side-by-side date comparisons for visual reporting.
  25. What is Share Of Voice %?Share of Voice % measures how much of the available search traffic your domain or brand is capturing for a given keyword or group of keywords.
  26. What is the difference between Organic and Unpaid segments?The Unpaid segment includes every non-paid result, even SERP features, while Organic counts only blue-link results. How to see how Nozzle labels each.
  27. Why Does Search Volume Show Zero Sometimes?Nozzle hides search volume when your domain does not rank in the top 5 pages for a keyword. Set the Focus to Domain and pick google.com to see it anyway.
  28. Why don't I see my ads in Nozzle?Google does not show ads on every SERP pull, so Nozzle only records ads present at capture time. How to verify what was captured in the SERP Snapshot.

Product guide

Brands & Reputation

Track who owns the SERP and monitor the reputation coverage around your brand.

View category
  1. How do I add Brands?Nozzle lets you track more than just your domain. You can add every element of your online brand to get a more complete picture of the SERP.
  2. How do I find my Google Business Profile ID/CID?Two ways to find the Google Business Profile CID for your listing or a competitor, so you can add it to a Brand in Nozzle and track local results.
  3. How do I track a specific subfolder of a website?How to track a specific subfolder of your site in Nozzle by creating a Brand with a custom URL contains condition, then selecting it in the Focus dropdown.
  4. How do I track my competitors' brands?How to create a brand for each competitor in Nozzle, set it as a direct or indirect competitor, and view their rankings with the Focus dropdown.
  5. How do I track YouTube videos in Nozzle?Three ways to track YouTube in Nozzle: import up to 500 channel videos into a Brand in bulk, add individual video URLs, or track your whole channel.
  6. How many brands, competitors, properties can I monitor?Nozzle captures every listing on the SERP for your keywords, so you can monitor unlimited brands, competitors, and properties at no extra cost.
  7. How to Analyze Your Local Results in NozzleHow to track your Google Business Profile in the Map Pack: add it as a brand property, then read the pack rank and Item Rank in Performance Overview.
  8. How to Bulk Upload URLs as Brand PropertiesHow to bulk upload URLs as brand properties in Nozzle, useful for reputation management tracking or monitoring hundreds of product URLs at once.
  9. How to Customize Brand Colors on the Competitors DashboardHow to set a custom Brand Color for each brand in Brands Manager so the Competitors dashboard chart displays your own colors instead of the defaults.
  10. Is there a limit to the number of brands, competitors, and properties you can track?There is no limit. Nozzle reviews the entire SERP, so extra brands, competitors, and properties cost nothing, and stored SERPs let you add new ones later.
  11. Reputation Management Dashboard OverviewAn overview of Nozzle's Reputation Management dashboard, covering Rank and Reputation views, sentiment color codes, and chart Limit and Samples settings.
  12. Reputation Management Dashboard: How To Add Sentiment Coloring To All URLsHow to efficiently add sentiment coloring to URLs on the Reputation Management dashboard using positive, neutral, and negative brands in Nozzle.
  13. Should I create a separate Brand for my YouTube videos?Why creating a separate Owned Brand for your YouTube videos in Nozzle makes it easier to see how your video content ranks in the SERPs on its own.

Product guide

Data & BI

Reach Nozzle data in BigQuery, warehouses, spreadsheets, and BI tools.

View category
  1. Export Data to S3 BucketSet up a daily export of Nozzle keyword and ranking data into your own AWS S3 bucket, ready to load into Snowflake, Databricks, Redshift, or Athena.
  2. Generic QueryAn annotated BigQuery query for the Nozzle rankings dataset, covering SERP deduplication, base rank, SERP feature flags, and common filter patterns.
  3. How do I access my data in BigQuery?How to get BigQuery access to your Nozzle data: find your workspace and project slugs, request access for users or a Google Group, and open your dataset.
  4. How Do I Use My BigQuery Data in Google Data Studio?How to connect your Nozzle BigQuery data to Google Data Studio, with a starter SQL query, a basic rankings template, and a walkthrough video.
  5. Looker Studio Templates With BigQuery QueriesAn index of Looker Studio templates and BigQuery queries for Nozzle data, including PAA, PASF, product, video pack, and geo ranking reports.
  6. Which BI tools connect to Nozzle?Nozzle data lives in BigQuery, so you can connect Data Studio, Tableau, Power BI, or most other popular BI tools for reporting and visualization.
  7. Geo Ranking Report Query And TemplateA Looker Studio template and BigQuery query for a geo ranking report that maps rank by ZIP code and city using Nozzle location keyword groups.
  8. PAA Report Query And TemplateA Looker Studio template and BigQuery query for reporting on People Also Ask results in Nozzle SERP data, with the URLs and titles behind each question.
  9. Paid Product Report Query And TemplateA Looker Studio template and BigQuery query for paid product results in Nozzle SERP data, with merchant-level rank, product pack, and traffic metrics.
  10. PASF Report Query And TemplateA Looker Studio template and BigQuery query for People Also Search For results in Nozzle SERP data, with related phrases and ranking URLs.
  11. Unpaid Product Report Query And TemplateA Looker Studio template and BigQuery query for unpaid product results in Nozzle SERP data, with merchant, product pack, 3D, 360, and discount metrics.
  12. Video Pack YouTube Channel Report Query And TemplateA Looker Studio template and BigQuery query for tracking YouTube channel appearances in video packs, with channel rank, traffic, and video count metrics.
  13. SERPs Containing AI Overviews And My Domain Ranks OrganicallyGenerate a report of SERPs that contain AI overviews and your domain ranking in other unpaid results.
  14. Top 20 Ranking Results Report Query And TemplateThis report is an export of the top 20 results for all keywords being tracked in your Nozzle project. It only includes one row per ranking position.
  15. Top Stories Ranking Report Query And TemplateTop stories ranking report template that shows the rank, URL, and Domain of every visible top story result

Product guide

API

Authenticate with the Nozzle API and pull ranking data programmatically.

View category
  1. Admin APIA quickstart for the Nozzle Admin API, covering API tokens, workspace and project ids, template tokens, and a cURL example for listing your projects.
  2. How do I authenticate with the Nozzle API?How to authenticate with the Nozzle API using a long-lived key in the Authorization header, plus finding the workspace, team, and keyword source IDs.
  3. How Do I Create An API Token?How to create a Nozzle API token from the Users page, save it the one time it is shown, and send it in the Authorization header with the Token prefix.
  4. How do I export my Nozzle data?An overview of the ways to get data out of Nozzle, from one-off CSV downloads to live BigQuery access, and which to pick for what you're doing.
  5. How do I use the Copy cURL feature to pull data via the API?Every Performance dashboard widget can hand you the exact API call that powers it. Here's how to use it.
  6. How do keyword sources work?How keyword sources work in Nozzle: the phrases, locales, devices, and schedules they bundle, plus how to read and update them safely via the API.
  7. How do Nozzle locales work?A Nozzle locale is one ID combining country, city, language, and device. How to find the localeId you need and request missing combinations.
  8. Reporting APIA quickstart for the Nozzle Reporting API, with an example groupByOverTime curl call, template tokens to swap out, and the available metrics.
  9. What do common API errors mean?A reference for HTTP status codes you might encounter when calling the Nozzle API, and how to fix them.

Product guide

Account & Billing

Manage workspaces, projects, users, plans, and billing.

View category
  1. Can I manually run a SERP scan on a certain day?How to run a one-off SERP scan in Nozzle with the Run Now button on a keyword set, plus common reasons to pull SERP data outside your schedule.
  2. How do I change an email address for a user?Currently, there is no direct way to edit/change your email account. However, you can easily create a new account and delete the old one.
  3. How do I delete a Project?The steps to delete a Project from your Nozzle Workspace, and why removing its schedule instead can pause tracking while keeping your whole setup intact.
  4. How do I find my Workspace and Project slugs?Where to find your Workspace slug in Workspace Settings and each Project's slug on the Projects page in Nozzle. Renaming never changes a slug.
  5. How do I setup SSO?How to set up SAML SSO for Nozzle: the values to enter in your identity provider, the details to submit back, and how users sign in with SSO.
  6. How Do I Switch Between Workspaces?Two ways to switch between Nozzle Workspaces: the search field (or Ctrl-Shift-K on Windows, Command-K on Mac) and the Workspace name in the left-side menu.
  7. How to choose a plan and manage your subscription.Choose a Nozzle plan, upgrade from a trial, and manage your subscription, payment method, invoices, and billing details from the Billing page.
  8. What are Overages?When you need more SERPs than your plan includes, overages bill the extra at your plan’s rate per 1,000 SERPs, often for less than upgrading.

Product guide

Troubleshooting

Resolve sign-in problems and missing dashboard data.

View category
  1. Why Can't I Log In?The five most common reasons a Nozzle login fails, from adblockers blocking Firebase to signing in with the wrong email or workspace, and how to fix each.
  2. Why didn’t I get the email with the sign-in link?What to do when the Nozzle sign-in link email does not arrive: check spam and promotions folders, wait out delays, or use the Log in with Google option.
  3. Why Don't I See Data in the Dashboards?Common reasons Nozzle dashboards look empty: no Owned brand, a subdomain in the domain property, a date range before collection, or no rank in the top 5 pages.