How to Use Google keyword difficulty in dots
Returns a 0 to 100 score for the difficulty of reaching Google's top 10 organic results for each keyword. Use it to compare ranking difficulty across an existing keyword shortlist.
Prompts to try with Google keyword difficulty in dots
Copy an example into dots, or ask in your own words.
Each month, use Google keyword difficulty for 'trail running shoes', 'waterproof running shoes', and 'running shoes for beginners' for English searches in the United States. Report score changes from the previous check.
Every Monday at 9am: use Google keyword difficulty to look this up and give me the result as a table.
Pull the latest numbers from Google keyword difficulty and tell me what changed since last week.
Check Google keyword difficulty and summarize what you find in three bullet points.
Pull the newest data from Google keyword difficulty and give me the result as a table.
How to set up Google keyword difficulty in dots
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send dots this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Create an API key
In the console, open API keys and create a key for your dot. Copy it.
- Send your dot this message
Your dot reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- Give your dot the key
When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Google keyword difficulty
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "dataforseo/keywords/difficulty", "input": { "keywords": [ "<keywords>" ], "language_code": "<language_code>", "location_code": 1 } }'
Then paste one of the prompts above: dots finds Google keyword difficulty on Spiral, shows the price and runs it.
Google keyword difficulty providers and prices
Spiral runs Google keyword difficulty through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask dots for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Location code | a number | DataForSEO location code, such as 2840 for the United States. Use this or location_name. |
Every API field of DataForSEO · Keyword difficulty is on its tool page: open its card above.
What can you do with Google keyword difficulty in dots?
Maintain a monthly keyword research digest for a defined market and topic. Compare newly returned DataForSEO phrases and metrics with earlier results to flag changes worth an editor's review.
Choose the next articles to commission
Expand running shoe topics with category ideas and longer phrases. Compare search demand and organic difficulty, then use intent labels to separate buying guides from informational articles.
Plan ecommerce category pages
Research terms around espresso machines, including related product categories and specific buying queries. Use demand, difficulty, and search intent to propose category pages and supporting guides.
Compare keyword opportunities across markets
Research English-language standing desk queries separately for the United States and United Kingdom. Compare discovered phrases, demand, and country-specific difficulty, then classify the shortlisted terms by intent.
Prioritize existing content updates
Take the topics from an existing cycling guide library and look for related searches and more specific phrases. Combine demand, difficulty, and intent with your content inventory to recommend which pages to expand first.
Build a help center topic backlog
Expand spreadsheet topics into related subjects and detailed questions. Classify informational searches and compare their organic difficulty before proposing tutorial briefs.
More on Google keyword difficulty and dots
Overview
Google keyword difficulty in other agents
Questions about Google keyword difficulty in dots
Can dots use Google keyword difficulty?
Yes. Add Spiral to dots as an MCP server, and dots can find and run Google keyword difficulty like any built-in tool.
How much does Google keyword difficulty cost in dots?
Up to $0.17459 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.
Do I need an Alexandria account to use Google keyword difficulty in dots?
You need no Alexandria account. dots uses one Spiral API key for every tool, and Spiral runs Google keyword difficulty on its own Alexandria account.
How long does it take to set up Google keyword difficulty in dots?
About two minutes: create an API key, then send your dot this message, then give your dot the key.
Does dots wait while Google keyword difficulty runs?
Google keyword difficulty runs in the background. dots starts the run, checks on it and gives you the json when it's ready.
How fresh is DataForSEO's keyword data?
The keyword database follows a monthly refresh cycle tied to Google Ads. Search results used by DataForSEO Labs refresh on a separate cycle of 30 to 90 days, depending on the query and location.
Are search volumes exact counts for each phrase?
Google groups similar keywords and can report their combined search volume. That makes these figures unsuitable for measuring small differences between closely related spellings or phrases.
Does competition mean organic ranking difficulty?
Google Ads competition measures competition among advertisers in paid search. Organic difficulty is a separate DataForSEO score from 0 to 100 for reaching Google's top 10 organic results.
How much monthly history is available?
Google Ads keyword search volume offers up to four years of history. Keyword discovery results include a shorter history covering the previous 12 months.
Does DataForSEO cover every country?
No. DataForSEO says locations in Russia and Belarus are no longer supported across its services.
Start using Google keyword difficulty in dots
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into dots:
set up https://spiral.ai/SKILL.md


