Menu

Mattering Automations DataForSEO integration

Connect DataForSEO to Mattering Automations: SERPs, keyword data, Labs research, backlinks, on-page crawls, and domain analytics as workflow steps and agent tools.

Get the credential Connect Verify Node reference Troubleshooting

The Mattering Automations DataForSEO integration covers the v3 API in depth: live Google, Bing, and YouTube SERPs, Google Ads keyword data, the DataForSEO Labs research suite, backlinks, on-page crawl audits, domain analytics, and task-based merchant, app store, and business data.

Setup is your DataForSEO API login and password. Mattering runs this connector itself: our own SEO pipeline scores keywords and researches competitors through these exact nodes.

Before you start

  • A DataForSEO account with a prepaid balance at dataforseo.com.
  • A Mattering workspace with access to the Automations app.

Get your DataForSEO API credentials

The connector authenticates with HTTP Basic auth using your DataForSEO API login and API password (these are separate from your account login).

Sign in to the DataForSEO dashboard and open the API Access page.
Copy your API login and API password.
DataForSEO bills per request against your prepaid balance, with prices varying by endpoint. The nodes surface the cost field DataForSEO returns on each response, so a workflow can log exactly what each run spent.

Connect DataForSEO to Mattering

In Mattering Automations, open Connectors and click Add Connector.
Choose DataForSEO from the list.
Click Create new credential and enter your API login as the username and API password as the password, then save. The credential is stored encrypted in Google Secret Manager.
Click Connect. The DataForSEO nodes appear in your canvas palette.

Verify it works

Open an automation canvas and drop a Safe Read node like DataForSEO: SERP Google Organic Live Advanced onto it. Set a keyword and location, then run a test step: a successful response returns the SERP results and a cost value.

For task-based endpoints (some SERP modes, on-page crawls, reviews), a task_post node submits the job, a tasks_ready node reports completion, and a task_get node retrieves results, which maps onto scheduled or looping steps.

Node reference

86 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 76

DataForSEO Backlinks: Anchors

dfs_backlinks_anchors

Anchor-text distribution.

DataForSEO Backlinks: Backlinks

dfs_backlinks_backlinks

List of backlinks for a target.

DataForSEO Backlinks: Bulk Backlinks

dfs_backlinks_bulk_backlinks

Backlink counts for many targets.

DataForSEO Backlinks: Bulk Ranks

dfs_backlinks_bulk_ranks

Rank for many targets at once.

DataForSEO Backlinks: Bulk Referring Domains

dfs_backlinks_bulk_referring_domains

Referring-domain counts for many targets.

DataForSEO Backlinks: Bulk Spam Score

dfs_backlinks_bulk_spam_score

Spam score for many targets.

DataForSEO Backlinks: Competitors

dfs_backlinks_competitors

Domains with similar backlink profiles.

DataForSEO Backlinks: Domain Intersection

dfs_backlinks_domain_intersection

Referring domains shared across targets.

DataForSEO Backlinks: Domain Pages

dfs_backlinks_domain_pages

Pages of a domain with backlink data.

DataForSEO Backlinks: Domain Pages Summary

dfs_backlinks_domain_pages_summary

Aggregated backlink metrics per page.

DataForSEO Backlinks: History

dfs_backlinks_history

Historical backlink metrics.

DataForSEO Backlinks: Page Intersection

dfs_backlinks_page_intersection

Backlinks pointing to multiple pages.

DataForSEO Backlinks: Referring Domains

dfs_backlinks_referring_domains

Referring domains for a target.

DataForSEO Backlinks: Referring Networks

dfs_backlinks_referring_networks

Referring IP/subnet networks.

DataForSEO Backlinks: Summary

dfs_backlinks_summary

Backlink profile summary for a target.

DataForSEO Backlinks: Timeseries Summary

dfs_backlinks_timeseries_summary

Backlink metrics over time.

DataForSEO Business: Listings Search (Live)

dfs_business_listings_search

Search Google business listings in an area.

DataForSEO Content Analysis: Phrase Trends

dfs_content_analysis_phrase_trends

Citation volume/sentiment over time.

DataForSEO Content Analysis: Search

dfs_content_analysis_search

Find citations mentioning a keyword.

DataForSEO Content Analysis: Sentiment

dfs_content_analysis_sentiment

Sentiment breakdown for citations.

DataForSEO Content Analysis: Summary

dfs_content_analysis_summary

Aggregated citation metrics for a keyword.

DataForSEO Domain: Domains By Technology

dfs_domain_domains_by_technology

Domains using a given technology.

DataForSEO Domain: Technologies

dfs_domain_technologies

Technology stack for a domain.

DataForSEO Domain: Technology Stats

dfs_domain_technology_stats

