SEMrush Keyword Research - Volume, Difficulty & Related
Pricing
from $0.01 / 1,000 results
SEMrush Keyword Research - Volume, Difficulty & Related
Research any keyword with SEMrush data using your own API key (BYOK). Get search volume, keyword difficulty, CPC, SERP features, and discover related keywords - all in structured format for automation.
Pricing
from $0.01 / 1,000 results
Rating
0.0
(0)
Developer
The Howlers
Actor stats
0
Bookmarked
31
Total users
5
Monthly active users
an hour ago
Last modified
Categories
Share
SEMrush Keyword Research
Get comprehensive keyword data from SEMrush including search volume, keyword difficulty, CPC, SERP features, and related/phrase match keywords. BYOK (Bring Your Own Key) - use your SEMrush API key.
BYOK (Bring Your Own Key) -- you provide your own API credentials.
Before You Start
This actor requires your own API credentials to fetch real data.
Where to get your key: Your SEMrush API key. Get it from SEMrush → My Profile → API → Subscription Info
You can test with Demo Mode first (free, no key needed) to see the output format before committing.
Quick Start
Test with Demo Mode (free, no API key needed)
{"demoMode": true,"keywords": ["seo tools"]}
Run with real data
{"demoMode": false,"semrushApiKey": "YOUR_API_KEY_HERE","keywords": ["seo tools"],"database": "us","includeRelatedKeywords": true,"includePhraseMatch": true,"relatedLimit": 20,"phraseMatchLimit": 20,"minVolume": 0,"maxDifficulty": 100,"webhookPlatform": "custom"}
Input Parameters
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
semrushApiKey | string | - | Yes* | Your SEMrush API key. Get it from SEMrush → My Profile → API → Subscription Info |
keywords | array | - | No | List of keywords to research (e.g., 'seo tools', 'keyword research') |
database | string | "us" | No | SEMrush database/country to use for data |
includeRelatedKeywords | boolean | true | No | Get semantically related keywords for each seed keyword |
includePhraseMatch | boolean | true | No | Get phrase match keywords (keywords containing the seed keyword) |
relatedLimit | integer | 20 | No | Max related keywords per seed keyword |
phraseMatchLimit | integer | 20 | No | Max phrase match keywords per seed keyword |
minVolume | integer | 0 | No | Filter out keywords below this monthly search volume |
maxDifficulty | integer | 100 | No | Filter out keywords above this difficulty score (0-100) |
webhookUrl | string | - | No | Optional webhook URL to send results (Zapier, Make, n8n, or custom) |
webhookPlatform | string | "custom" | No | Select your webhook platform for optimized payload formatting |
demoMode | boolean | true | No | Return sample data without using SEMrush API (for testing) |
*Required when Demo Mode is off.
Pricing
This actor uses pay-per-event billing:
| Event | Description | Price |
|---|---|---|
| Keyword Analyzed | Each keyword research analysis completed | $0.05 |
Demo mode is free -- no charges for sample data.
Troubleshooting
"API key is required"
You have Demo Mode turned off but didn't provide an API key. Either:
- Turn Demo Mode on to test with sample data
- Add your API key in the input
"API error 403" or "Unauthorized"
Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.
"API error 429" or "Rate limit"
Too many requests. Wait a minute and try again, or reduce the number of items per run.
No results or empty dataset
Check the run log for error messages. Common causes:
- Invalid input format (check the examples above)
- API key without proper permissions
- The target data doesn't exist or is too small to track
How do I test without an API key?
Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.
Built by John Rippy | Actor Arsenal