dataforseo-keywords-data-api_skill

Overview

This skill lets you retrieve keyword metrics and trends using the DataForSEO Keywords Data API for keyword research, search volume, and ad planning. It supports both live (single-request) and task-based (bulk/scheduled) flows and returns normalized summaries plus raw payloads for debugging. Use it to drive SEO, SEM, and market-sizing workflows with location, device, and time-window targeting.

How this skill works

The skill builds and sends authenticated requests to DataForSEO endpoints (HTTP Basic auth) and validates top-level status codes and individual task statuses. For task-based jobs it stores task IDs, polls readiness or uses webhooks, then fetches and normalizes results. Responses include search volume, CPC, competition, trends/seasonality, and clickstream-derived metrics when available.

When to use it

• Interactive lookups of search volume, CPC, or competition for a few keywords (Live endpoints).
• Bulk keyword lists, scheduled updates, or large exports (Task-based flows with post + poll or webhooks).
• Ad planning and market sizing that require geography, device, or time-window segmentation.
• Seasonality and rising-query analysis for editorial calendars or paid search timing.
• Clickstream-backed audience or traffic estimation across geos and languages.

Best practices

• Choose Live for quick, single-keyword checks; choose Task-based for high-volume or scheduled jobs.
• Always validate top-level status_code == 20000 and inspect tasks[].status for failures.
• Provide explicit targeting: location, language, device, and date range to avoid ambiguous results.
• Store task IDs and implement retry/poll logic for task-based flows; prefer webhooks where supported.
• Return a normalized summary (volume, trend, CPC, competition) and include raw JSON for audits.

Example use cases

• Get monthly search volume and CPC for a list of keywords in Canada (English) for paid planning.
• Run a bulk seed-and-expand job to generate keyword ideas, cluster by intent, and score by opportunity.
• Show seasonality for a product phrase and recommend the best months to publish content or launch ads.
• Estimate market size using clickstream and search volume across global vs US geographies.
• Schedule nightly task-based updates to keep a keyword dashboard in sync with fresh trends.