Note: Information on the existing SEOmonitor Looker connectors can be found in the dedicated article.
Early Access Information
The new, unified SEOmonitor Data Connector is currently undergoing the review process for the Looker Studio marketplace. It may not yet be visible when searching the public gallery.
If you would like to start using the new connector immediately, please contact our Support team, and we will provide you with a direct installation link for early access.
Upcoming update: October 2025
The SEOmonitor Data Connector for Looker Studio allows you to pull comprehensive data from the SEOmonitor API directly into your reports. This enables you to visualize your SEO performance metrics—like Visibility, rankings, organic traffic, forecasts, and AI Overview data—and blend them with other sources.
Our new unified connector replaces the previous separate connectors (Campaign, Competition, Organic Traffic, Forecast) and provides access to all available SEOmonitor API endpoints through a single integration.
Here’s how to set it up.
Prerequisites: Generating Your API Token
Before you start in Looker Studio, you need your SEOmonitor API Token.
Log in to your SEOmonitor account.
Click on the top-right dropdown menu and select Edit Profile.
On the Profile screen, locate the API Token section.
If the token is not generated, click Generate API Token.
Click Copy to copy the token to your clipboard.
Step-by-Step Setup Guide
1. Install the Connector
Login to your Looker Studio account.
Select Create > Data source.
In the Search bar, enter seomonitor.
Locate the SEOmonitor and select it.
Note: You may still see older, legacy connectors (like "Campaign" or "Forecast"). We recommend using the new unified "SEOmonitor" for access to all features.
2. Authorize the Connector
You will be prompted to authorize the connection. Click Authorize.
A new window will appear asking for your API Token (sometimes labeled API Key). Paste the token you copied from your SEOmonitor Edit profile.
Click Submit.
3. Configuration Step 1: Select Data Endpoint
Once authorized, you will begin the configuration process. The new connector uses a dynamic setup based on the data you want to import.
Rename the Data Source: We strongly recommend renaming the data source now (at the top left, where it says "Untitled Data Source") for better organization (e.g., "SEOmonitor - ClientName - Daily Ranks").
Select API Endpoint: This is the crucial step. Use the dropdown menu under API Endpoint to choose the specific dataset you want to import. The options are categorized by module (e.g., [Rank Tracker], [Organic Traffic], [Research]).
Click Next.
4. Configuration Step 2: Parameters and Campaign
After selecting an endpoint, the connector dynamically loads the required parameters for that specific dataset.
Campaign Selection:
If the chosen endpoint requires a campaign (most do), you will see a Campaign dropdown. The connector automatically fetches your active campaigns.
Select the desired campaign from the list (no need to look up the ID).
Additional Parameters:
Fill in any other required (marked with *) or optional parameters, such as:
group_id: To filter data for a specific keyword group.
forecast_id: Required for forecast data.
device: To select 'desktop' or 'mobile'.
limit: To set the maximum number of records.
start_date / end_date: (Optional) The connector fully supports the Looker Studio Date Range Control. We recommend leaving these blank here and controlling the dates within your report for dynamic filtering.
[Image Placeholder: Screenshot of the connector configuration screen titled "STEP 2: CONFIGURE [Endpoint Name]". The "Campaign" dropdown is highlighted, showing an automatically populated list of campaign names. Other parameters like Start Date and Limit are also visible.]
5. Connect and Create Report
Once all parameters are set, click the Connect button in the top right corner.
Looker Studio will fetch the schema (the list of available fields). Review the fields and their types.
Click Create Report to start building your visualization.
FAQs and Endpoint Reference
How do I change the API Endpoint or Campaign later?
To change the data source (API Endpoint) or the Campaign for an existing connection:
Go to the Looker Studio home page and navigate to Data sources.
Click on the SEOmonitor data source you wish to edit.
In the configuration screen, click Edit Connection (top left).
You can now adjust the API Endpoint, Campaign, or other parameters.
Click Reconnect (top right) to apply the changes. Looker Studio will notify you of any fields added or removed.
How do I update my API Token?
If you regenerate your SEOmonitor API token, the connector will fail to fetch data. You must update the key in Looker Studio:
Go to the Looker Studio home page and navigate to Data sources.
Find your SEOmonitor data source.
Click the three dots menu (⋮) next to the data source and select Revoke access.
Confirm by clicking Revoke.
Now, click on the data source name to open it, and then click Edit Connection.
You will be prompted to Authorize again. Follow the authorization steps (Step 2 above) and enter your new API key.
What data can I import using the unified connector? (Endpoint Reference)
The unified connector provides access to a vast array of data points across the SEOmonitor platform. Here is a summary of the key endpoints available:
[Dashboard]
Get Tracked Campaigns: List of active campaigns with visibility metrics (7/30 days), keyword counts, objective status, and account manager details.
[Rank Tracker]
Get Keyword Data: Comprehensive data for active keywords (ranks, search volume, SERP features, traffic).
Get Daily Keyword Ranks: Historical daily desktop and mobile ranks for keywords.
Get Daily Group Visibility: Historical daily Visibility trends and average ranks for keyword groups.
Get Keyword AI Overview (AIO) Data: AI Overview presence, content, and cited links for tracked keywords.
Get Groups Data: Aggregated search volume, SERP features, Visibility, and Opportunity scores for keyword groups.
Get Keywords Competition Data: Competitor rankings, trends, and landing pages for your tracked keywords.
Get Daily SERP Feature Presence: Historical data showing which SERP features appeared and if your website was listed.
Get Daily Share of Clicks: Daily click share distribution between your domain and top competitors.
Get Ranking Pages: List of all URLs ranking for tracked keywords.
Get Top 100 Results: The full Top 100 SERP results for specific keywords on a given date.
Get Groups List: The hierarchical structure of all your keyword groups and folders.
[Organic Traffic]
Get Daily Traffic Data by Segment: Daily sessions, conversions, and revenue segmented by Brand, Non-Brand, or custom segments.
Get Traffic Data by Keywords: Keyword-level traffic metrics (impressions, clicks, sessions, conversions) from GSC/GA integrations.
[Forecast]
Get Forecast Objective Data: Detailed data for the scenario set as the campaign Objective (actual vs. estimated results).
Get Forecast Scenario Data: Details of a specific Forecast Scenario, including configuration and monthly estimates.
Get Forecast Keywords: Data for keywords included in a specific scenario (target ranks, additional traffic estimates).
Get Forecast Scenarios: A list of all scenarios created in a campaign.
[Research]
Get Keyword Data: SERP, search, and ranking data for a specific list of keywords.
Get Ranking Keywords (Gap Analysis): Keywords where a specified competitor domain or URL ranks in the top 100.
Get Related Keywords: Keywords related to a specified topic, including connection strength.
Topic Overview: Aggregated data for all keywords related to a specific topic.
URL/Domain Overview: Aggregated performance overview for a specific competitor domain or URL.
[Keyword Vault]
Get Keyword Data by List: Data for keywords saved in a specific Vault list.
Get Overview Data: Aggregated search, SERP, and Visibility data for a specified Vault list.