Skip to content

dataforseo/n8n-nodes-dataforseo

BranchesTags

Repository files navigation

DataForSEO Node for n8n

With the DataForSEO node in n8n, you can retrieve marketing and SEO data, such as Google rankings, keyword suggestions, backlink reports, etc., through the DataForSEO API.

To use the DataForSEO node, you must have a DataForSEO account. You can create an account at dataforseo.com.

Refer to the DataForSEO API documentation for the list of available endpoints.

Contents

Connect DataForSEO to n8n

Prerequisites

  • DataForSEO account
  • n8n installed or cloud account

Setup

To establish the connection, you must:

  1. Obtain your DataForSEO API credentials.

  2. Establish the connection in n8n.

Obtain Your DataForSEO API Credentials

To obtain your DataForSEO API credentials (API login and password):

  1. Log in to your DataForSEO account dashboard.

  2. In the left sidebar, click API Access.

  3. Copy the API Login and API Password values shown and store them in a safe place.

Note that the API password is visible for the first 24 hours after registration. Later, you can request the password by clicking “Send by e-mail,” then copy the credentials from it.

Enter these values in the API Login and API Password fields in n8n.

Establish the connection with DataForSEO in n8n

To establish the connection in n8n:

  1. Log in to your n8n account, add a DataForSEO node to your workflow, and click Create new credential.

  2. Optional: Rename the credential.

  3. In the API Login and API Password fields, enter the values copied above.

  4. Click Save.

You have successfully established the connection. You can now build workflows using DataForSEO operations.

Available DataForSEO Operations

After connecting the app, you can perform the following operations:

DataForSEO SERP API

Google

Bing

YouTube

Yahoo

Baidu

Naver

Seznam

DataForSEO Keywords Data API

Google Ads

Bing Ads

Google Trends

DataForSEO Trends

Clickstream Data

DataForSEO Domain Analytics API

Technologies

Whois

DataForSEO Labs API

Google

Amazon

Bing

Google Play

App Store

DataForSEO Backlinks API

DataForSEO OnPage API

DataForSEO Content Analysis API

DataForSEO Content Generation API

DataForSEO Merchant API

Google Shopping

Amazon

DataForSEO App Data API

Google

Apple

DataForSEO Business Data API

Business Listings

Google

Trustpilot

Tripadvisor

Social Media

Example DataForSEO Workflow Configurations

This section provides examples of commonly used DataForSEO operations along with detailed descriptions of their configuration parameters.

Backlinks

SERP

Business Data

On Page

DataForSEO Labs

Get Backlinks

Get a list of backlinks for a domain, subdomain, or page.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

  • Mode: Select the grouping type for the results (As is: Returns all backlinks, One Per Domain: Returns one backlink per domain, One Per Anchor: Returns one backlink per anchor). If not specified, the As is option will be selected by default.

  • Limit (up to 1000): Enter the maximum number of returned backlinks.

  • Offset: Enter the offset in the results array for returned backlinks. The default value is 0. If set to 10, the first 10 backlinks will be skipped, and the results will start from the subsequent backlink.

  • Sort: Select the sorting rules for the results.

  • Backlink Status: Select the backlink status to return and count (All: All backlinks will be returned and counted, Live: Backlinks found during the last check will be returned and counted, Lost: Lost backlinks will be returned and counted). If not specified, the Live option will be selected by default.

  • Include Subdomains (Optional): Select whether to include subdomains of the target in the search.

  • Include Indirect Links (Optional): Select whether to include indirect links in the results.

Get Backlink Summary

Get an overview of backlink data for a domain, subdomain, or webpage.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

  • Include Subdomains (Optional): Select whether to include subdomains of the target in the search.

  • Include Indirect Links (Optional): Select whether to include indirect links in the results.

  • Internal List limit (up to 1000): Enter the number of backlinks to be returned in the results.

  • Backlink Status: Select the backlink status to return and count (All: All backlinks will be returned and counted, Live: Backlinks found during the last check will be returned and counted, Lost: Lost backlinks will be returned and counted).

Get Historical Backlink Summary

Get historical backlink data for a domain dating back to the beginning of 2019.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

  • Date From: Enter the starting date of the time range. Minimal value: 2019-01-01. The minimum value will be used by default. Time zone: Europe/Prague.

  • Date To: Enter the ending date of the time range. If you don’t specify this field, today’s date will be used by default. Time zone: Europe/Prague.

Get Bulk Backlink Rank

Get rank scores for up to 1,000 domains, subdomains, and pages.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

Get Bulk Backlink Stats

