# DataForSEO — Pipedream Connect

> DataForSEO aggregates data from search engines, marketplaces, review platforms, and billions of other websites across the web to provide you with unique insights for building innovative digital marketing solutions.

- API slug: `dataforseo` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Business Management
- Website: https://dataforseo.com/
- This page (HTML): https://pipedream.com/apps/dataforseo
- Tools: 57 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: dataforseo`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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,
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a DataForSEO endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# 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"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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,
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (57)

### `dataforseo-create-onpage-task` — Create OnPage Task (Write)

Create an OnPage task to retrieve detailed information on how well your pages are optimized for search. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/create-onpage-task.md

### `dataforseo-get-app-intersection` — Get App Intersection (Read-only)

Compare keyword overlap between mobile apps to find shared ranking opportunities. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-app-intersection.md

### `dataforseo-get-app-reviews-summary` — Get App Reviews Summary (Read-only)

Get app reviews and ratings summary for mobile app reputation analysis. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-app-reviews-summary.md

### `dataforseo-get-backlinks` — Get Backlinks (Read-only)

Get a list of backlinks and relevant data for a given domain, subdomain, or webpage. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-backlinks.md

### `dataforseo-get-backlinks-history` — Get Backlinks History (Read-only)

Get historical backlinks data back to the beginning of 2019. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-backlinks-history.md

### `dataforseo-get-backlinks-summary` — Get Backlinks Summary (Read-only)

Get an overview of backlinks data available for a given domain, subdomain, or webpage. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-backlinks-summary.md

### `dataforseo-get-bing-organic-results` — Get Bing Organic Results (Read-only)

Retrieve Bing organic search results for specified keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-bing-organic-results.md

### `dataforseo-get-bulk-backlinks` — Get Bulk Backlinks (Read-only)

Get the number of backlinks pointing to specified domains, subdomains, and pages. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-bulk-backlinks.md

### `dataforseo-get-bulk-ranks` — Get Bulk Ranks (Read-only)

Get rank scores of specified domains, subdomains, and pages. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-bulk-ranks.md

### `dataforseo-get-bulk-referring-domains` — Get Bulk Referring Domains (Read-only)

Get the number of referring domains pointing to the specified domains, subdomains, and pages. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-bulk-referring-domains.md

### `dataforseo-get-bulk-spam-score` — Get Bulk Spam Score (Read-only)

Get spam scores of the specified domains, subdomains, and pages. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-bulk-spam-score.md

### `dataforseo-get-bulk-traffic-analytics` — Get Bulk Traffic Analytics (Read-only)

Get traffic estimates and analytics for multiple domains in bulk. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-bulk-traffic-analytics.md

### `dataforseo-get-business-listings` — Get Business Listings (Read-only)

Get Business Listings. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-business-listings.md

### `dataforseo-get-business-listings-categories` — Get Business Listings Categories (Read-only)

Get available business categories for business listings and local SEO. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-business-listings-categories.md

### `dataforseo-get-categories-aggregation` — Get Categories Aggregation (Read-only)

Get information about groups of related categories and the number of entities in each category. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-categories-aggregation.md

### `dataforseo-get-competitor-domains` — Get Competitor Domains (Read-only)

Find competing domains for specified keywords or target domain. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-competitor-domains.md

### `dataforseo-get-content-citations` — Get Content Citations (Read-only)

Find mentions and citations of keywords or brands online for brand monitoring and content strategy. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-content-citations.md

### `dataforseo-get-content-summary` — Get Content Summary (Read-only)

Get content performance metrics and summary for content strategy optimization. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-content-summary.md

### `dataforseo-get-crawled-pages` — Get Crawled Pages with OnPage (Read-only)

Get page-specific data with detailed information on how well your pages are optimized for search. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-crawled-pages.md

### `dataforseo-get-domain-intersection` — Get Domain Intersection (Read-only)

Compare keyword overlap between multiple domains to find shared ranking opportunities. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-domain-intersection.md

### `dataforseo-get-domain-keywords` — Get Domain Keywords (Read-only)

Get all keywords a domain ranks for in organic search results. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-domain-keywords.md

### `dataforseo-get-domain-pages-summary` — Get Domain Pages Summary (Read-only)

Get detailed summary data on all backlinks and related metrics for each page of the specified domain or subdomain. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-domain-pages-summary.md

### `dataforseo-get-domain-rank-overview` — Get Domain Rank Overview (Read-only)

Retrieve domain authority and ranking metrics for specified domains. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-domain-rank-overview.md

### `dataforseo-get-domain-whois-overview` — Get Domain Whois Overview (Read-only)

Get domain registration data and ownership information. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-domain-whois-overview.md

### `dataforseo-get-google-ads-ad-traffic-by-keyword` — Get Google Ads Ad Traffic By Keyword (Read-only)

Retrieve estimates for impressions, clicks, and cost-per-click for specified keywords, aiding in assessing keyword demand. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-ad-traffic-by-keyword.md

### `dataforseo-get-google-ads-keywords-for-keywords` — Get Google Ads Keywords For Keywords (Read-only)

Retrieve keywords related to specified terms, helping you discover new keyword opportunities. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-keywords-for-keywords.md

### `dataforseo-get-google-ads-keywords-for-keywords-completed-tasks` — Get Google Ads Keywords For Keywords Completed Tasks (Read-only)

Retrieve the results of completed 'Keywords For Keywords' tasks, providing related keywords for previously submitted keyword requests. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-keywords-for-keywords-completed-tasks.md

### `dataforseo-get-google-ads-keywords-for-site-completed-tasks` — Get Google Ads Keywords For Site Completed Tasks (Read-only)

Retrieve the results of completed 'Keywords For Site' tasks, which haven't been collected yet. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-keywords-for-site-completed-tasks.md

### `dataforseo-get-google-ads-languages` — Get Google Ads Languages (Read-only)

Retrieve a list of languages supported by the Google Ads API, allowing you to specify language targeting in your requests. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-languages.md

### `dataforseo-get-google-ads-locations` — Get Google Ads Locations (Read-only)

Retrieve a list of available locations supported by the Google Ads API, which can be used to specify geographic targeting in your requests. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-locations.md

### `dataforseo-get-google-ads-search-volume` — Get Google Ads Search Volume (Read-only)

Retrieve search volume data for specified keywords from Google Ads. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-search-volume.md

### `dataforseo-get-google-ads-search-volume-completed-tasks` — Get Google Ads Search Volume Completed Tasks (Read-only)

Retrieve the results of completed 'Search Volume' tasks, which haven't been collected yet. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-search-volume-completed-tasks.md

### `dataforseo-get-google-ads-status` — Get Google Ads Status (Read-only)

Check the status of Google Ads data updates, indicating whether the keyword data has been refreshed for the previous month. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-status.md

### `dataforseo-get-google-ads-traffic-by-keywords-completed-tasks` — Get Google Ads Traffic By Keywords Completed Tasks (Read-only)

Retrieve the results of completed 'Ad Traffic By Keywords' tasks, which haven't been collected yet. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-ads-traffic-by-keywords-completed-tasks.md

### `dataforseo-get-google-images-results` — Get Google Images Results (Read-only)

Retrieve Google Images search results for specified keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-images-results.md

### `dataforseo-get-google-my-business-info` — Get Google My Business Info (Read-only)

Get detailed Google My Business listing information for local SEO analysis. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-my-business-info.md

### `dataforseo-get-google-news-results` — Get Google News Results (Read-only)

Retrieve Google News search results for specified keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-news-results.md

### `dataforseo-get-google-organic-results` — Get Google Organic Results (Read-only)

Retrieve Google organic search results for specified keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-organic-results.md

### `dataforseo-get-google-play-search` — Get Google Play Search (Read-only)

Search Google Play Store apps by keywords for app store optimization (ASO) analysis. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-play-search.md

### `dataforseo-get-google-reviews` — Get Google Reviews (Read-only)

Get Google business reviews and ratings for local SEO and reputation management. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-google-reviews.md

### `dataforseo-get-historical-serp-data` — Get Historical SERP Data (Read-only)

Get ranking history for keywords over time. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-historical-serp-data.md

### `dataforseo-get-keyword-data-errors` — Get Keyword Data Errors (Read-only)

Retrieve information about the Keywords Data API tasks that returned an error within the past 7 days See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-keyword-data-errors.md

### `dataforseo-get-keyword-data-id-list` — Get Keyword Data ID List (Read-only)

Retrieve the list of IDs and metadata of the completed Keywords Data tasks during the specified period. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-keyword-data-id-list.md

### `dataforseo-get-keyword-difficulty` — Get Keyword Difficulty (Read-only)

Get Keyword Difficulty. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-keyword-difficulty.md

### `dataforseo-get-keyword-ideas-live` — Get Keyword Ideas Live (Read-only)

Generate live keyword suggestions and ideas for content strategy. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-keyword-ideas-live.md

### `dataforseo-get-keyword-suggestions` — Get Keyword Suggestions (Read-only)

Get keyword ideas and related terms for specified seed keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-keyword-suggestions.md

### `dataforseo-get-ranked-keywords` — Get Ranked Keywords (Read-only)

Description for get-ranked-keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-ranked-keywords.md

### `dataforseo-get-referring-domains` — Get Referring Domains (Read-only)

Get detailed overview of referring domains pointing to the specified target. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-referring-domains.md

### `dataforseo-get-sentiment-analysis` — Get Sentiment Analysis (Read-only)

Analyze sentiment of brand mentions and content for reputation management. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-sentiment-analysis.md

### `dataforseo-get-technologies-domain-list` — Get Technologies Domain List (Read-only)

Get technologies used by a domain (CMS, analytics, frameworks, etc.). See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-technologies-domain-list.md

### `dataforseo-get-top-serp-results` — Get Top SERP Results (Read-only)

Get top-ranking pages and competitor analysis for specified keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-top-serp-results.md

### `dataforseo-get-trustpilot-reviews` — Get Trustpilot Reviews (Read-only)

Get Trustpilot business reviews and ratings for reputation management. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-trustpilot-reviews.md

### `dataforseo-get-yahoo-organic-results` — Get Yahoo Organic Results (Read-only)

Retrieve Yahoo organic search results for specified keywords. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/get-yahoo-organic-results.md

### `dataforseo-list-language-code-options` — List Language Code Options (Read-only)

Retrieves available options for the Language Code field.

Full schema: https://pipedream.com/apps/dataforseo/actions/list-language-code-options.md

### `dataforseo-list-location-code-options` — List Location Code Options (Read-only)

Retrieves available options for the Location Code field.

Full schema: https://pipedream.com/apps/dataforseo/actions/list-location-code-options.md

### `dataforseo-parse-page-content` — Parse Page Content with OnPage (Write)

Parse the content on any page and return its structured content. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/parse-page-content.md

### `dataforseo-search-business-listings` — Search Business Listings (Read-only)

Get information about business entities listed on Google Maps. See the documentation

Full schema: https://pipedream.com/apps/dataforseo/actions/search-business-listings.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt