# Keyword Ideas with Search Volume & CPC (DataForSEO Labs)

> Keyword Ideas with Search Volume & CPC (DataForSEO Labs) is a paid API for AI agents from keywords.duoleads.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-21).

Returns up to 100 keyword ideas for a seed keyword, each with Google search volume, CPC, competition, difficulty, and search intent, powered by DataForSEO Labs.

## Facts

- Endpoint: POST https://keywords.duoleads.com/v1/keyword-ideas?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/keyword-ideas-with-search-volume-cpc-dataforseo-labs-7ee9e958
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lhNTDvuBQ9z_v9qaYrn_W

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability keyword-ideas-with-search-volume-cpc-dataforseo-labs-7ee9e958 -d '<json body>'
```

Example prompt: Give me up to 50 keyword ideas related to 'home office furniture' for the UK market, including search volume, CPC, keyword difficulty, and search intent for each.

## When to prefer this

Use this endpoint when you need to discover and expand a single seed keyword into many related keyword ideas in one call, rather than looking up metrics for a fixed list of known keywords. It is ideal for content ideation, SEO gap analysis, and Google Ads keyword discovery where breadth of ideas matters. For bulk lookup of already-known keywords, use the sibling batch volume endpoint instead. At $0.04 for up to 100 ideas, it is cost-efficient for broad keyword research tasks.

## Known failure modes

- Seed keyword after normalization is empty or exceeds 80 characters — returns free 400 error
- Unsupported location code falls back to United States with market.fallback=true and a warning
- Unsupported language for a location falls back to the location's default language with a warning
- No keyword ideas found for the seed — returns empty results array but still charges $0.04
- Upstream DataForSEO error — not charged, returns error response
- Invalid limit value outside 1–100 range — returns 400 validation error

## How this service works

Keyword ideas for a seed keyword, each with Google search volume, CPC, competition, keyword difficulty and search intent; up to 100 ideas in one $0.04 call (DataForSEO Labs). Use when you need related keywords to target. volume = avg monthly searches, cpc in USD, competition 0-1, difficulty 0-100. No ideas returns empty results (still charged). Bad input is free; upstream errors are not charged.

## Output

A JSON object containing up to 100 keyword idea objects, each with the keyword string, average monthly search volume, CPC in USD, competition score (0–1), competition level (LOW/MEDIUM/HIGH), keyword difficulty (0–100), search intent (informational/navigational/commercial/transactional), and year-over-year trend percentage. Also includes market metadata (country, language, location code, fallback status), total available ideas count, data freshness timestamp, and an optional monthly search volume series per idea if requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum ideas to return. Defaults to 20."
  },
  "country": {
   "type": "string",
   "description": "Optional ISO 3166-1 alpha-2 code or country name, used when locationCode is absent (uk = gb)."
  },
  "keyword": {
   "type": "string",
   "maxLength": 80,
   "minLength": 1,
   "description": "Seed keyword to expand (at most 80 characters). Whitespace and control characters are normalised to single spaces and the seed to lower case; DataForSEO expands seeds of 1 to 10 words and at most 80 characters, so a seed that is then empty or longer is a free 400."
  },
  "languageCode": {
   "type": "string",
   "description": "Language code (2-letter). Defaults to en. An unsupported location falls back to 2840 (United States) with en (or the requested language if the United States offers it); a supported location with a language it does not offer uses that location's default language (en if offered). Either way market.fallback is true and market.warnings says what was used."
  },
  "locationCode": {
   "type": "integer",
   "description": "DataForSEO location code. Defaults to 2840 (United States); an unsupported code falls back to 2840 (United States, market.fallback)."
  },
  "includeMonthly": {
   "type": "boolean",
   "description": "Add each idea's monthly search volumes (monthly[])."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "seed": "phone",
  "total": 2,
  "units": "volume: average monthly Google searches; cpc: US dollars; competition: 0-1 (Google Ads); competitionLevel: LOW|MEDIUM|HIGH; difficulty: 0-100; intent: informational|navigational|commercial|transactional; trendYoyPct: % change vs a year ago",
  "market": {
   "country": "US",
   "fallback": false,
   "languageCode": "en",
   "locationCode": 2840,
   "locationName": "United States"
  },
  "source": "DataForSEO Labs (Google Ads data)",
  "results": [
   {
    "cpc": 0.31,
    "intent": "informational",
    "volume": 165000,
    "keyword": "nothing phone",
    "difficulty": 31,
    "competition": 0.92,
    "trendYoyPct": 174,
    "competitionLevel": "HIGH"
   },
   {
    "cpc": 2.14,
    "intent": "informational",
    "volume": 14800,
    "keyword": "find phone",
    "difficulty": 57,
    "competition": 0.1,
    "trendYoyPct": 22,
    "competitionLevel": "LOW"
   }
  ],
  "dataAsOf": "2026-09-13T09:55:39Z",
  "see_also": {
   "params": [
    "keyword",
    "country",
    "timeframe"
   ],
   "reason": "Want the seasonality of an idea? Call trend for its Google Trends interest over time.",
   "endpoint": "https://keywords.duoleads.com/v1/trend"
  },
  "available": 425645,
  "request_id": "01KEXAMPLE0000000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/keyword-ideas-with-search-volume-cpc-dataforseo-labs-7ee9e958/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from keywords.duoleads.com](https://www.zero.xyz/host/keywords.duoleads.com/llms.txt)