DataForSEO

Work with DataForSEO from chat — run SEO, SERP, keyword, and search intelligence workflows.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure DataForSEO API access yourself.

Setup in 3 Steps

Connection flow

User → ClawLink → DataForSEO account
         ↓
    OpenClaw tools
    (via ClawLink)

Step 1 — Install the ClawLink plugin:

openclaw plugins install clawhub:clawlink-plugin

Start a fresh chat after installing.

Step 2 — Pair ClawLink:

Call clawlink_begin_pairing
Open the returned URL in your browser
Sign in to ClawLink and approve the device

Step 3 — Connect DataForSEO: Open claw-link.dev/dashboard?add=dataforseo, complete the connection flow, then confirm.

App-specific connection GIF coming soon

Step 4 — Verify and discover:

// 1. Verify DataForSEO is connected
clawlink_list_integrations()

// 2. List available tools
clawlink_list_tools({ integration: "dataforseo" })

// 3. Search tools if needed
clawlink_search_tools({ query: "keyword", integration: "dataforseo" })

Architecture

┌─────────────────────────────────────────────────────────┐
│                    OpenClaw (you)                       │
├─────────────────────────────────────────────────────────┤
│  ClawLink Plugin  →  clawlink_* tools                   │
├─────────────────────────────────────────────────────────┤
│                    ClawLink Cloud                       │
│         (credentials, connection state, routing)        │
├─────────────────────────────────────────────────────────┤
│           DataForSEO API (user's account)               │
└─────────────────────────────────────────────────────────┘

Tool reference

DataForSEO uses an async task model — most create_* tools return a task ID, and get_* tools retrieve results by task ID.

Tasks (create → get retrieval model)

| Tool | Description | Risk | |------|-------------|------| | dataforseo_create_app_data_apple_app_reviews_task | Create Apple App Store reviews retrieval task | confirm | | dataforseo_create_app_data_apple_app_searches_task | Create Apple App Store search task (up to 100 per request) | confirm | | dataforseo_create_app_data_google_app_list_task | Create Google Play top charts app list task | confirm | | dataforseo_create_app_data_google_app_reviews_task | Create Google Play app reviews retrieval task | confirm | | dataforseo_create_business_data_trustpilot_search_task | Create Trustpilot business profile search task | confirm | | dataforseo_create_keywords_data_google_trends_explore_task | Create Google Trends Explore task | confirm | | dataforseo_create_kw_bing_audience_est_task | Create Bing audience estimation task for ad planning | confirm | | dataforseo_create_kw_google_kw_for_kw_task | Create keyword research task with search volume/CPC | confirm | | dataforseo_create_merchant_amazon_sellers_task | Get Amazon sellers for a product | confirm | | dataforseo_create_on_page_lighthouse_task_post | Create Lighthouse audit task for page quality | confirm | | dataforseo_create_on_page_task_post | Create on-page SEO crawl task (60+ parameters) | confirm | | dataforseo_create_serp_google_autocomplete_task | Create Google Autocomplete SERP task | confirm | | dataforseo_create_serp_google_events_task | Create Google Events SERP task (English only) | confirm | | dataforseo_create_serp_google_finance_explore_task | Create Google Finance Explore task | confirm | | dataforseo_create_serp_google_local_finder_task | Create Google Local Finder SERP task | confirm | | dataforseo_create_serp_google_maps_task | Create Google Maps SERP task | confirm | | dataforseo_create_serp_google_organic_task_post | Create Google organic SERP task with featured snippets | confirm | | dataforseo_create_serp_seznam_organic_task | Create Seznam (Czech) organic SERP task | confirm | | dataforseo_create_serp_youtube_video_comments_task | Create YouTube video comments retrieval task | confirm | | dataforseo_create_serp_youtube_video_subtitles_task | Create YouTube video subtitles extraction task | confirm | | dataforseo_force_on_page_crawl | Force-stop ongoing website crawl | high_impact |

Results retrieval

| Tool | Description | Risk | |------|-------------|------| | dataforseo_get_ai_keyword_data_available_filters | Discover filterable fields for AI keyword queries | safe | | dataforseo_get_ai_keyword_data_locations_and_languages | Get supported locations/languages for AI keyword API | safe | | dataforseo_get_ai_opt_chat_gpt_llm_scraper_html_by_id | Get ChatGPT LLM scraper results in HTML (task ID valid 7 days) | safe | | dataforseo_get_ai_opt_chat_gpt_llm_scraper_task_adv_by_id | Get advanced ChatGPT LLM scraper results with markdown/sources | safe | | dataforseo_get_ai_opt_gemini_llm_scraper_task_adv | Get Gemini LLM scraper results (results valid 30 days) | safe | | dataforseo_get_ai_optimization_chat_gpt_llm_responses_live | Get live ChatGPT responses with optional web search | safe | | dataforseo_get_ai_optimization_gemini_llm_scraper_html_by_id | Get Gemini scraper HTML results (valid 7 days) | safe | | dataforseo_get_ai_optimization_llm_mentions_top_domains_live | Get top domains mentioned by LLMs for keywords | safe | | dataforseo_get_app_data_apple_app_list_task_advanced | Get Apple App Store app list results by task ID | safe | | dataforseo_get_app_data_apple_app_searches_task_advanced | Get Apple App Search results by task ID | safe | | dataforseo_get_app_data_google_app_info_task_html_by_id | Get Google Play app HTML (valid 7 days) | safe | | dataforseo_get_app_data_google_app_list_task_advanced_by_id | Get Google Play app list results by task ID | safe | | dataforseo_get_app_data_google_app_reviews_task_html | Get Google Play reviews HTML (valid 7 days) | safe | | dataforseo_get_app_data_google_app_searches_task_html_by_id | Get Google Play search HTML by task ID | safe | | dataforseo_get_app_google_app_reviews_task_get_adv_by_id | Get Google Play review details by task ID | safe | | dataforseo_get_app_google_app_searches_task_adv_by_id | Get Google Play search results by task ID | safe | | dataforseo_get_apple_app_info_task_advanced | Get advanced Apple App Info results by task ID | safe | | dataforseo_get_backlinks_bulk_pages_summary_live | Get backlinks summary for up to 1000 targets at once | safe | | dataforseo_get_backlinks_bulk_spam_score_live | Get spam scores for multiple domains | safe | | dataforseo_get_backlinks_summary_live | Get comprehensive backlinks overview for a domain | safe | | dataforseo_get_bing_kw_performance_locations_and_languages | Get supported Bing keyword locations/languages | safe | | dataforseo_get_biz_business_listings_available_filters | Discover filterable fields for business listings | safe | | dataforseo_get_biz_google_hotel_info_task_get_adv_by_id | Get Google Hotel Info by task ID | safe | | dataforseo_get_biz_google_hotel_searches_task_by_id | Get Google Hotel search results (valid 30 days) | safe | | dataforseo_get_biz_google_my_business_updates_task_by_id | Get Google My Business updates (valid 30 days) | safe | | dataforseo_get_biz_google_questions_and_answers_task | Get Google Business Q&A by task ID | safe | | dataforseo_get_business_data_google_extended_reviews_task | Get extended Google Business reviews by task ID | safe | | dataforseo_get_business_data_google_my_business_info_task | Get Google My Business info by task ID | safe | | dataforseo_get_business_data_google_reviews_task | Get Google Business reviews by task ID | safe | | dataforseo_get_business_data_tripadvisor_reviews_task_by_id | Get TripAdvisor reviews by task ID | safe | | dataforseo_get_business_data_tripadvisor_search_task_by_id | Get TripAdvisor business search results by task ID | safe | | dataforseo_get_business_data_trustpilot_search_task_by_id | Get Trustpilot search results by task ID | safe | | dataforseo_get_chat_gpt_llm_scraper_locations_by_country | Get valid locations for ChatGPT LLM scraper tasks | safe | | dataforseo_get_dataforseo_labs_available_filters | Discover filterable fields for Labs API | safe | | dataforseo_get_dataforseo_labs_bing_related_keywords_live | Get Bing related keywords (up to 4680 ideas) | safe | | dataforseo_get_dataforseo_labs_google_available_history | Get available historical dates for Labs domain metrics | safe | | dataforseo_get_dataforseo_labs_google_top_searches_live | Get top Google search keywords with trends | safe | | dataforseo_get_dataforseo_labs_status | Get last update dates for Labs data sources | safe | | dataforseo_get_dataforseo_trends_locations_by_country | Get valid locations for DataForSEO Trends tasks | safe | | dataforseo_get_domain_analytics_tech_technology_stats_live | Get historical technology adoption statistics | safe | | dataforseo_get_gemini_llm_responses_task_by_id | Get Gemini LLM responses by task ID (valid 30 days) | safe | | dataforseo_get_google_hist_bulk_traffic_est_live | Get historical monthly traffic for up to 1000 domains | safe | | dataforseo_get_keywords_data_bing_keywords_for_site_task | Get Bing keywords for a site by task ID | safe | | dataforseo_get_keywords_data_bing_search_volume_task_by_id | Get Bing search volume by task ID (valid 30 days) | safe | | dataforseo_get_keywords_data_google_ads_status | Check Google Ads keyword data update status | safe | | dataforseo_get_keywords_data_google_search_volume_task_by_id | Get Google search volume by task ID | safe | | dataforseo_get_kw_bing_audience_est_industries | Get 147 Bing audience estimation industry IDs | safe | | dataforseo_get_kw_bing_kw_for_kw_task_by_id | Get Bing keyword suggestions by task ID (up to 3000) | safe | | dataforseo_get_kw_bing_kw_suggestions_for_url_live | Get Bing keyword suggestions for a URL (live) | safe | | dataforseo_get_kw_bing_kw_suggestions_for_url_task | Get Bing keyword suggestions for URL (task-based, 30 days) | safe | | dataforseo_get_kw_google_ads_ad_traffic_by_kw_task_by_id | Get Google Ads ad traffic forecasts by task ID | safe | | dataforseo_get_kw_google_ads_kw_for_kw_live | Get Google Ads keyword suggestions (live) | safe | | dataforseo_get_kw_google_ads_kw_for_kw_task_by_id | Get Google Ads keywords by task ID | safe | | dataforseo_get_kw_google_ads_kw_for_site_task | Get Google Ads keywords for a site by task ID | safe | | dataforseo_get_kw_google_ads_search_vol_task_by_id | Get Google Ads search volume by task ID | safe | | dataforseo_get_kw_google_kw_for_category_live | Get Google keywords for a product category (up to 700) | safe | | dataforseo_get_kw_google_kw_for_kw_task_by_id | Get Google keyword suggestions by task ID | safe | | dataforseo_get_kw_google_trends_explore_task_by_id | Get Google Trends explore results by task ID | safe | | dataforseo_get_kw_google_trends_locations_by_country | Get valid Google Trends locations | safe | | dataforseo_get_llm_mentions_available_filters | Discover filterable fields for LLM mentions API | safe |

Appendix (always-on utilities)

| Tool | Description | Risk | |------|-------------|------| | dataforseo_get_appendix_errors | Get complete API error codes and HTTP status codes | safe | | dataforseo_get_appendix_status | Get current operational status of all APIs | safe | | dataforseo_get_appendix_user_data | Get account balance, rate limits, spending, pricing | safe |

Code examples

Example 1: Run keyword research

// Create a Google keyword research task
const task = await clawlink_call_tool({
  tool: "dataforseo_create_kw_google_kw_for_kw_task",
  parameters: {
    keywords: ["content marketing", "SEO strategy"],
    location_name: "United States",
    language_name: "English"
  }
});

// Retrieve results (after async processing)
const results = await clawlink_call_tool({
  tool: "dataforseo_get_kw_google_kw_for_kw_task_by_id",
  parameters: { task_id: task.id }
});

Example 2: Run a SERP task

// Create a Google organic SERP task
const serpTask = await clawlink_call_tool({
  tool: "dataforseo_create_serp_google_organic_task_post",
  parameters: {
    keyword: "best CRM software 2024",
    location_name: "United States",
    language_name: "English"
  }
});

// Get results
const serpResults = await clawlink_call_tool({
  tool: "dataforseo_get_keywords_data_google_search_volume_task_by_id",
  parameters: { task_id: serpTask.id }
});

Example 3: Analyze backlinks

// Get backlinks summary for a domain
const backlinks = await clawlink_call_tool({
  tool: "dataforseo_get_backlinks_summary_live",
  parameters: {
    target: "example.com"
  }
});

// Get spam scores
const spamScores = await clawlink_call_tool({
  tool: "dataforseo_get_backlinks_bulk_spam_score_live",
  parameters: {
    targets: ["example.com", "competitor.com"]
  }
});

Example 4: AI Optimization queries

// Get top domains mentioned by LLMs for a keyword
const llmMentions = await clawlink_call_tool({
  tool: "dataforseo_get_ai_optimization_llm_mentions_top_domains_live",
  parameters: {
    keyword: "project management software"
  }
});

// Get live ChatGPT response with web search
const chatGptResponse = await clawlink_call_tool({
  tool: "dataforseo_get_ai_optimization_chat_gpt_llm_responses_live",
  parameters: {
    prompt: "What are the top 10 project management tools?",
    temperature: 0.7
  }
});

Error handling

| Error pattern | Likely cause | Resolution | |---------------|--------------|------------| | Task not ready | Async task still processing | Wait and retry with same task ID | | Task expired | Task older than 30 days | Create a new task | | Invalid location | Unsupported country/location | Use dataforseo_get_dataforseo_trends_locations_by_country to find valid codes | | Rate limit exceeded | Too many requests | Check dataforseo_get_appendix_user_data for rate limits; slow down requests | | Insufficient balance | Out of DataForSEO credits | User needs to add funds to their DataForSEO account |

Security & Permissions

ClawLink stores only the API credentials, never raw keys in plaintext
Device credentials are stored locally in OpenClaw plugin config
Some tasks (e.g., large crawls) can consume significant credits — always confirm before running large jobs

Troubleshooting

Task results not available:

Tasks are async — results may take minutes to be ready
Check task status by calling the appropriate get_* tool with the task ID
Task results expire after 30 days for most task types

Empty results from keyword tools:

Verify the keyword and location are valid
Some very niche keywords may have no data
Check dataforseo_get_appendix_status to verify the API is operational

Credit consumption higher than expected:

Use dataforseo_get_appendix_user_data to check current balance
On-page crawls and bulk backlink queries consume credits
Use narrow filters and specific targets to minimize credit usage