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#

Step 1: InstallStep 2: Pair AccountStep 3: Connect DataForSEO_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect DataForSEO

Connection flow#

text

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

Step 1 — Install the ClawLink plugin:

text

openclaw plugins install clawhub:clawlink-plugin

Start a fresh chat after installing.

Step 2 — Pair ClawLink:

1. Call clawlink_begin_pairing
2. Open the returned URL in your browser
3. 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:

javascript

// 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#

text

┌─────────────────────────────────────────────────────────┐
│                    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)#

ToolDescriptionRiskdataforseo_create_app_data_apple_app_reviews_taskCreate Apple App Store reviews retrieval taskconfirmdataforseo_create_app_data_apple_app_searches_taskCreate Apple App Store search task (up to 100 per request)confirmdataforseo_create_app_data_google_app_list_taskCreate Google Play top charts app list taskconfirmdataforseo_create_app_data_google_app_reviews_taskCreate Google Play app reviews retrieval taskconfirmdataforseo_create_business_data_trustpilot_search_taskCreate Trustpilot business profile search taskconfirmdataforseo_create_keywords_data_google_trends_explore_taskCreate Google Trends Explore taskconfirmdataforseo_create_kw_bing_audience_est_taskCreate Bing audience estimation task for ad planningconfirmdataforseo_create_kw_google_kw_for_kw_taskCreate keyword research task with search volume/CPCconfirmdataforseo_create_merchant_amazon_sellers_taskGet Amazon sellers for a productconfirmdataforseo_create_on_page_lighthouse_task_postCreate Lighthouse audit task for page qualityconfirmdataforseo_create_on_page_task_postCreate on-page SEO crawl task (60+ parameters)confirmdataforseo_create_serp_google_autocomplete_taskCreate Google Autocomplete SERP taskconfirmdataforseo_create_serp_google_events_taskCreate Google Events SERP task (English only)confirmdataforseo_create_serp_google_finance_explore_taskCreate Google Finance Explore taskconfirmdataforseo_create_serp_google_local_finder_taskCreate Google Local Finder SERP taskconfirmdataforseo_create_serp_google_maps_taskCreate Google Maps SERP taskconfirmdataforseo_create_serp_google_organic_task_postCreate Google organic SERP task with featured snippetsconfirmdataforseo_create_serp_seznam_organic_taskCreate Seznam (Czech) organic SERP taskconfirmdataforseo_create_serp_youtube_video_comments_taskCreate YouTube video comments retrieval taskconfirmdataforseo_create_serp_youtube_video_subtitles_taskCreate YouTube video subtitles extraction taskconfirmdataforseo_force_on_page_crawlForce-stop ongoing website crawlhigh_impact

Results retrieval#

