{"name":"keyword-suggestions","id":"sfoln/keyword-suggestions","title":"Keyword Suggestions & Research Tool","description":"Turn a seed keyword into hundreds of long-tail keyword ideas that contain it, each with Google search volume, CPC, competition, keyword difficulty, search intent and 12-month trend. $0.045 per seed ($45 per 1,000) + $0.70 per 1,000 suggestions.","version":"0.1","status":"ready","family":{"id":"seo-search","name":"SEO & search","description":"Google search, news and Scholar results, keyword volumes and difficulty, backlinks, ranked keywords, competitor domains and on-page audits.","actors":13},"categories":["SEO_TOOLS","LEAD_GENERATION","DEVELOPER_TOOLS"],"availability":"on_request","seoTitle":"Keyword Suggestions API – Long-Tail Ideas with Volume","seoDescription":"Keyword research API: long-tail keyword ideas for any seed with search volume, CPC, difficulty and intent, as JSON. $0.045 per seed + $0.70 per 1,000 ideas.","summary":"Keyword Suggestions & Research Tool turns a seed keyword into hundreds of long-tail keyword ideas that contain it, each with Google search volume, CPC, paid competition, keyword difficulty, search intent and a 12-month trend (DataForSEO Labs data). Ideal for content planning, SEO briefs, PPC research and AI agents building topic clusters. Suggestions come in the order DataForSEO returns them, and you pay $0.045 per seed plus $0.70 per 1,000 suggestions you actually receive.","pricing":{"model":"pay-per-event","currency":"USD","billedBy":"Apify","freePlanMaxItemsPerRun":5,"events":[{"name":"keyword-suggestion-query","title":"Seed keyword query","description":"Charged once per seed keyword the upstream processed (covers the per-request fee).","priceUsd":0.045},{"name":"keyword-suggestion","title":"Keyword suggestion","description":"Charged once per keyword suggestion record delivered.","priceUsd":0.0007}]},"input":{"description":"Enter one or more seed keywords. Each seed returns up to `limitPerSeed` keyword ideas that contain the seed, in the order DataForSEO returns them.","required":["seedKeywords"],"fields":[{"name":"seedKeywords","title":"Seed keywords","type":"array","required":true,"description":"Seed keywords, one per line. Every suggestion contains the seed phrase (e.g. \"coffee grinder\" → \"best burr coffee grinder\"). Accounts on the Apify free plan can process up to 5 seed keywords per run.","prefill":["coffee grinder"],"editor":"stringList"},{"name":"limitPerSeed","title":"Suggestions per seed","type":"integer","required":false,"description":"Maximum suggestions returned per seed, in the order DataForSEO returns them. Each suggestion is billed as keyword-suggestion.","default":100,"prefill":10,"minimum":1,"maximum":1000},{"name":"location","title":"Location","type":"string","required":false,"description":"DataForSEO location code (2840 = United States, 2826 = United Kingdom, 2276 = Germany) or full location name (e.g. \"United Kingdom\").","default":"2840","editor":"textfield"},{"name":"languageCode","title":"Language code","type":"string","required":false,"description":"Language code, e.g. en, de, fr.","default":"en","editor":"textfield"},{"name":"includeSeedKeyword","title":"Include the seed keyword itself","type":"boolean","required":false,"description":"Also return a record with the seed keyword's own metrics (billed as one extra keyword-suggestion).","default":false},{"name":"maxSeeds","title":"Max seeds","type":"integer","required":false,"description":"Safety cap on how many seed keywords are processed in this run.","default":100,"minimum":1,"maximum":1000},{"name":"concurrency","title":"Concurrency","type":"integer","required":false,"description":"How many seeds are processed in parallel.","default":3,"minimum":1,"maximum":10},{"name":"includeRaw","title":"Include raw upstream response","type":"boolean","required":false,"description":"Attach the unmodified DataForSEO item to each suggestion record.","default":false}]},"exampleInput":{"seedKeywords":["coffee grinder"],"limitPerSeed":10},"outputFields":[{"name":"recordType","type":"string","title":"Record type","description":"suggestion = one keyword idea; seed = summary of one seed keyword.","example":"suggestion"},{"name":"seed","type":"string","title":"Seed","description":"Seed keyword the suggestion was generated from.","example":"coffee grinder"},{"name":"keyword","type":"string | null","title":"Keyword","description":"Suggested keyword.","example":"best burr coffee grinder"},{"name":"isSeedKeyword","type":"boolean","title":"Is seed","description":"True for the seed keyword's own record (includeSeedKeyword)."},{"name":"searchVolume","type":"integer | null","title":"Search volume","description":"Average monthly Google searches.","example":2900},{"name":"cpc","type":"number | null","title":"CPC (USD)","description":"Average cost per click in USD.","example":1.12},{"name":"competition","type":"number | null","title":"Competition","description":"Paid competition 0–1.","example":1},{"name":"competitionLevel","type":"string | null","title":"Competition level","description":"LOW | MEDIUM | HIGH.","example":"HIGH"},{"name":"keywordDifficulty","type":"integer | null","title":"Keyword difficulty","description":"Organic ranking difficulty 0–100.","example":42},{"name":"searchIntent","type":"string | null","title":"Search intent","description":"Main intent: informational | navigational | commercial | transactional.","example":"commercial"},{"name":"secondaryIntents","type":"array","title":"Secondary intents","description":"Other detected intents."},{"name":"lowTopOfPageBid","type":"number | null","title":"Low top-of-page bid","description":"USD."},{"name":"highTopOfPageBid","type":"number | null","title":"High top-of-page bid","description":"USD."},{"name":"trendMonthlyPct","type":"number | null","title":"Trend (month)","description":"Search volume change vs previous month, %."},{"name":"trendQuarterlyPct","type":"number | null","title":"Trend (quarter)","description":"Change vs previous quarter, %."},{"name":"trendYearlyPct","type":"number | null","title":"Trend (year)","description":"Change vs previous year, %."},{"name":"monthlySearches","type":"array","title":"Monthly searches","description":"[{year, month, searchVolume}], last 12 months."},{"name":"wordsCount","type":"integer | null","title":"Words","description":"Number of words in the keyword."},{"name":"dataUpdatedAt","type":"string | null","title":"Data updated","description":"When DataForSEO last refreshed the keyword metrics."},{"name":"locationCode","type":"integer | null","title":"Location code","description":"DataForSEO location code."},{"name":"languageCode","type":"string | null","title":"Language","description":"Language code."},{"name":"limitRequested","type":"integer","title":"Limit requested","description":"limitPerSeed as requested (seed records only)."},{"name":"limitUsed","type":"integer","title":"Limit used","description":"Suggestions requested upstream after the free-plan cap and budget sizing (seed records only)."},{"name":"suggestionsReturned","type":"integer","title":"Suggestions returned","description":"Suggestion records delivered for this seed, excluding the seed-metrics record (seed records only)."},{"name":"suggestionsCharged","type":"integer","title":"Suggestions charged","description":"keyword-suggestion events charged for this seed, including the seed-metrics record (seed records only)."},{"name":"totalAvailable","type":"integer | null","title":"Total available","description":"Total suggestions DataForSEO has for the seed (seed records only)."},{"name":"queryCharged","type":"boolean","title":"Seed fee charged","description":"Whether keyword-suggestion-query was charged (seed records only)."},{"name":"input","type":"string | object","title":"Input","description":"Seed keyword."},{"name":"status","type":"string","title":"Status","description":"ok | not_found | error | skipped_invalid | skipped_budget | skipped_free_plan","example":"ok"},{"name":"charged","type":"boolean","title":"Charged","description":"Whether this record incurred a pay-per-event charge."},{"name":"chargedEvent","type":"string","title":"Charged event","description":"keyword-suggestion (suggestion records; seed records are never charged themselves, see queryCharged)."},{"name":"warnings","type":"array","title":"Warnings","description":"Non-fatal notes (limit reduced, free-plan cap, budget reached...)."},{"name":"source","type":"string","title":"Source","description":"Upstream data source."},{"name":"fetchedAt","type":"string","title":"Fetched at","description":"ISO timestamp."}],"outputExample":{"recordType":"suggestion","seed":"coffee grinder","keyword":"best burr coffee grinder","isSeedKeyword":false,"searchVolume":2900,"cpc":1.12,"competition":0.98,"competitionLevel":"HIGH","keywordDifficulty":42,"searchIntent":"commercial","secondaryIntents":["transactional"],"lowTopOfPageBid":0.5,"highTopOfPageBid":1.9,"trendMonthlyPct":0,"trendQuarterlyPct":22,"trendYearlyPct":-18,"monthlySearches":[{"year":2026,"month":9,"searchVolume":2900}],"wordsCount":4,"dataUpdatedAt":"2026-10-01 10:00:00 +00:00","locationCode":2840,"languageCode":"en","input":"coffee grinder","status":"ok","charged":true,"chargedEvent":"keyword-suggestion","source":"dataforseo","fetchedAt":"2026-10-14T10:00:00.000Z"},"faq":[],"mcpExamplePrompt":"Give me 50 long-tail keyword ideas for \"coffee grinder\" in the US with search volume, keyword difficulty and intent, sorted by volume.","related":["related-keywords","keyword-difficulty","ranked-keywords"],"urls":{"site":"https://www.sfoln.com/actors/keyword-suggestions/","siteJson":"https://www.sfoln.com/actors/keyword-suggestions.json","siteMarkdown":"https://www.sfoln.com/actors/keyword-suggestions.md","runSync":"https://api.apify.com/v2/actors/sfoln~keyword-suggestions/run-sync-get-dataset-items","runAsync":"https://api.apify.com/v2/actors/sfoln~keyword-suggestions/runs","mcp":"https://mcp.apify.com?tools=sfoln/keyword-suggestions","requestAccess":"mailto:contact@sfoln.com?subject=Access%20request%3A%20Keyword%20Suggestions%20%26%20Research%20Tool%20(sfoln%2Fkeyword-suggestions)&body=Please%20publish%20keyword-suggestions.%20What%20we%20plan%20to%20use%20it%20for%3A"},"publisher":{"name":"SFOLN LLC","apifyUsername":"sfoln","url":"https://www.sfoln.com","apifyProfile":"https://apify.com/sfoln","email":"contact@sfoln.com"},"generatedAt":"2026-10-22T04:28:58.477Z"}