Get the number of backlinks for up to 1,000 domains, subdomains, and pages.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

Get Backlinks Pages Summary

Get an overview of backlinks and associated data in bulk.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

  • Include Subdomains (Optional): Select whether to include subdomains of the target in the search.

Get Bulk Referring Domain Stats

Get the number of referring domains for up to 1,000 domains, subdomains, and pages.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

Get Referring Domains

Get a detailed overview of referring domains pointing to the target you specify.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

  • Limit (up to 1000): Enter the maximum number of returned backlinks.

  • Offset: Enter the offset in the results array for returned backlinks. Default is 0. For example, if set to 10, the first 10 backlinks will be skipped, and the results will start from the subsequent backlink.

  • Internal List limit ( up to 1000): Enter the number of backlinks to be returned in the results.

  • Backlink Status: Select the backlink status to return and count ( All: All backlinks will be returned and counted, Live: Backlinks found during the last check will be returned and counted, Lost: Lost backlinks will be returned and counted). If not specified, the Live option will be selected by default.

  • Sort: Enter (map) the sorting rules for the results.

  • Include Subdomains (Optional): Select whether to include subdomains of the target in the search.

  • Include Indirect Links (Optional): Select whether to include indirect links in the results.

  • Exclude Internal Links (Optional): Select whether to include external links in the results.

Get Bulk Spam Scores

Get Spam Scores for up to 1,000 domains, subdomains, and pages.

  • Target (domain, subdomain, URL): Enter the domain, subdomain, or webpage to get backlinks for. A domain or a subdomain should be specified without https:// and www. A page should be specified with an absolute URL (including http:// or https://).

SERP

Get Parsed SERP

Get Google Search results for the specified keyword.

  • Keyword: Enter a keyword for parsing the SERP. You can specify up to 700 symbols.

  • Location: Enter the full name of the search engine location. You can find the supported locations on the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages on the DataForSEO Supported Languages page.

  • Device: Select your device type (Desktop, Mobile).

  • OS: Select your device's operating system (Windows, macOS, Android, iOS).

  • Domain: Enter the search engine domain. For example: google.co.uk, google.com.au, google.de, etc. Note: We automatically select the relevant search engine domain according to the location and language you specify. However, you can set a custom search engine domain in this field.

  • Depth: Enter parsing depth, number of results in SERP, max value is 700.

  • Target: Enter the target domain, subdomain, or webpage. Note: Domain or a subdomain should be specified without https:// and www..

Get Finance Explore

Get real-time data from the ‘Explore’ tab of Google Finance.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • News Type: Select news type.

Get Finance Markets

Get real-time data from the ‘Markets’ tab of Google Finance.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Market Type: Select market type.

Get Finance Quote

Get real-time data from the ‘Quote’ tab of Google Finance.

  • Keyword (Ticker or Stock Symbol): Enter the Ticker symbol of publicly traded shares of a particular stock or security in a specific stock exchange.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Window: Select time window for google_finance_quote graph.

Search Google Finance Tickers

Search by company name, market, or financial instrument to get Google Finance data on stocks, futures, and asset pairs, their value, growth trends, and identifiers.

  • Keyword: Enter Company name or financial instrument.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Category: Select the Category of financial instruments to search for.

Get Google AI Mode SERP

Get search results from the AI Mode feature of Google Search.

  • Keyword: Keyword to get results for.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Device: Select your device type (Desktop, Mobile).

  • OS: Select your device's operating system (Windows, macOS, Android, iOS).

  • Calculate Pixel Rankings for SERP Elements?: By default, the parameter is set to false.

  • Browser Screen Width: You can set a custom browser screen width to calculate pixel rankings for a particular device.

  • Browser Screen Height: You can set a custom browser screen height to calculate pixel rankings for a particular device.

  • Browser Screen Resolution Ratio: You can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device.

Business Data

Get Search Business Listings

Get information about businesses listed on Google Maps in the specified categories.

  • Categories: Enter up to 10 categories for the business listings, allowing you to specify relevant business categories.

  • Description: Enter a description for the business listing.

  • Title: Enter the title for the business listing.

  • Is Claimed: Select whether the business listing is claimed.

  • Location Coordinate: Enter location coordinates in the format latitude,longitude,radius. Example: 53.476225,-2.243572,200.

  • Sort: Select the sorting rules for the results. You can specify multiple sorting criteria by adding items.

  • Limit (up to 1000): Enter the maximum number of returned listings.

  • Offset: Enter the offset in the results array for returned listings.

Get Business Listings Categories Aggregation

