DataForSEO is an SEO and marketing data provider, empowering businesses with invaluable insights via APIs and databases.
npm install n8n-nodes-dataforseoDataForSEO 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.
Connect DataForSEO to n8n
--------------------------
- DataForSEO account
- n8n installed or cloud account
To establish the connection, you must:
1. Obtain your DataForSEO API credentials.
2. Establish the connection in n8n.
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.
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:
Example DataForSEO Workflow Configurations
--------------------------
This section provides examples of commonly used DataForSEO operations along with detailed descriptions of their configuration parameters.
#### Backlinks
+ Get Backlinks
+ Get Backlink Summary
+ Get Historical Backlink Summary
+ Get Bulk Backlink Rank
+ Get Bulk Backlink Stats
+ Get Backlinks Pages Summary
+ Get Bulk Referring Domain Stats
+ Get Referring Domains
+ Get Bulk Spam Scores
#### SERP
+ Get Parsed SERP
+ Get Finance Explore
+ Get Finance Markets
+ Get Finance Quote
+ Search Google Finance Tickers
+ Get Google AI Mode SERP
#### Business Data
+ Search Business Listings
+ Get Business Listings Categories Aggregation
+ Get Google Reviews
#### On Page
+ Get Page Audit Check
+ Parse Page Content
#### DataForSEO Labs
+ Get Domain Rank Overview
+ Get Keyword Suggestions
+ Get Ranked Keywords
+ Get Keyword Difficulty
+ Get Organic Traffic Stats
+ Get Historical Traffic Stats
+ Get Keyword Ideas
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 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 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 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 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 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 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 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 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://).
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 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 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 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 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 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.
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 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.
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).
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.
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.
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 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 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 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 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 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 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.