{"uid":"cap_X10HxiRne0TIgQw1PKkzG","slug":"keyword-search-volume-cpc-bulk-e88c0cb2","name":"Keyword Search Volume & CPC (Bulk)","description":"Search volume, CPC, competition, keyword difficulty and search intent for up to 100 keywords in one $0.04 call (Google Ads data via DataForSEO Labs). Use when you already have a keyword list to prioritise. volume = avg monthly searches, cpc in USD, competition 0-1, difficulty 0-100. Keywords without data are left out of results and listed in missing (still charged). Bad input is free; upstream errors are not charged.","url":"https://keywords.duoleads.com/v1/keyword-overview?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 code or country name, used when locationCode is absent (uk = gb)."},"keywords":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":100,"minItems":1,"description":"Keywords to look up (1-100; each at most 80 characters). Whitespace and control characters are normalised to single spaces and keywords to lower case; a keyword that is then empty, over 10 words or over 80 characters is not looked up and is listed in missing, and a request with no keyword left to look up is a free 400 (the one exception to openverbs schema compatibility)."},"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 keyword's monthly search volumes (monthly[])."}}},"responseSchema":{"type":"json","example":{"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)","missing":[],"results":[{"cpc":4.63,"intent":"informational","volume":673000,"keyword":"phone","difficulty":54,"competition":0.76,"trendYoyPct":50,"competitionLevel":"HIGH"},{"cpc":1.39,"intent":"transactional","volume":550000,"keyword":"watch","difficulty":54,"competition":0.95,"trendYoyPct":22,"competitionLevel":"HIGH"}],"dataAsOf":"2026-09-16T03:19:59Z","see_also":{"params":["keywords","country","lang"],"reason":"Prefer a GET? search-volume returns the same fields for up to 20 comma-separated keywords.","endpoint":"https://keywords.duoleads.com/v1/search-volume"},"request_id":"01KEXAMPLE0000000000000000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oJodvtVhLX4zMbaZCrSMu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns search volume, CPC, competition, keyword difficulty, and search intent for up to 100 keywords in a single call using Google Ads data via DataForSEO Labs.","exampleAgentPrompt":"Can you pull search volume, CPC, competition, and keyword difficulty for these 10 keywords — 'project management software', 'crm tools', 'email marketing', 'seo tools', 'landing page builder', 'live chat software', 'help desk software', 'invoicing app', 'time tracking', 'payroll software' — for the US market in English?","exampleUseCases":[{"title":"Prioritize content calendar keywords","prompt":"I have a list of 50 blog topic keywords I'm deciding between — can you check their search volume, difficulty, and intent in the UK for me so I can figure out which ones are worth targeting first? The keywords are: 'best crm software', 'free project management tools', 'how to do keyword research', 'b2b email marketing tips', 'landing page optimization', 'seo audit checklist', 'google ads vs facebook ads', 'content marketing strategy', 'social media scheduling tools', 'email automation software'."},{"title":"Evaluate PPC keyword bid worthiness","prompt":"Before I launch my Google Ads campaign, can you look up the CPC and competition scores for these 20 keywords — 'buy running shoes online', 'best trail running shoes', 'women's running shoes sale', 'men's marathon shoes', 'cushioned running shoes', 'minimalist running shoes', 'wide fit running shoes', 'kids running shoes', 'running shoes for flat feet', 'running shoes for overpronation', 'waterproof trail shoes', 'cheap running shoes', 'Nike running shoes', 'Adidas running shoes', 'Brooks running shoes', 'ASICS running shoes', 'Hoka running shoes', 'ON running shoes', 'Saucony running shoes', 'New Balance running shoes' — US market?"},{"title":"Gauge SEO opportunity for new niche","prompt":"I'm exploring a new niche around home automation and want to know which keywords actually have decent search volume and aren't too competitive. Can you check search volume, keyword difficulty, and search intent for: 'smart home devices', 'home automation system', 'best smart thermostat', 'smart light switches', 'voice controlled home', 'matter smart home', 'home assistant automation', 'zigbee devices', 'smart home hub', 'best smart plugs' — for Australia?"}],"resultDescription":"A JSON response containing per-keyword data including 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 context (country, language, location code), data freshness timestamp, a list of any keywords with no data (missing), and optionally month-by-month search volume arrays if includeMonthly is true.","failureModes":["Keywords that are empty, over 10 words, or over 80 characters after normalization are placed in 'missing' (not charged)","Keywords with no data from DataForSEO are omitted from results and listed in 'missing' (still charged)","Invalid country name or unsupported location code triggers a fallback to US (2840) with market.fallback=true and a warning","Upstream DataForSEO errors may result in a non-200 response but are not charged","Request with no valid keywords after normalization returns a free 400 error","Unsupported language for a location falls back to the location's default language with a warning in market.warnings"],"whenToPreferThis":"Use this endpoint when you already have a list of 2–100 keywords and need to prioritize or enrich them with authoritative Google Ads-sourced metrics in a single cost-efficient call ($0.04). It is preferable over the GET /search-volume sibling endpoint when processing more than 20 keywords at once. Ideal for bulk SEO audits, content calendar prioritization, PPC keyword triage, and niche research workflows where you need volume, intent, difficulty, and CPC in one shot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T00:46:34.727Z","isFirstParty":false,"canonicalSlug":"keyword-search-volume-cpc-bulk-e88c0cb2"}