ToolDescriptionRiskdataforseo_get_ai_keyword_data_available_filtersDiscover filterable fields for AI keyword queriessafedataforseo_get_ai_keyword_data_locations_and_languagesGet supported locations/languages for AI keyword APIsafedataforseo_get_ai_opt_chat_gpt_llm_scraper_html_by_idGet ChatGPT LLM scraper results in HTML (task ID valid 7 days)safedataforseo_get_ai_opt_chat_gpt_llm_scraper_task_adv_by_idGet advanced ChatGPT LLM scraper results with markdown/sourcessafedataforseo_get_ai_opt_gemini_llm_scraper_task_advGet Gemini LLM scraper results (results valid 30 days)safedataforseo_get_ai_optimization_chat_gpt_llm_responses_liveGet live ChatGPT responses with optional web searchsafedataforseo_get_ai_optimization_gemini_llm_scraper_html_by_idGet Gemini scraper HTML results (valid 7 days)safedataforseo_get_ai_optimization_llm_mentions_top_domains_liveGet top domains mentioned by LLMs for keywordssafedataforseo_get_app_data_apple_app_list_task_advancedGet Apple App Store app list results by task IDsafedataforseo_get_app_data_apple_app_searches_task_advancedGet Apple App Search results by task IDsafedataforseo_get_app_data_google_app_info_task_html_by_idGet Google Play app HTML (valid 7 days)safedataforseo_get_app_data_google_app_list_task_advanced_by_idGet Google Play app list results by task IDsafedataforseo_get_app_data_google_app_reviews_task_htmlGet Google Play reviews HTML (valid 7 days)safedataforseo_get_app_data_google_app_searches_task_html_by_idGet Google Play search HTML by task IDsafedataforseo_get_app_google_app_reviews_task_get_adv_by_idGet Google Play review details by task IDsafedataforseo_get_app_google_app_searches_task_adv_by_idGet Google Play search results by task IDsafedataforseo_get_apple_app_info_task_advancedGet advanced Apple App Info results by task IDsafedataforseo_get_backlinks_bulk_pages_summary_liveGet backlinks summary for up to 1000 targets at oncesafedataforseo_get_backlinks_bulk_spam_score_liveGet spam scores for multiple domainssafedataforseo_get_backlinks_summary_liveGet comprehensive backlinks overview for a domainsafedataforseo_get_bing_kw_performance_locations_and_languagesGet supported Bing keyword locations/languagessafedataforseo_get_biz_business_listings_available_filtersDiscover filterable fields for business listingssafedataforseo_get_biz_google_hotel_info_task_get_adv_by_idGet Google Hotel Info by task IDsafedataforseo_get_biz_google_hotel_searches_task_by_idGet Google Hotel search results (valid 30 days)safedataforseo_get_biz_google_my_business_updates_task_by_idGet Google My Business updates (valid 30 days)safedataforseo_get_biz_google_questions_and_answers_taskGet Google Business Q&A by task IDsafedataforseo_get_business_data_google_extended_reviews_taskGet extended Google Business reviews by task IDsafedataforseo_get_business_data_google_my_business_info_taskGet Google My Business info by task IDsafedataforseo_get_business_data_google_reviews_taskGet Google Business reviews by task IDsafedataforseo_get_business_data_tripadvisor_reviews_task_by_idGet TripAdvisor reviews by task IDsafedataforseo_get_business_data_tripadvisor_search_task_by_idGet TripAdvisor business search results by task IDsafedataforseo_get_business_data_trustpilot_search_task_by_idGet Trustpilot search results by task IDsafedataforseo_get_chat_gpt_llm_scraper_locations_by_countryGet valid locations for ChatGPT LLM scraper taskssafedataforseo_get_dataforseo_labs_available_filtersDiscover filterable fields for Labs APIsafedataforseo_get_dataforseo_labs_bing_related_keywords_liveGet Bing related keywords (up to 4680 ideas)safedataforseo_get_dataforseo_labs_google_available_historyGet available historical dates for Labs domain metricssafedataforseo_get_dataforseo_labs_google_top_searches_liveGet top Google search keywords with trendssafedataforseo_get_dataforseo_labs_statusGet last update dates for Labs data sourcessafedataforseo_get_dataforseo_trends_locations_by_countryGet valid locations for DataForSEO Trends taskssafedataforseo_get_domain_analytics_tech_technology_stats_liveGet historical technology adoption statisticssafedataforseo_get_gemini_llm_responses_task_by_idGet Gemini LLM responses by task ID (valid 30 days)safedataforseo_get_google_hist_bulk_traffic_est_liveGet historical monthly traffic for up to 1000 domainssafedataforseo_get_keywords_data_bing_keywords_for_site_taskGet Bing keywords for a site by task IDsafedataforseo_get_keywords_data_bing_search_volume_task_by_idGet Bing search volume by task ID (valid 30 days)safedataforseo_get_keywords_data_google_ads_statusCheck Google Ads keyword data update statussafedataforseo_get_keywords_data_google_search_volume_task_by_idGet Google search volume by task IDsafedataforseo_get_kw_bing_audience_est_industriesGet 147 Bing audience estimation industry IDssafedataforseo_get_kw_bing_kw_for_kw_task_by_idGet Bing keyword suggestions by task ID (up to 3000)safedataforseo_get_kw_bing_kw_suggestions_for_url_liveGet Bing keyword suggestions for a URL (live)safedataforseo_get_kw_bing_kw_suggestions_for_url_taskGet Bing keyword suggestions for URL (task-based, 30 days)safedataforseo_get_kw_google_ads_ad_traffic_by_kw_task_by_idGet Google Ads ad traffic forecasts by task IDsafedataforseo_get_kw_google_ads_kw_for_kw_liveGet Google Ads keyword suggestions (live)safedataforseo_get_kw_google_ads_kw_for_kw_task_by_idGet Google Ads keywords by task IDsafedataforseo_get_kw_google_ads_kw_for_site_taskGet Google Ads keywords for a site by task IDsafedataforseo_get_kw_google_ads_search_vol_task_by_idGet Google Ads search volume by task IDsafedataforseo_get_kw_google_kw_for_category_liveGet Google keywords for a product category (up to 700)safedataforseo_get_kw_google_kw_for_kw_task_by_idGet Google keyword suggestions by task IDsafedataforseo_get_kw_google_trends_explore_task_by_idGet Google Trends explore results by task IDsafedataforseo_get_kw_google_trends_locations_by_countryGet valid Google Trends locationssafedataforseo_get_llm_mentions_available_filtersDiscover filterable fields for LLM mentions APIsafe

Appendix (always-on utilities)#

ToolDescriptionRiskdataforseo_get_appendix_errorsGet complete API error codes and HTTP status codessafedataforseo_get_appendix_statusGet current operational status of all APIssafedataforseo_get_appendix_user_dataGet account balance, rate limits, spending, pricingsafe

Code examples#

Example 1: Run keyword research#

javascript

// 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#

javascript

// 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#

javascript

// 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#

javascript

// 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 patternLikely causeResolutionTask not readyAsync task still processingWait and retry with same task IDTask expiredTask older than 30 daysCreate a new taskInvalid locationUnsupported country/locationUse dataforseo_get_dataforseo_trends_locations_by_country to find valid codesRate limit exceededToo many requestsCheck dataforseo_get_appendix_user_data for rate limits; slow down requestsInsufficient balanceOut of DataForSEO creditsUser 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

---

Powered by ClawLink — your OpenClaw integration hub for DataForSEO.