dataforseo-reporting

name	dataforseo-reporting
description	Run SEO, SERP, keyword, and search intelligence workflows with DataForSEO — powered by ClawLink.

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: Install	Step 2: Pair Account	Step 3: Connect DataForSEO
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect DataForSEO

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:

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:

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

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

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

---

Powered by ClawLink — your OpenClaw integration hub for DataForSEO.