{"skill":{"slug":"dataforseo-reporting","displayName":"DataForSEO","summary":"Run SEO, SERP, keyword, and search intelligence workflows with DataForSEO — powered by ClawLink.","description":"---\nname: dataforseo-reporting\ndescription: Run SEO, SERP, keyword, and search intelligence workflows with DataForSEO — powered by ClawLink.\n---\n\n# DataForSEO\n\n![DataForSEO](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/dataforseo.svg)\n\nWork with DataForSEO from chat — run SEO, SERP, keyword, and search intelligence workflows.\n\nPowered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=dataforseo-reporting), an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure DataForSEO API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect DataForSEO |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect DataForSEO |\n\n## Connection flow\n\n```\nUser → ClawLink → DataForSEO account\n         ↓\n    OpenClaw tools\n    (via ClawLink)\n```\n\n**Step 1** — Install the ClawLink plugin:\n```\nopenclaw plugins install clawhub:clawlink-plugin\n```\nStart a fresh chat after installing.\n\n**Step 2** — Pair ClawLink:\n1. Call `clawlink_begin_pairing`\n2. Open the returned URL in your browser\n3. Sign in to ClawLink and approve the device\n\n**Step 3** — Connect DataForSEO:\nOpen [claw-link.dev/dashboard?add=dataforseo](https://claw-link.dev/dashboard?add=dataforseo), complete the connection flow, then confirm.\n\n*App-specific connection GIF coming soon*\n\n**Step 4** — Verify and discover:\n```javascript\n// 1. Verify DataForSEO is connected\nclawlink_list_integrations()\n\n// 2. List available tools\nclawlink_list_tools({ integration: \"dataforseo\" })\n\n// 3. Search tools if needed\nclawlink_search_tools({ query: \"keyword\", integration: \"dataforseo\" })\n```\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    OpenClaw (you)                       │\n├─────────────────────────────────────────────────────────┤\n│  ClawLink Plugin  →  clawlink_* tools                   │\n├─────────────────────────────────────────────────────────┤\n│                    ClawLink Cloud                       │\n│         (credentials, connection state, routing)        │\n├─────────────────────────────────────────────────────────┤\n│           DataForSEO API (user's account)               │\n└─────────────────────────────────────────────────────────┘\n```\n\n## Tool reference\n\nDataForSEO uses an async task model — most `create_*` tools return a task ID, and `get_*` tools retrieve results by task ID.\n\n### Tasks (create → get retrieval model)\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dataforseo_create_app_data_apple_app_reviews_task` | Create Apple App Store reviews retrieval task | confirm |\n| `dataforseo_create_app_data_apple_app_searches_task` | Create Apple App Store search task (up to 100 per request) | confirm |\n| `dataforseo_create_app_data_google_app_list_task` | Create Google Play top charts app list task | confirm |\n| `dataforseo_create_app_data_google_app_reviews_task` | Create Google Play app reviews retrieval task | confirm |\n| `dataforseo_create_business_data_trustpilot_search_task` | Create Trustpilot business profile search task | confirm |\n| `dataforseo_create_keywords_data_google_trends_explore_task` | Create Google Trends Explore task | confirm |\n| `dataforseo_create_kw_bing_audience_est_task` | Create Bing audience estimation task for ad planning | confirm |\n| `dataforseo_create_kw_google_kw_for_kw_task` | Create keyword research task with search volume/CPC | confirm |\n| `dataforseo_create_merchant_amazon_sellers_task` | Get Amazon sellers for a product | confirm |\n| `dataforseo_create_on_page_lighthouse_task_post` | Create Lighthouse audit task for page quality | confirm |\n| `dataforseo_create_on_page_task_post` | Create on-page SEO crawl task (60+ parameters) | confirm |\n| `dataforseo_create_serp_google_autocomplete_task` | Create Google Autocomplete SERP task | confirm |\n| `dataforseo_create_serp_google_events_task` | Create Google Events SERP task (English only) | confirm |\n| `dataforseo_create_serp_google_finance_explore_task` | Create Google Finance Explore task | confirm |\n| `dataforseo_create_serp_google_local_finder_task` | Create Google Local Finder SERP task | confirm |\n| `dataforseo_create_serp_google_maps_task` | Create Google Maps SERP task | confirm |\n| `dataforseo_create_serp_google_organic_task_post` | Create Google organic SERP task with featured snippets | confirm |\n| `dataforseo_create_serp_seznam_organic_task` | Create Seznam (Czech) organic SERP task | confirm |\n| `dataforseo_create_serp_youtube_video_comments_task` | Create YouTube video comments retrieval task | confirm |\n| `dataforseo_create_serp_youtube_video_subtitles_task` | Create YouTube video subtitles extraction task | confirm |\n| `dataforseo_force_on_page_crawl` | Force-stop ongoing website crawl | high_impact |\n\n### Results retrieval\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dataforseo_get_ai_keyword_data_available_filters` | Discover filterable fields for AI keyword queries | safe |\n| `dataforseo_get_ai_keyword_data_locations_and_languages` | Get supported locations/languages for AI keyword API | safe |\n| `dataforseo_get_ai_opt_chat_gpt_llm_scraper_html_by_id` | Get ChatGPT LLM scraper results in HTML (task ID valid 7 days) | safe |\n| `dataforseo_get_ai_opt_chat_gpt_llm_scraper_task_adv_by_id` | Get advanced ChatGPT LLM scraper results with markdown/sources | safe |\n| `dataforseo_get_ai_opt_gemini_llm_scraper_task_adv` | Get Gemini LLM scraper results (results valid 30 days) | safe |\n| `dataforseo_get_ai_optimization_chat_gpt_llm_responses_live` | Get live ChatGPT responses with optional web search | safe |\n| `dataforseo_get_ai_optimization_gemini_llm_scraper_html_by_id` | Get Gemini scraper HTML results (valid 7 days) | safe |\n| `dataforseo_get_ai_optimization_llm_mentions_top_domains_live` | Get top domains mentioned by LLMs for keywords | safe |\n| `dataforseo_get_app_data_apple_app_list_task_advanced` | Get Apple App Store app list results by task ID | safe |\n| `dataforseo_get_app_data_apple_app_searches_task_advanced` | Get Apple App Search results by task ID | safe |\n| `dataforseo_get_app_data_google_app_info_task_html_by_id` | Get Google Play app HTML (valid 7 days) | safe |\n| `dataforseo_get_app_data_google_app_list_task_advanced_by_id` | Get Google Play app list results by task ID | safe |\n| `dataforseo_get_app_data_google_app_reviews_task_html` | Get Google Play reviews HTML (valid 7 days) | safe |\n| `dataforseo_get_app_data_google_app_searches_task_html_by_id` | Get Google Play search HTML by task ID | safe |\n| `dataforseo_get_app_google_app_reviews_task_get_adv_by_id` | Get Google Play review details by task ID | safe |\n| `dataforseo_get_app_google_app_searches_task_adv_by_id` | Get Google Play search results by task ID | safe |\n| `dataforseo_get_apple_app_info_task_advanced` | Get advanced Apple App Info results by task ID | safe |\n| `dataforseo_get_backlinks_bulk_pages_summary_live` | Get backlinks summary for up to 1000 targets at once | safe |\n| `dataforseo_get_backlinks_bulk_spam_score_live` | Get spam scores for multiple domains | safe |\n| `dataforseo_get_backlinks_summary_live` | Get comprehensive backlinks overview for a domain | safe |\n| `dataforseo_get_bing_kw_performance_locations_and_languages` | Get supported Bing keyword locations/languages | safe |\n| `dataforseo_get_biz_business_listings_available_filters` | Discover filterable fields for business listings | safe |\n| `dataforseo_get_biz_google_hotel_info_task_get_adv_by_id` | Get Google Hotel Info by task ID | safe |\n| `dataforseo_get_biz_google_hotel_searches_task_by_id` | Get Google Hotel search results (valid 30 days) | safe |\n| `dataforseo_get_biz_google_my_business_updates_task_by_id` | Get Google My Business updates (valid 30 days) | safe |\n| `dataforseo_get_biz_google_questions_and_answers_task` | Get Google Business Q&A by task ID | safe |\n| `dataforseo_get_business_data_google_extended_reviews_task` | Get extended Google Business reviews by task ID | safe |\n| `dataforseo_get_business_data_google_my_business_info_task` | Get Google My Business info by task ID | safe |\n| `dataforseo_get_business_data_google_reviews_task` | Get Google Business reviews by task ID | safe |\n| `dataforseo_get_business_data_tripadvisor_reviews_task_by_id` | Get TripAdvisor reviews by task ID | safe |\n| `dataforseo_get_business_data_tripadvisor_search_task_by_id` | Get TripAdvisor business search results by task ID | safe |\n| `dataforseo_get_business_data_trustpilot_search_task_by_id` | Get Trustpilot search results by task ID | safe |\n| `dataforseo_get_chat_gpt_llm_scraper_locations_by_country` | Get valid locations for ChatGPT LLM scraper tasks | safe |\n| `dataforseo_get_dataforseo_labs_available_filters` | Discover filterable fields for Labs API | safe |\n| `dataforseo_get_dataforseo_labs_bing_related_keywords_live` | Get Bing related keywords (up to 4680 ideas) | safe |\n| `dataforseo_get_dataforseo_labs_google_available_history` | Get available historical dates for Labs domain metrics | safe |\n| `dataforseo_get_dataforseo_labs_google_top_searches_live` | Get top Google search keywords with trends | safe |\n| `dataforseo_get_dataforseo_labs_status` | Get last update dates for Labs data sources | safe |\n| `dataforseo_get_dataforseo_trends_locations_by_country` | Get valid locations for DataForSEO Trends tasks | safe |\n| `dataforseo_get_domain_analytics_tech_technology_stats_live` | Get historical technology adoption statistics | safe |\n| `dataforseo_get_gemini_llm_responses_task_by_id` | Get Gemini LLM responses by task ID (valid 30 days) | safe |\n| `dataforseo_get_google_hist_bulk_traffic_est_live` | Get historical monthly traffic for up to 1000 domains | safe |\n| `dataforseo_get_keywords_data_bing_keywords_for_site_task` | Get Bing keywords for a site by task ID | safe |\n| `dataforseo_get_keywords_data_bing_search_volume_task_by_id` | Get Bing search volume by task ID (valid 30 days) | safe |\n| `dataforseo_get_keywords_data_google_ads_status` | Check Google Ads keyword data update status | safe |\n| `dataforseo_get_keywords_data_google_search_volume_task_by_id` | Get Google search volume by task ID | safe |\n| `dataforseo_get_kw_bing_audience_est_industries` | Get 147 Bing audience estimation industry IDs | safe |\n| `dataforseo_get_kw_bing_kw_for_kw_task_by_id` | Get Bing keyword suggestions by task ID (up to 3000) | safe |\n| `dataforseo_get_kw_bing_kw_suggestions_for_url_live` | Get Bing keyword suggestions for a URL (live) | safe |\n| `dataforseo_get_kw_bing_kw_suggestions_for_url_task` | Get Bing keyword suggestions for URL (task-based, 30 days) | safe |\n| `dataforseo_get_kw_google_ads_ad_traffic_by_kw_task_by_id` | Get Google Ads ad traffic forecasts by task ID | safe |\n| `dataforseo_get_kw_google_ads_kw_for_kw_live` | Get Google Ads keyword suggestions (live) | safe |\n| `dataforseo_get_kw_google_ads_kw_for_kw_task_by_id` | Get Google Ads keywords by task ID | safe |\n| `dataforseo_get_kw_google_ads_kw_for_site_task` | Get Google Ads keywords for a site by task ID | safe |\n| `dataforseo_get_kw_google_ads_search_vol_task_by_id` | Get Google Ads search volume by task ID | safe |\n| `dataforseo_get_kw_google_kw_for_category_live` | Get Google keywords for a product category (up to 700) | safe |\n| `dataforseo_get_kw_google_kw_for_kw_task_by_id` | Get Google keyword suggestions by task ID | safe |\n| `dataforseo_get_kw_google_trends_explore_task_by_id` | Get Google Trends explore results by task ID | safe |\n| `dataforseo_get_kw_google_trends_locations_by_country` | Get valid Google Trends locations | safe |\n| `dataforseo_get_llm_mentions_available_filters` | Discover filterable fields for LLM mentions API | safe |\n\n### Appendix (always-on utilities)\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dataforseo_get_appendix_errors` | Get complete API error codes and HTTP status codes | safe |\n| `dataforseo_get_appendix_status` | Get current operational status of all APIs | safe |\n| `dataforseo_get_appendix_user_data` | Get account balance, rate limits, spending, pricing | safe |\n\n## Code examples\n\n### Example 1: Run keyword research\n\n```javascript\n// Create a Google keyword research task\nconst task = await clawlink_call_tool({\n  tool: \"dataforseo_create_kw_google_kw_for_kw_task\",\n  parameters: {\n    keywords: [\"content marketing\", \"SEO strategy\"],\n    location_name: \"United States\",\n    language_name: \"English\"\n  }\n});\n\n// Retrieve results (after async processing)\nconst results = await clawlink_call_tool({\n  tool: \"dataforseo_get_kw_google_kw_for_kw_task_by_id\",\n  parameters: { task_id: task.id }\n});\n```\n\n### Example 2: Run a SERP task\n\n```javascript\n// Create a Google organic SERP task\nconst serpTask = await clawlink_call_tool({\n  tool: \"dataforseo_create_serp_google_organic_task_post\",\n  parameters: {\n    keyword: \"best CRM software 2024\",\n    location_name: \"United States\",\n    language_name: \"English\"\n  }\n});\n\n// Get results\nconst serpResults = await clawlink_call_tool({\n  tool: \"dataforseo_get_keywords_data_google_search_volume_task_by_id\",\n  parameters: { task_id: serpTask.id }\n});\n```\n\n### Example 3: Analyze backlinks\n\n```javascript\n// Get backlinks summary for a domain\nconst backlinks = await clawlink_call_tool({\n  tool: \"dataforseo_get_backlinks_summary_live\",\n  parameters: {\n    target: \"example.com\"\n  }\n});\n\n// Get spam scores\nconst spamScores = await clawlink_call_tool({\n  tool: \"dataforseo_get_backlinks_bulk_spam_score_live\",\n  parameters: {\n    targets: [\"example.com\", \"competitor.com\"]\n  }\n});\n```\n\n### Example 4: AI Optimization queries\n\n```javascript\n// Get top domains mentioned by LLMs for a keyword\nconst llmMentions = await clawlink_call_tool({\n  tool: \"dataforseo_get_ai_optimization_llm_mentions_top_domains_live\",\n  parameters: {\n    keyword: \"project management software\"\n  }\n});\n\n// Get live ChatGPT response with web search\nconst chatGptResponse = await clawlink_call_tool({\n  tool: \"dataforseo_get_ai_optimization_chat_gpt_llm_responses_live\",\n  parameters: {\n    prompt: \"What are the top 10 project management tools?\",\n    temperature: 0.7\n  }\n});\n```\n\n## Error handling\n\n| Error pattern | Likely cause | Resolution |\n|---------------|--------------|------------|\n| `Task not ready` | Async task still processing | Wait and retry with same task ID |\n| `Task expired` | Task older than 30 days | Create a new task |\n| `Invalid location` | Unsupported country/location | Use `dataforseo_get_dataforseo_trends_locations_by_country` to find valid codes |\n| `Rate limit exceeded` | Too many requests | Check `dataforseo_get_appendix_user_data` for rate limits; slow down requests |\n| `Insufficient balance` | Out of DataForSEO credits | User needs to add funds to their DataForSEO account |\n\n## Security & Permissions\n\n- ClawLink stores only the API credentials, never raw keys in plaintext\n- Device credentials are stored locally in OpenClaw plugin config\n- Some tasks (e.g., large crawls) can consume significant credits — always confirm before running large jobs\n\n## Troubleshooting\n\n**Task results not available:**\n- Tasks are async — results may take minutes to be ready\n- Check task status by calling the appropriate `get_*` tool with the task ID\n- Task results expire after 30 days for most task types\n\n**Empty results from keyword tools:**\n- Verify the keyword and location are valid\n- Some very niche keywords may have no data\n- Check `dataforseo_get_appendix_status` to verify the API is operational\n\n**Credit consumption higher than expected:**\n- Use `dataforseo_get_appendix_user_data` to check current balance\n- On-page crawls and bulk backlink queries consume credits\n- Use narrow filters and specific targets to minimize credit usage\n\n---\n\nPowered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=dataforseo-reporting) — your OpenClaw integration hub for DataForSEO.","tags":{"latest":"1.0.5"},"stats":{"comments":0,"downloads":1751,"installsAllTime":7,"installsCurrent":7,"stars":6,"versions":8},"createdAt":1778002205916,"updatedAt":1780988766947},"latestVersion":{"version":"1.0.5","createdAt":1780988766947,"changelog":"Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.","license":"MIT-0"},"metadata":null,"owner":{"handle":"hith3sh","userId":"s173vws87a7ss71xf9rq53k5gd8568kv","displayName":"Jay","image":"https://avatars.githubusercontent.com/u/83839061?v=4"},"moderation":null}