Get data about groups of related business categories along with the number of entities in each category.

  • Categories: Enter up to 10 categories for the business listings, allowing you to specify relevant business categories.

  • Description: Enter a description for the business listing.

  • Title: Enter the title for the business listing.

  • Is Claimed: Select whether the business listing is claimed.

  • Location Coordinate: Enter location coordinates in the format latitude,longitude,radius. Example: 53.476225,-2.243572,200.

  • Internal List Limit: Enter the number of business listings to be returned in the aggregated results.

  • Limit (up to 1000): Enter the maximum number of results to be returned.

  • Offset: Enter the offset in the results array.

Get Google Reviews

Fetch reviews and related data from millions of Google Business Profiles around the world.

  • Search By: Select the method for searching Google reviews (Keyword, CID, Place ID).

  • Keyword/CID/Place ID: Enter the keyword, CID, or Place ID for the business or place you want to retrieve reviews for.

  • Task Priority: Select the task priority for the request. You will be additionally charged for the tasks with high execution priority.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Number of reviews: Enter the number of reviews to retrieve.

  • Sort: Select the sorting criteria for the reviews (Newest, Highest Rating, Lowest Rating, Relevance).

On Page

Get Page Audit Check

Run an essential SEO Audit of a page.

  • Target page URL: Enter the complete URL of the target page for which the data will be retrieved.

Parse Page Content

Get parsed and structured content of any page, including link URLs, anchors, headings, and text.

  • Target page URL: Enter the complete URL of the page to be parsed.

Labs

Get Domain Rank Overview

Get ranking and traffic data from organic search for a domain.

  • Target Domain: Enter the target domain to retrieve the rank overview. The domain should be specified without https:// or www.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Ignore Synonyms: Select whether to ignore synonyms in the search results.

  • Limit: Enter the maximum number of results to retrieve.

  • Offset: Enter the offset in the results array. For example, if set to 10, the first 10 results will be skipped, and the data will start from the subsequent result.

Get Keyword Suggestions

Get search terms that are relevant to the product or service categories of all the specified keywords.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Keyword: Enter the keyword for which you want to retrieve suggestions.

  • Limit (up to 1000): Enter the maximum number of keyword suggestions to retrieve.

  • Offset: Enter the offset in the results array. For example, if set to 10, the first 10 results will be skipped, and the data will start from the subsequent result.

  • Sort: Enter the sorting criteria for keyword suggestions.

Get Ranked Keywords

Get the list of keywords that any domain or webpage is ranking for.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Target: Enter the domain name of the target website. The domain should be specified without https:// or www.

  • Limit (up to 1000): Enter the maximum number of keywords to retrieve.

  • Item Types: Select the type of search results included in the response.

  • Sort: Enter the sorting criteria for keyword rankings.

  • Ignore Synonyms: Select whether to ignore synonyms in the search results.

Get Keyword Difficulty

Get keyword difficulty for the specified keywords.

  • Target Keywords: Enter the keywords you want to analyze for difficulty. Keywords should be in UTF-8 encoding, at least three characters long, and will be converted to lowercase. You can specify up to 1000 keywords."

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

Get Organic Traffic Stats

Get an estimation of the monthly organic traffic for a website or page.

  • Target Domain or Subdomains: Enter the target domain to retrieve the organic traffic stats. The domain should be specified without https:// or www.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Item Types: Select the type of search results included in the response.

Get Historical Traffic Stats

Get a historical estimate of organic traffic for a website or page.

  • Target Domain or Subdomains: Enter the target domain to retrieve the organic traffic stats. The domain should be specified without https:// or www.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Item Types: Select the type of search results included in the response.

Get Keyword Ideas

Get search terms that fall into the same Google product or service category as the specified keywords.

  • Keywords: Enter the keywords you want to retrieve suggestions for.

  • Location: Enter the full name of the search engine location. You can find the supported locations in the DataForSEO Supported Locations page.

  • Language: Enter the full name of the search engine language. You can find the list of supported languages in the DataForSEO Supported Languages page.

  • Limit (up to 1000): Enter the maximum number of keyword ideas to retrieve.

  • Offset: Enter the offset in the results array. For example, if set to 10, the first 10 results will be skipped, and the data will start from the subsequent result.

  • Sort: Enter the sorting criteria for keyword ideas.

About

n8n node for SEO & marketing data (rankings, keywords, backlinks) via DataForSEO API

dataforseo.com/

Resources

Readme

License

MIT license

Code of conduct

Code of conduct
Activity
Custom properties

Stars

11 stars

Watchers

2 watching

Forks

4 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages