[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [DataForSEO Google ranking keywords](https://spiral.ai/integrations/instinct/dataforseo-google-ranking-keywords)

# How to Use DataForSEO Google ranking keywords in Instinct

Get keywords a domain or page ranks for on Google, including search volume, ranking URLs, positions, and traffic estimates. Use it to identify specific pages and queries worth improving.

|  |  |
| --- | --- |
| Model | DataForSEO Google ranking keywords |
| Available through | Alexandria |
| Category | SEO |
| Price | Up to $0.0576147 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with DataForSEO Google ranking keywords in Instinct

- Every Friday, use DataForSEO Google ranking keywords for hubspot.com in United States English. Save 50 organic keywords in positions 11 through 20 with search volumes and ranking URLs.
- Every Monday, use DataForSEO Google ranking keywords for canva.com in United States English. Compare the 100 returned organic keywords with the highest search volumes against the previous report and highlight position changes.
- Every Monday at 9am: use DataForSEO Google ranking keywords to look this up and give me the result as a table.
- Pull the latest numbers from DataForSEO Google ranking keywords and tell me what changed since last week.
- Check DataForSEO Google ranking keywords and summarize what you find in three bullet points.

## How to set up DataForSEO Google ranking keywords in Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **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

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run DataForSEO Google ranking keywords**: One request; the result comes back by polling or a webhook.

```bash
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/domains/ranked-keywords",
    "input": {
      "target": "<target>"
    }
  }'
```

Then paste one of the prompts above: Instinct finds DataForSEO Google ranking keywords on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## DataForSEO Google ranking keywords tools and prices

- [DataForSEO · Ranked keywords](https://spiral.ai/tools/alexandria/dataforseo/domains/ranked-keywords) (Alexandria): Up to $0.0576147 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 700 | 100 | Items to return, 1 to 700. DataForSEO allows 1000 (its default is 100); this connector stops at 700 so a call stays within 100 credits. Omitted, 100 is sent. |
| offset | 0 to … | — | Items to skip, for the next page. Default 0. |
| filters |  | — | JSON array of filter conditions in the DataForSEO syntax, at most 8, such as ["keyword_info.search_volume",">",100]. |
| order_by |  | — | Up to 3 sorting rules, each field,direction, such as keyword_info.search_volume,desc. |
| item_types |  | — | SERP element types to include, such as organic, paid, featured_snippet, local_pack. Default organic. |
| language_code |  | — | Language code, such as en. Use this or language_name. |

## What can you do with DataForSEO Google ranking keywords in Instinct?

Produce a weekly brief showing changes in a business's Google search visibility. Compare saved DataForSEO snapshots while accounting for the underlying search result refresh cycle.

### Build a competitive search baseline

Find domains sharing a company's Google ranking keywords, compare their overall ranking distributions, and inspect the queries and URLs behind those totals.

### Prepare a content planning brief

Choose competitors using keyword overlap, compare their search visibility, and collect ranking keywords and URLs to propose topics for editorial review.

### Compare search markets

Research the same business in two countries. Compare the competing domains, overall ranking distribution, and individual ranking queries returned for each market.

### Create a recurring SEO report

Save successive reports and compare competitor overlap, ranking bands, and keyword positions. Describe changes as differences between DataForSEO snapshots.

### Review a business's search presence

For an acquisition or partnership review, examine which domains compete in search, how rankings are distributed, and which keywords and pages contribute estimated traffic.

### Compare organic and paid visibility

Identify competing domains, compare organic and paid ranking summaries, and examine the ranking keywords behind each channel before proposing further research.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## DataForSEO Google ranking keywords in other agents

- [Amp](https://spiral.ai/integrations/amp/dataforseo-google-ranking-keywords)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/dataforseo-google-ranking-keywords)
- [Claude](https://spiral.ai/integrations/claude-desktop/dataforseo-google-ranking-keywords)
- [Claude Code](https://spiral.ai/integrations/claude-code/dataforseo-google-ranking-keywords)
- [Cline](https://spiral.ai/integrations/cline/dataforseo-google-ranking-keywords)
- [Codex](https://spiral.ai/integrations/codex/dataforseo-google-ranking-keywords)
- [Cursor](https://spiral.ai/integrations/cursor/dataforseo-google-ranking-keywords)
- [Devin](https://spiral.ai/integrations/devin/dataforseo-google-ranking-keywords)
- [dots](https://spiral.ai/integrations/dots/dataforseo-google-ranking-keywords)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/dataforseo-google-ranking-keywords)
- [Gemini](https://spiral.ai/integrations/gemini/dataforseo-google-ranking-keywords)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/dataforseo-google-ranking-keywords)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/dataforseo-google-ranking-keywords)
- [goose](https://spiral.ai/integrations/goose/dataforseo-google-ranking-keywords)
- [Grok](https://spiral.ai/integrations/grok/dataforseo-google-ranking-keywords)
- [Grok Build](https://spiral.ai/integrations/grok-build/dataforseo-google-ranking-keywords)
- [Hermes](https://spiral.ai/integrations/hermes/dataforseo-google-ranking-keywords)
- [Manus](https://spiral.ai/integrations/manus/dataforseo-google-ranking-keywords)
- [Muse](https://spiral.ai/integrations/muse/dataforseo-google-ranking-keywords)
- [Muse Code](https://spiral.ai/integrations/muse-code/dataforseo-google-ranking-keywords)
- [n8n](https://spiral.ai/integrations/n8n/dataforseo-google-ranking-keywords)
- [Notion](https://spiral.ai/integrations/notion/dataforseo-google-ranking-keywords)
- [OpenClaw](https://spiral.ai/integrations/openclaw/dataforseo-google-ranking-keywords)
- [opencode](https://spiral.ai/integrations/opencode/dataforseo-google-ranking-keywords)
- [Perplexity](https://spiral.ai/integrations/perplexity/dataforseo-google-ranking-keywords)
- [Raycast](https://spiral.ai/integrations/raycast/dataforseo-google-ranking-keywords)
- [VS Code](https://spiral.ai/integrations/vscode/dataforseo-google-ranking-keywords)
- [Windsurf](https://spiral.ai/integrations/windsurf/dataforseo-google-ranking-keywords)
- [Zapier](https://spiral.ai/integrations/zapier/dataforseo-google-ranking-keywords)

## More Instinct guides

- [DataForSEO Google domain ranking overview](https://spiral.ai/integrations/instinct/dataforseo-google-domain-ranking-overview)
- [DataForSEO backlink summary](https://spiral.ai/integrations/instinct/dataforseo-backlink-summary)
- [DataForSEO Google domain competitors](https://spiral.ai/integrations/instinct/dataforseo-google-domain-competitors)
- [DataForSEO backlinks](https://spiral.ai/integrations/instinct/dataforseo-backlinks)
- [Affiliate.com product search](https://spiral.ai/integrations/instinct/affiliate-com-product-search)
- [DataForSEO referring domains](https://spiral.ai/integrations/instinct/dataforseo-referring-domains)

## Questions about DataForSEO Google ranking keywords in Instinct

**Can Instinct use DataForSEO Google ranking keywords?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run DataForSEO Google ranking keywords like any built-in tool.

**How much does DataForSEO Google ranking keywords cost in Instinct?**

Up to $0.0576147 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need an Alexandria account to use DataForSEO Google ranking keywords in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs DataForSEO Google ranking keywords on its own Alexandria account.

**How long does it take to set up DataForSEO Google ranking keywords in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while DataForSEO Google ranking keywords runs?**

DataForSEO Google ranking keywords runs in the background. Instinct starts the run, checks on it and gives you the json when it's ready.

**Where does DataForSEO get this domain data?**

DataForSEO Labs uses its own keyword and search result databases. These endpoints describe Google search rankings and estimated search traffic.

**How often are these domain reports updated?**

The endpoint documentation specifies weekly updates. Ranked Keywords and Competitors Domain use storage that is refreshed weekly from the underlying databases.

**Does a weekly update mean every Google result was checked that week?**

No. The underlying SERP database takes 30 to 90 days to refresh, depending on query popularity and location.

**How fresh are the search volume metrics?**

DataForSEO updates underlying keyword metrics monthly following the Google Ads update cycle. Search volume and ranking data therefore have different refresh schedules.

**Are traffic figures measured website visits?**

No. Estimated Traffic Volume combines keyword search volume with expected click-through rate. The reports estimate monthly traffic from search.

