SEO and Keyword Data API
FreeNot checkedSEO data: keyword volume, CPC, Trends, backlinks, domains, SERP, Maps, audits. Pay per call (x402)
About
SEO data: keyword volume, CPC, Trends, backlinks, domains, SERP, Maps, audits. Pay per call (x402)
README
SEO and keyword data API for AI agents: Google search volume, CPC, keyword difficulty, keyword ideas, Google Trends, SERP results, backlinks, domain rankings, keyword gap, on-page audits and more. 44 routes, $0.012 to $0.25 per call, paid per request with x402 (USDC on Base). No API key, no signup, no subscription.
This is the TypeScript client for https://keywords.duoleads.com. It is also part of duo-data-utilities (as client.keywords); this package has the keyword client only.
Install
npm install x402-seo-keyword-data viem
viem creates the wallet account that pays. Node.js 20 or later.
Python: pip install x402-seo-keyword-data (the same client in snake_case; source in python/).
Quick start
import { privateKeyToAccount } from "viem/accounts";
import { createClient } from "x402-seo-keyword-data";
// Your wallet holds USDC on Base. Read the key from the environment, never a literal.
const client = createClient({ account: privateKeyToAccount(process.env.PAYER_KEY as `0x${string}`) });
const volume = await client.searchVolume({ keywords: ["phone", "watch"], country: "us" }); // $0.04
const ideas = await client.keywordIdeas({ keyword: "seo api", limit: 50 }); // $0.04
const trend = await client.trend({ keyword: "seo tools", timeframe: "past_12_months" }); // $0.045
const serp = await client.serp({ q: "coffee maker", country: "us" }); // $0.018
const gap = await client.keywordGap({ domain: "example.com", competitor: "example.org" }); // $0.048
const links = await client.backlinks({ target: "example.com" }); // $0.048
Each method sends the route's request (most are POST with a JSON body, a few GET), pays the 402 challenge with your wallet and resolves to the JSON answer. client.callWithReceipt(path, params) also returns the settlement receipt (transaction hash).
Price guard
Before anything is signed, the client checks the payment requirement: Base USDC only, only to the service's address 0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39, and never above the cap. By default each route is capped at its own listed price; createClient({ account, maxPriceUsd: 0.05 }) sets one cap for every route. A refused call signs nothing and throws PriceGuardError. The client never retries a paid call on its own.
Errors and charges
A bad input is answered free with a 400; an upstream failure is a 503 with "nothing was charged". Both throw DuoApiError with code, param, expected and requestId.
Routes
| Method | Route | Price | MCP tool | What it returns |
|---|---|---|---|---|
client.keywordOverview |
POST /v1/keyword-overview |
$0.04 | keyword_overview |
Keyword overview (up to 100 keywords) |
client.searchVolume |
GET /v1/search-volume |
$0.04 | keyword_search_volume |
Search volume (GET, up to 20 keywords) |
client.keywordIdeas |
POST /v1/keyword-ideas |
$0.04 | keyword_ideas |
Keyword ideas (up to 100 per seed) |
client.trend |
GET /v1/trend |
$0.045 | google_trends |
Google Trends interest over time |
client.relatedQueries |
GET /v1/related-queries |
$0.03 | google_trends_related_queries |
Google Trends related queries |
client.interestByRegion |
GET /v1/interest-by-region |
$0.03 | google_trends_by_region |
Google Trends interest by region |
client.relatedKeywords |
POST /v1/related-keywords |
$0.04 | related_keywords |
Related keywords (up to 100, depth 0-4) |
client.keywordVariations |
POST /v1/keyword-variations |
$0.04 | keyword_variations |
Keyword variations containing a phrase (up to 100) |
client.keywordDifficulty |
POST /v1/keyword-difficulty |
$0.04 | keyword_difficulty |
Keyword difficulty (up to 100 keywords) |
client.searchIntent |
POST /v1/search-intent |
$0.04 | search_intent |
Search intent (up to 100 keywords) |
client.keywordVolumeHistory |
POST /v1/keyword-volume-history |
$0.048 | keyword_volume_history |
Monthly search volume history (up to 20 keywords) |
client.keywordSuggestions |
POST /v1/keyword-suggestions |
$0.04 | keywords_for_site |
Keywords for a site or page (up to 100) |
client.trends |
POST /v1/trends |
$0.045 | google_trends_compare |
Google Trends comparison (up to 5 keywords) |
client.domainOverview |
POST /v1/domain-overview |
$0.04 | domain_overview |
Domain overview (organic and paid visibility) |
client.trafficEstimate |
POST /v1/traffic-estimate |
$0.04 | traffic_estimate |
Traffic estimate (up to 100 domains) |
client.rankedKeywords |
POST /v1/ranked-keywords |
$0.048 | ranked_keywords |
Ranked keywords of a domain (up to 100) |
client.competitors |
POST /v1/competitors |
$0.048 | competitor_domains |
Competitor domains (up to 100) |
client.keywordGap |
POST /v1/keyword-gap |
$0.048 | keyword_gap |
Keyword gap: competitor-only keywords (up to 100) |
client.serpCompetitors |
POST /v1/serp-competitors |
$0.048 | serp_competitors |
Domains ranking for a keyword set (up to 100) |
client.relevantPages |
POST /v1/relevant-pages |
$0.048 | relevant_pages |
Top pages of a domain (up to 100) |
client.historicalRank |
POST /v1/historical-rank |
$0.25 | historical_rank |
Monthly rank history of a domain (24 months) |
client.pageIntersection |
POST /v1/page-intersection |
$0.048 | page_intersection |
Keywords shared by pages (up to 20 pages) |
client.backlinks |
POST /v1/backlinks |
$0.048 | backlinks_summary |
Backlink profile summary |
client.backlinksList |
POST /v1/backlinks-list |
$0.048 | backlinks_list |
Backlinks list (up to 100) |
client.referringDomains |
POST /v1/referring-domains |
$0.048 | referring_domains |
Referring domains (up to 100) |
client.backlinkAnchors |
POST /v1/backlink-anchors |
$0.048 | backlink_anchors |
Backlink anchor texts (up to 100) |
client.backlinksHistory |
POST /v1/backlinks-history |
$0.048 | backlinks_history |
Backlink profile history (up to 24 months) |
client.onPage |
POST /v1/on-page |
$0.012 | on_page_audit |
On-page SEO audit of a URL |
client.pagespeed |
POST /v1/pagespeed |
$0.018 | pagespeed |
Page speed (Lighthouse Core Web Vitals) |
client.amazonKeywords |
POST /v1/amazon-keywords |
$0.04 | amazon_keywords |
Amazon keyword ideas and volume |
client.amazonSearch |
POST /v1/amazon-search |
$0.012 | amazon_search |
Amazon search results (products) |
client.serp |
GET /v1/serp |
$0.018 | google_search |
Google search results (10, 20 or 50) |
client.mapsSearch |
GET /v1/maps-search |
$0.018 | google_maps_search |
Google Maps places (up to 100) |
client.serpHistory |
POST /v1/serp-history |
$0.018 | serp_history |
Google results-page history (one past snapshot) |
client.businessListings |
POST /v1/business-listings |
$0.08 | business_listings |
Business listings by name or category (up to 50) |
client.autocomplete |
GET /v1/autocomplete |
$0.012 | google_autocomplete |
Google autocomplete suggestions |
client.bingSerp |
GET /v1/bing-serp |
$0.018 | bing_search |
Bing search results (10, 20 or 50) |
client.youtubeSearch |
GET /v1/youtube-search |
$0.012 | youtube_search |
YouTube search results (20 or 40) |
client.googleAdsKeywords |
POST /v1/google-ads-keywords |
$0.16 | google_ads_keywords |
Google Ads keyword ideas (up to 100) |
client.clickstreamSearchVolume |
POST /v1/clickstream-search-volume |
$0.04 | clickstream_search_volume |
Clickstream search volume (up to 100 keywords) |
client.brandMentions |
POST /v1/brand-mentions |
$0.048 | brand_mentions |
Brand mentions on the web (up to 100) |
client.techStack |
POST /v1/tech-stack |
$0.024 | tech_stack |
Website technology stack |
client.whois |
POST /v1/whois |
$0.21 | whois_overview |
WHOIS overview of a domain |
client.llmMentions |
POST /v1/llm-mentions |
$0.21 | llm_mentions |
AI answers mentioning a keyword (up to 20) |
SEO_KEYWORD_ROUTES holds this table as data (path, HTTP method, MCP tool, price).
MCP and plain HTTP
The same 44 tools are a paid MCP server at https://keywords.duoleads.com/mcp (Streamable HTTP; tools/list is free). Every route also works without this package: an unpaid request returns 402 Payment Required with a PAYMENT-REQUIRED header, and any x402 v2 client can pay it.
Links
- Docs: https://keywords.duoleads.com/docs
- OpenAPI: https://keywords.duoleads.com/openapi.json
- Machine-readable index: https://keywords.duoleads.com/llms.txt
- Terms: https://keywords.duoleads.com/terms
- Privacy: https://keywords.duoleads.com/privacy
- Listed on PayAPI Market (settlement-verified): https://payapi.market/api/seo-and-keyword-data-api
Data only: search volumes, CPC and rankings are estimates from third-party providers and public sources; not affiliated with or endorsed by Google, Bing, YouTube or Amazon.
Source
Source: github.com/hiesem/x402-seo-keyword-data is a generated mirror of this package from the duo-data-utilities monorepo (packages/x402-seo-keyword-data); issues are welcome in either repository.
License
MIT. See LICENSE.
Installing SEO and Keyword Data API
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/hiesem/x402-seo-keyword-dataFAQ
Is SEO and Keyword Data API MCP free?
Yes, SEO and Keyword Data API MCP is free — one-click install via Unyly at no cost.
Does SEO and Keyword Data API need an API key?
No, SEO and Keyword Data API runs without API keys or environment variables.
Is SEO and Keyword Data API hosted or self-hosted?
A hosted option is available: Unyly runs the server in the cloud, no local setup required.
How do I install SEO and Keyword Data API in Claude Desktop, Claude Code or Cursor?
Open SEO and Keyword Data API on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare SEO and Keyword Data API with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