Aggregate stats for a technology.

DataForSEO Domain: WHOIS Overview

dfs_domain_whois_overview

WHOIS + domain metrics overview.

DataForSEO Labs: Bulk Keyword Difficulty

dfs_labs_bulk_keyword_difficulty

Keyword difficulty for up to 1000 keywords.

DataForSEO Labs: Competitors Domain

dfs_labs_competitors_domain

Competitor domains for a target domain.

DataForSEO Labs: Domain Intersection

dfs_labs_domain_intersection

Keywords two domains both rank for.

DataForSEO Labs: Domain Rank Overview

dfs_labs_domain_rank_overview

Domain ranking/traffic overview.

DataForSEO Labs: Historical Rank Overview

dfs_labs_historical_rank_overview

Historical domain ranking overview.

DataForSEO Labs: Keyword Ideas

dfs_labs_keyword_ideas

Keyword ideas by seed keywords.

DataForSEO Labs: Keyword Overview

dfs_labs_keyword_overview

Overview metrics for keywords (volume, difficulty, intent).

DataForSEO Labs: Keyword Suggestions

dfs_labs_keyword_suggestions

Long-tail suggestions for a seed keyword.

DataForSEO Labs: Keywords For Site

dfs_labs_keywords_for_site

Keywords a site ranks for (Labs).

DataForSEO Labs: Ranked Keywords

dfs_labs_ranked_keywords

Keywords a domain/page ranks for.

DataForSEO Labs: Related Keywords

dfs_labs_related_keywords

'Searches related to' expansion.

DataForSEO Labs: Relevant Pages

dfs_labs_relevant_pages

Top ranking pages of a domain.

DataForSEO Labs: SERP Competitors

dfs_labs_serp_competitors

Competitors ranking for a keyword set.

DataForSEO Labs: Search Intent

dfs_labs_search_intent

Search-intent classification for keywords.

DataForSEO Labs: Subdomains

dfs_labs_subdomains

Subdomains of a domain with metrics.

DataForSEO Labs: Top Searches

dfs_labs_top_searches

Top searches database query.

DataForSEO On-Page: Content Parsing (Live)

dfs_onpage_content_parsing_live

Parse the main content of a page.

DataForSEO On-Page: Duplicate Content

dfs_onpage_duplicate_content

Duplicate content pages.

DataForSEO On-Page: Duplicate Tags

dfs_onpage_duplicate_tags

Duplicate title/description tags.

DataForSEO On-Page: Instant Pages (Live)

dfs_onpage_instant_pages

Instant single-page On-Page analysis (no crawl).

DataForSEO On-Page: Keyword Density

dfs_onpage_keyword_density

Keyword density for crawled pages.

DataForSEO On-Page: Lighthouse (Live)

dfs_onpage_lighthouse_live

Live Lighthouse audit for a URL.

DataForSEO On-Page: Links

dfs_onpage_links

Internal/external links for a task.

DataForSEO On-Page: Non-Indexable

dfs_onpage_non_indexable

Non-indexable pages.

DataForSEO On-Page: Pages

dfs_onpage_pages

Crawled pages for a task id.

DataForSEO On-Page: Resources

dfs_onpage_resources

Resources (images, scripts, etc.) for a task.

DataForSEO On-Page: Summary

dfs_onpage_summary

Crawl summary for a task id.

DataForSEO On-Page: Tasks Ready

dfs_onpage_tasks_ready

List completed On-Page tasks.

DataForSEO: Account Data

dfs_user_data

Account info, balance, and API limits.

DataForSEO: Ad Traffic By Keywords (Google Ads)

dfs_kw_google_ads_ad_traffic

Estimated ad traffic/costs for keywords.

DataForSEO: Clickstream Global Search Volume

dfs_kw_clickstream_global_search_volume

Clickstream global search volume.

DataForSEO: Clickstream Search Volume

dfs_kw_clickstream_search_volume

Clickstream-based search volume.

DataForSEO: Google Trends Explore

dfs_kw_google_trends_explore

Google Trends interest over time/region.

DataForSEO: Keywords For Keywords (Google Ads)

dfs_kw_google_ads_keywords_for_keywords

Google Ads related keywords for seed keywords.

DataForSEO: Keywords For Site (Google Ads)

dfs_kw_google_ads_keywords_for_site

Google Ads keywords for a site.

DataForSEO: Keywords Google Ads Locations

dfs_kw_google_ads_locations

Supported Google Ads locations for a country.

DataForSEO: Keywords Search Volume (Bing)

dfs_kw_bing_search_volume

Bing search volume for keywords.

DataForSEO: Keywords Search Volume (Google Ads)

dfs_kw_google_ads_search_volume

Google Ads search volume for keywords.

