Keywords
Keyword Ideas
Generate hundreds of keyword ideas from any seed keyword with search volume, CPC, and difficulty scores.
POST
$0.03/call/v1/seo/keywords/ideasUsage
const res = await fetch('https://api.yepapi.com/v1/seo/keywords/ideas', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ keyword: 'react framework', limit: 50 }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/seo/keywords/ideas \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "react framework", "limit": 50}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
keyword | string | Yes | Seed keyword to generate ideas from (e.g., "react framework") | — |
limit | number | No | Maximum number of keyword ideas to return | 50 |
location_code | number | No | Target country code (e.g., 2840 for US). See Location Codes. | 2840 |
language | string | No | ISO language code (e.g., en, es) | "en" |
Response
{
"ok": true,
"data": {
"seed": "email marketing",
"keywords": [
{
"keyword": "marketing email platforms",
"volume": 22200,
"cpc": 72.63,
"difficulty": 77,
"competition": 0.2,
"competitionLevel": "LOW",
"intent": "commercial",
"avgBacklinks": 97860.5,
"avgReferringDomains": 9312.9,
"serpFeatures": [],
"totalResults": 0,
"trend": [
{ "month": "2026-02", "volume": 9900 },
{ "month": "2026-01", "volume": 14800 },
{ "month": "2025-12", "volume": 33100 }
]
},
{
"keyword": "email marketing platform",
"volume": 22200,
"cpc": 72.63,
"difficulty": 80,
"competition": 0.2,
"competitionLevel": "LOW",
"intent": "commercial",
"avgBacklinks": 119229.5,
"avgReferringDomains": 9397.5,
"serpFeatures": [],
"totalResults": 0,
"trend": [
{ "month": "2026-02", "volume": 9900 },
{ "month": "2026-01", "volume": 14800 },
{ "month": "2025-12", "volume": 33100 }
]
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.seed | string | The seed keyword used to generate ideas |
data.keywords | object[] | Array of keyword idea results |
data.keywords[].keyword | string | The suggested keyword |
data.keywords[].volume | number | Average monthly search volume |
data.keywords[].cpc | number | Cost per click in USD |
data.keywords[].difficulty | number | SEO difficulty score (0-100) |
data.keywords[].competition | number | PPC competition index (0-1) |
data.keywords[].competitionLevel | string | Competition category (LOW, MEDIUM, HIGH, or unknown) |
data.keywords[].intent | string | Search intent (informational, commercial, navigational, transactional, or unknown) |
data.keywords[].avgBacklinks | number | Average number of backlinks for top-ranking pages |
data.keywords[].avgReferringDomains | number | Average number of referring domains for top-ranking pages |
data.keywords[].serpFeatures | string[] | SERP features present for this keyword |
data.keywords[].totalResults | number | Total number of search results |
data.keywords[].trend | object[] | Monthly search volume trend data |
data.keywords[].trend[].month | string | Month in YYYY-MM format |
data.keywords[].trend[].volume | number | Search volume for that month |
Under the Hood
Under the hood, this queries our SEO data engine for keyword suggestions based on your seed term. We normalize the response and return clean camelCase fields.