Spiral gives your agent every tool with one account. Browse the tools →

Notion · SEO

How to Use DataForSEO Google ranking keywords in Notion

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.

Prompts to try with DataForSEO Google ranking keywords in Notion

Copy an example into Notion, or ask in your own words.

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.

DataForSEO Google ranking keywordsNotion
Try asking
  • 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 Notion

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

Use the Spiral skill

  1. Send Notion 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. Allow custom MCP servers

    A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

  2. Add Spiral to a custom agent

    Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

    https://api.spiral.ai/mcp
  3. Sign in to Spiral and approve

    Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

  4. Run DataForSEO Google ranking keywords in a workflow step

    Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds DataForSEO Google ranking keywords, prices it and runs it each time the step fires.

Use the Spiral CLI

  1. 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

  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.

    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: Notion finds DataForSEO Google ranking keywords on Spiral, shows the price and runs it.

DataForSEO Google ranking keywords providers and prices

Spiral runs DataForSEO Google ranking keywords through Alexandria. Open a card for today's price, with every fee included.

AlexandriaSEO
DataForSEO · Ranked keywords
dataforseo/domains/ranked-keywords

Settings you can ask for

Ask Notion for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 700100

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.

Offseta number from 0

Items to skip, for the next page. Default 0.

Location codea number

DataForSEO location code, such as 2840 for the United States. Use this or location_name.

Ignore synonymson or off

Return only core keywords. Default false.

Load rank absoluteon or off

Add metrics_absolute, the distribution by rank_absolute. Default false.

Historical serp modelive, lost, or all

live (default) for current rankings, lost for lost ones, or all.

Every API field of DataForSEO · Ranked keywords is on its tool page: open its card above.

What can you do with DataForSEO Google ranking keywords in Notion?

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.

Questions about DataForSEO Google ranking keywords in Notion

Can Notion use DataForSEO Google ranking keywords?

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

How much does DataForSEO Google ranking keywords cost in Notion?

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 Notion plan is separate.

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

No. Spiral runs DataForSEO Google ranking keywords on its own Alexandria account. You sign in to Spiral once and never paste a key.

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

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

Does Notion wait while DataForSEO Google ranking keywords runs?

DataForSEO Google ranking keywords runs in the background. Notion 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.

Get started

Start using DataForSEO Google ranking keywords in Notion

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Notion:

Set up Notion

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options