CONNECT APP
Build with DataForSEO
Business Management
- API key
MCP
Give your agent DataForSEO tools
Every DataForSEO action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's DataForSEO account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "dataforseo",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Create OnPage Task:
const result = await mcp.callTool({
name: "dataforseo-create-onpage-task",
arguments: {
target: "Target",
maxCrawlPages: 10,
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "dataforseo",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Create OnPage Task:
result = await session.call_tool("dataforseo-create-onpage-task", {
"target": "Target",
"maxCrawlPages": 10,
})API PROXY
Call the DataForSEO API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the DataForSEO API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.dataforseo.com/v3/appendix/user_data",
})
// Any allowed DataForSEO endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.dataforseo.com/v3/appendix/user_data
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZGF0YWZvcnNlby5jb20vdjMvYXBwZW5kaXgvdXNlcl9kYXRh?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run DataForSEO actions from your backend
Connect a user's DataForSEO account once, then run Create OnPage Task on their behalf from your own code — TypeScript, Python, or plain HTTP.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "dataforseo-create-onpage-task",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
dataforseo: { authProvisionId: "apn_xxxxxxx" },
target: "Target",
maxCrawlPages: 10,
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="dataforseo-create-onpage-task",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"dataforseo": {"authProvisionId": "apn_xxxxxxx"},
"target": "Target",
"maxCrawlPages": 10,
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "dataforseo-create-onpage-task",
"configured_props": {
"dataforseo": { "authProvisionId": "apn_xxxxxxx" },
"target": "Target",
"maxCrawlPages": 10
}
}'TOOLS
DataForSEO actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Create OnPage Task
actionCreate an OnPage task to retrieve detailed information on how well your pages are optimized for search. See the documentationWritev0.0.1 -
Get App Intersection
actionCompare keyword overlap between mobile apps to find shared ranking opportunities. See the documentationRead-onlyv0.0.3 -
Get App Reviews Summary
actionGet app reviews and ratings summary for mobile app reputation analysis. See the documentationRead-onlyv0.0.3 -
Get Backlinks
actionGet a list of backlinks and relevant data for a given domain, subdomain, or webpage. See the documentationRead-onlyv0.0.3 -
Get Backlinks History
actionGet historical backlinks data back to the beginning of 2019. See the documentationRead-onlyv0.0.4 -
Get Backlinks Summary
actionGet an overview of backlinks data available for a given domain, subdomain, or webpage. See the documentationRead-onlyv0.0.3 -
Get Bing Organic Results
actionRetrieve Bing organic search results for specified keywords. See the documentationRead-onlyv0.0.2 -
Get Bulk Backlinks
actionGet the number of backlinks pointing to specified domains, subdomains, and pages. See the documentationRead-onlyv0.0.3 -
Get Bulk Ranks
actionGet rank scores of specified domains, subdomains, and pages. See the documentationRead-onlyv0.0.3 -
Get Bulk Referring Domains
actionGet the number of referring domains pointing to the specified domains, subdomains, and pages. See the documentationRead-onlyv0.0.3 -
Get Bulk Spam Score
actionGet spam scores of the specified domains, subdomains, and pages. See the documentationRead-onlyv0.0.3 -
Get Bulk Traffic Analytics
actionGet traffic estimates and analytics for multiple domains in bulk. See the documentationRead-onlyv0.0.2 -
Get Business Listings
actionGet Business Listings. See the documentationRead-onlyv0.0.4 -
Get Business Listings Categories
actionGet available business categories for business listings and local SEO. See the documentationRead-onlyv0.0.2 -
Get Categories Aggregation
actionGet information about groups of related categories and the number of entities in each category. See the documentationRead-onlyv0.0.3 -
Get Competitor Domains
actionFind competing domains for specified keywords or target domain. See the documentationRead-onlyv0.0.2 -
Get Content Citations
actionFind mentions and citations of keywords or brands online for brand monitoring and content strategy. See the documentationRead-onlyv0.0.2 -
Get Content Summary
actionGet content performance metrics and summary for content strategy optimization. See the documentationRead-onlyv0.0.2 -
Get Crawled Pages with OnPage
actionGet page-specific data with detailed information on how well your pages are optimized for search. See the documentationRead-onlyv0.0.2 -
Get Domain Intersection
actionCompare keyword overlap between multiple domains to find shared ranking opportunities. See the documentationRead-onlyv0.0.3 -
Get Domain Keywords
actionGet all keywords a domain ranks for in organic search results. See the documentationRead-onlyv0.0.2 -
Get Domain Pages Summary
actionGet detailed summary data on all backlinks and related metrics for each page of the specified domain or subdomain. See the documentationRead-onlyv0.0.3 -
Get Domain Rank Overview
actionRetrieve domain authority and ranking metrics for specified domains. See the documentationRead-onlyv0.0.2 -
Get Domain Whois Overview
actionGet domain registration data and ownership information. See the documentationRead-onlyv0.0.2 -
Get Google Ads Ad Traffic By Keyword
actionRetrieve estimates for impressions, clicks, and cost-per-click for specified keywords, aiding in assessing keyword demand. See the documentationRead-onlyv0.0.2 -
Get Google Ads Keywords For Keywords
actionRetrieve keywords related to specified terms, helping you discover new keyword opportunities. See the documentationRead-onlyv0.0.2 -
Get Google Ads Keywords For Keywords Completed Tasks
actionRetrieve the results of completed 'Keywords For Keywords' tasks, providing related keywords for previously submitted keyword requests. See the documentationRead-onlyv0.0.2 -
Get Google Ads Keywords For Site Completed Tasks
actionRetrieve the results of completed 'Keywords For Site' tasks, which haven't been collected yet. See the documentationRead-onlyv0.0.2 -
Get Google Ads Languages
actionRetrieve a list of languages supported by the Google Ads API, allowing you to specify language targeting in your requests. See the documentationRead-onlyv0.0.2 -
Get Google Ads Locations
actionRetrieve a list of available locations supported by the Google Ads API, which can be used to specify geographic targeting in your requests. See the documentationRead-onlyv0.0.2 -
Get Google Ads Search Volume
actionRetrieve search volume data for specified keywords from Google Ads. See the documentationRead-onlyv0.0.2 -
Get Google Ads Search Volume Completed Tasks
actionRetrieve the results of completed 'Search Volume' tasks, which haven't been collected yet. See the documentationRead-onlyv0.0.2 -
Get Google Ads Status
actionCheck the status of Google Ads data updates, indicating whether the keyword data has been refreshed for the previous month. See the documentationRead-onlyv0.0.2 -
Get Google Ads Traffic By Keywords Completed Tasks
actionRetrieve the results of completed 'Ad Traffic By Keywords' tasks, which haven't been collected yet. See the documentationRead-onlyv0.0.2 -
Get Google Images Results
actionRetrieve Google Images search results for specified keywords. See the documentationRead-onlyv0.0.2 -
Get Google My Business Info
actionGet detailed Google My Business listing information for local SEO analysis. See the documentationRead-onlyv0.0.2 -
Get Google News Results
actionRetrieve Google News search results for specified keywords. See the documentationRead-onlyv0.0.2 -
Get Google Organic Results
actionRetrieve Google organic search results for specified keywords. See the documentationRead-onlyv0.0.2 -
Get Google Play Search
actionSearch Google Play Store apps by keywords for app store optimization (ASO) analysis. See the documentationRead-onlyv0.0.2 -
Get Google Reviews
actionGet Google business reviews and ratings for local SEO and reputation management. See the documentationRead-onlyv0.0.2 -
Get Historical SERP Data
actionGet ranking history for keywords over time. See the documentationRead-onlyv0.0.2 -
Get Keyword Data Errors
actionRetrieve information about the Keywords Data API tasks that returned an error within the past 7 days See the documentationRead-onlyv0.0.3 -
Get Keyword Data ID List
actionRetrieve the list of IDs and metadata of the completed Keywords Data tasks during the specified period. See the documentationRead-onlyv0.0.3 -
Get Keyword Difficulty
actionGet Keyword Difficulty. See the documentationRead-onlyv0.0.4 -
Get Keyword Ideas Live
actionGenerate live keyword suggestions and ideas for content strategy. See the documentationRead-onlyv0.0.2 -
Get Keyword Suggestions
actionGet keyword ideas and related terms for specified seed keywords. See the documentationRead-onlyv0.0.2 -
Get Ranked Keywords
actionDescription for get-ranked-keywords. See the documentationRead-onlyv0.0.4 -
Get Referring Domains
actionGet detailed overview of referring domains pointing to the specified target. See the documentationRead-onlyv0.0.3 -
Get Sentiment Analysis
actionAnalyze sentiment of brand mentions and content for reputation management. See the documentationRead-onlyv0.0.2 -
Get Technologies Domain List
actionGet technologies used by a domain (CMS, analytics, frameworks, etc.). See the documentationRead-onlyv0.0.2 -
Get Top SERP Results
actionGet top-ranking pages and competitor analysis for specified keywords. See the documentationRead-onlyv0.0.2 -
Get Trustpilot Reviews
actionGet Trustpilot business reviews and ratings for reputation management. See the documentationRead-onlyv0.0.2 -
Get Yahoo Organic Results
actionRetrieve Yahoo organic search results for specified keywords. See the documentationRead-onlyv0.0.2 -
List Language Code Options
actionRetrieves available options for the Language Code field.Read-onlyv0.0.1 -
List Location Code Options
actionRetrieves available options for the Location Code field.Read-onlyv0.0.1 -
Parse Page Content with OnPage
actionParse the content on any page and return its structured content. See the documentationWritev0.0.5 -
Search Business Listings
actionGet information about business entities listed on Google Maps. See the documentationRead-onlyv0.0.3
EVENTS
DataForSEO triggers
Event sources your backend can deploy for users and receive through a webhook.
No DataForSEO triggers are available yet.
MULTI-APP
Use DataForSEO with other popular apps
Most products don't stop at one integration. Pair DataForSEO with the other apps your users rely on, and ship use cases that span both.
- App slug
- dataforseo
- Authentication
- API key
- Categories
- Business Management
- Actions
- 57
- Triggers
- 0
- API proxy
- Available