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)

Results retrieval

Appendix (always-on utilities)

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

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.