DataForSEO: Labs Locations & Languages

dfs_labs_locations_languages

Supported locations/languages for DataForSEO Labs.

DataForSEO: SERP Bing Organic (Live)

dfs_serp_bing_organic_live_advanced

Live Bing organic SERP.

DataForSEO: SERP Google Autocomplete (Live)

dfs_serp_google_autocomplete_live_advanced

Live Google autocomplete suggestions.

DataForSEO: SERP Google Languages

dfs_serp_google_languages

Supported Google SERP languages.

DataForSEO: SERP Google Local Finder (Live)

dfs_serp_google_local_finder_live_advanced

Live Google local finder SERP.

DataForSEO: SERP Google Locations

dfs_serp_google_locations

Supported Google SERP locations for a country.

DataForSEO: SERP Google Maps (Live)

dfs_serp_google_maps_live_advanced

Live Google Maps SERP.

DataForSEO: SERP Google News (Live)

dfs_serp_google_news_live_advanced

Live Google News SERP.

DataForSEO: SERP Google Organic (Live Advanced)

dfs_serp_google_organic_live_advanced

Live Google organic SERP, advanced (full parsed result).

DataForSEO: SERP Google Organic (Live Regular)

dfs_serp_google_organic_live_regular

Live Google organic SERP, regular.

DataForSEO: SERP Google Organic (Task Get Advanced)

dfs_serp_google_organic_task_get_advanced

Retrieve a completed Google organic SERP task (advanced).

DataForSEO: SERP Google Organic (Tasks Ready)

dfs_serp_google_organic_tasks_ready

List completed Google organic SERP tasks.

DataForSEO: SERP YouTube (Live)

dfs_serp_youtube_organic_live_advanced

Live YouTube search SERP.

Action nodes 10

DataForSEO App: App Store Searches (Task Post)

dfs_app_apple_searches_task_post

Queue an Apple App Store app-search task.

DataForSEO App: Google Play Searches (Task Post)

dfs_app_google_searches_task_post

Queue a Google Play app-search task.

DataForSEO Business: Google My Business Info (Task Post)

dfs_business_google_my_business_task_post

Queue a Google Business Profile info task.

DataForSEO Business: Google Reviews (Task Post)

dfs_business_google_reviews_task_post

Queue a Google reviews task.

DataForSEO Business: Trustpilot Reviews (Task Post)

dfs_business_trustpilot_reviews_task_post

Queue a Trustpilot reviews task.

DataForSEO Merchant: Amazon ASIN (Task Post)

dfs_merchant_amazon_asin_task_post

Queue an Amazon ASIN detail task.

DataForSEO Merchant: Amazon Products (Task Post)

dfs_merchant_amazon_products_task_post

Queue an Amazon products task.

DataForSEO Merchant: Google Products (Task Post)

dfs_merchant_google_products_task_post

Queue a Google Shopping products task.

DataForSEO On-Page: Task Post

dfs_onpage_task_post

Queue a full-site On-Page crawl.

DataForSEO: SERP Google Organic (Task Post)

dfs_serp_google_organic_task_post

Queue a Google organic SERP task.

Using the integration

On the automation canvas

Pull live SERPs, keyword volumes and difficulty, backlink profiles, and crawl audits, then feed them into the rest of a workflow: write trends to a Mattering database, open tasks for ranking drops, or hand results to an AI step.

The custom request node

An advanced custom request node can call any other v3 API path your account can access, so endpoints beyond the typed nodes stay reachable without waiting on a connector update.

From AI assistants over MCP

Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can run SEO research through the same nodes your workflows use and chain them into multi-step analysis.

Troubleshooting

A node returns status 40501 Invalid Field
The request is missing a field that endpoint requires or is passing one it rejects. Check the node config against DataForSEO's docs for that path (for example, some report endpoints require a date range, and the YouTube SERP endpoint rejects a depth value).
A node returns status 50304 function temporarily unavailable
That endpoint is disabled on DataForSEO's side. The Content Generation family and Amazon Reviews task_post were retired upstream and are no longer shipped as nodes; if you hit this on another endpoint, it is an upstream outage, not a connector bug.
The location catalog endpoints time out or fail
The global location catalogs are very large. Use the country-filtered variant (the node defaults to a country code) rather than requesting the full unfiltered catalog.
Requests fail with an authentication error
Confirm you entered the API login and API password from the DataForSEO dashboard's API Access page, not your account login. They are a separate credential pair sent as HTTP Basic auth.

Related

The DataForSEO MCP

What connecting DataForSEO unlocks for AI agents and automations, with common uses and FAQs.

More guides

All Automations documentation

Every integration guide, plus how connectors, credentials, and workflows fit together.

DataForSEO is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.

Login Start Free