Skip to main content
Ubersuggest is an SEO platform by Neil Patel that provides keyword research, domain and competitor analysis, backlink data and site audits. It estimates search volume, cost per click, ranking difficulty and organic traffic, helping teams plan and track their search strategy.

​
Configuring Ubersuggest as a Source

In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Ubersuggest option from the list of connectors. Click Next and you’ll be prompted to add your access.

​
1. Add account access

You’ll need to authorize Nekt to access your Ubersuggest data. Click on the authorization button and log in with your Ubersuggest account, then grant the requested permissions.
Reports are billed against the daily quota of the authorized account’s plan. Almost every request counts as one report: the free plan allows 3 per day, while Individual, Business and Enterprise allow 150, 300 and 900 respectively. Choose the number of domains and keywords accordingly.
The following configurations are available:
  • Domains: The domains you want to report on, one per line (for example example.com). Leave it empty to skip the domain streams.
  • Keywords: The keywords you want to report on, one per line. Leave it empty to skip the keyword streams.
  • Language: The language code used for every report, such as en for English or pt for Portuguese.
  • Location ID: The Ubersuggest location identifier used for every report (2840 for the United States, 2076 for Brazil).
  • Rows per report: (Advanced) The maximum number of rows requested per report. Higher values return more data per request without consuming extra daily reports.
Once you’re done, click Next.

​
2. Select streams

Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. You can select entire groups of streams or pick specific ones.
Tip: The stream can be found more easily by typing its name.
Select the streams and click Next.

​
3. Configure data streams

Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table (which will effectively contain the fetched data) and the type of sync.
  • Layer: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
  • Folder: a folder can be created inside the selected layer to group all tables being created from this new data source.
  • Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix to all tables at once and make this process faster!
  • Sync Type: you can choose between INCREMENTAL and FULL_TABLE.
    • Incremental: every time the extraction happens, we’ll get only the new data - which is good if, for example, you want to keep every record ever fetched.
    • Full table: every time the extraction happens, we’ll get the current state of the data - which is good if, for example, you don’t want to have deleted data in your catalog.
Ubersuggest returns a snapshot of the current estimates rather than a change log, so every stream is a full snapshot. If you want to keep the history of how metrics evolve over time, choose INCREMENTAL so each run is appended to the table.
Once you are done configuring, click Next.

​
4. Configure data source

Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). Optionally, you can define some additional settings:
  • Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource here.
  • Determine when to execute an Additional Full Sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
Once you are ready, click Next to finalize the setup.

​
5. Check your new source

You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.
For you to be able to see it on your Catalog, you need at least one successful source run.

​
Streams and Fields

​
Available streams

Each stream runs once per configured domain or keyword. The table below lists every stream, its slug (the exact identifier to pass when creating the source via API) and a short description.

​
Fields by stream

Below you’ll find all available data streams from Ubersuggest and their corresponding fields:
SEO overview of each configured domain.Key Fields:
  • domain - Domain the overview refers to
  • domain_authority - Domain authority score (0-100) estimating ranking strength
Traffic:
  • organic - Number of keywords the domain ranks for organically
  • traffic - Estimated monthly organic visits
  • paid_keywords - Number of keywords the domain bids on in paid search
  • paid_traffic - Estimated monthly visits coming from paid search
Backlinks:
  • backlinks - Total number of backlinks pointing to the domain
  • ref_domains - Number of distinct domains linking to this domain
  • follow - Number of backlinks that pass link equity (dofollow)
  • no_follow - Number of backlinks marked nofollow
Nested data (JSON strings):
  • domain_traffic - Monthly traffic and keyword counts per period, keyed by YYYYMM
  • service_info - Whether the domain is connected to Google Analytics/Search Console in Ubersuggest
  • organic_keywords - Sample of keywords the domain ranks for, with position, volume and CPC
Organic keywords each configured domain currently ranks for.Key Fields:
  • domain - Domain that ranks for the keyword
  • keyword - Search term the domain ranks for
  • position - Position the domain holds in the search results for this keyword
  • url - Page of the domain that ranks for the keyword
Metrics:
  • volume - Average monthly search volume for the keyword
  • cpc - Average cost per click paid by advertisers for the keyword
  • sd - SEO difficulty (0-100): how hard it is to rank organically
  • pd - Paid difficulty (0-100): how competitive the keyword is in paid search
  • traffic - Estimated monthly visits the domain gets from this keyword
  • search_intent - Intent behind the search (Informational, Navigational, Commercial, Transactional)
Highest-traffic pages of each configured domain.Key Fields:
  • domain - Domain the page belongs to
  • url - Full URL of the page
  • path - Path of the page within the domain
  • title - Title tag of the page
Metrics:
  • traffic - Estimated monthly organic visits to the page
  • backlinks - Number of backlinks pointing to the page
  • refdomains - Number of distinct domains linking to the page
  • facebook_shares - Number of times the page was shared on Facebook
  • pinterest_shares - Number of times the page was shared on Pinterest
  • reddit_shares - Number of times the page was shared on Reddit
  • has_www - Whether the ranking URL uses the www subdomain
Domains competing for the same organic keywords as each configured domain.Key Fields:
  • domain - Configured domain the comparison is made against
  • competitor_domain - Domain competing for the same keywords
Overlap:
  • common_keyword_count - Number of keywords both domains rank for
  • gap_keyword_count - Number of keywords the competitor ranks for and the configured domain does not
Competitor metrics:
  • traffic - Estimated monthly organic visits of the competitor
  • organic - Number of keywords the competitor ranks for organically
  • backlinks - Total number of backlinks pointing to the competitor
  • domain_authority - Domain authority score (0-100) of the competitor
Search metrics for each configured keyword.Key Fields:
  • keyword - Search term the metrics refer to
  • language - Language code the metrics were requested for (for example pt)
  • loc_id - Ubersuggest location identifier the metrics were requested for
  • language_name - Human-readable language name returned by Ubersuggest
  • location_name - Human-readable location name returned by Ubersuggest
Metrics:
  • search_volume - Average monthly search volume for the keyword
  • cpc - Average cost per click paid by advertisers for the keyword
  • seo_difficulty - SEO difficulty (0-100): how hard it is to rank organically
  • paid_difficulty - Paid difficulty (0-100): how competitive the keyword is in paid search
  • competition - Advertiser competition for the keyword, from 0 (low) to 1 (high)
  • search_intent - Intent behind the search (Informational, Navigational, Commercial, Transactional)
Nested data (JSON strings):
  • monthly_searches - Search volume per month, each entry with period (YYYYMM) and volume
Search engine results page for each configured keyword.Key Fields:
  • keyword - Search term the result page refers to
  • language - Language code the results were requested for (for example pt)
  • loc_id - Ubersuggest location identifier the results were requested for
  • position - Rank of this result within the search results page
Result:
  • url - URL of the ranking page
  • title - Title shown for the result in the search results
  • domain - Domain of the ranking page
  • type - Type of the result, such as organic
  • clicks - Estimated monthly clicks the result receives; -1 when Ubersuggest has no estimate
  • domain_authority - Domain authority score (0-100) of the ranking domain
Social shares:
  • facebook_shares - Number of times the page was shared on Facebook
  • pinterest_shares - Number of times the page was shared on Pinterest
  • reddit_shares - Number of times the page was shared on Reddit