SEO

Look up keyword metrics · SEO API

POST/seo/keywords/overview
$$min $0.05

Return current SEO metrics for specified keywords, including search volume, CPC, competition, keyword difficulty, and search intent, for prioritizing keyword targets.

Add to Claude(opens claude.ai in a new tab)Read the docs

Using ChatGPT, Claude Code or another client? See the setup steps

Request
curl -X POST https://api.unifapi.com/seo/keywords/overview \
  -H "Authorization: Bearer $UNIFAPI_KEY" \
  -H "Content-Type: application/json"

Parameters

The parameter for this SEO operation. Use the URL-visible slug or id described in the docs.
The parameter for this SEO operation. Use the URL-visible slug or id described in the docs.
Overview

This operation is part of the SEO API in the seo category. It uses the same Bearer token, request tracing, error model, and billing envelope as every UnifAPI endpoint, so agents can switch between platforms without custom per-vendor glue code.

Use it when a workflow needs SEO public data but should still keep one API key, one account balance, and one predictable JSON contract across social, live public-data sources.

Common agent workflows

  • Fetch canonical public SEO content for summarization, ranking, monitoring, or enrichment.
  • Attach engagement, author, media, and source metadata to an agent workflow.
  • Give an AI agent a stable SEO data source without building a per-platform integration.
  • Normalize SEO responses into the same UnifAPI envelope used across the catalog.
Response shape

Unified envelope, platform-native fields

  • Lookup responses return one canonical object in `data` with stable identifiers, source URLs where available, and platform-specific metadata normalized into predictable JSON.
  • The operation has a 50 credits ($0.05) minimum charge, so `billing.records_charged` can be higher than the visible records returned.
  • A not-found or invalid-input condition uses the unified UnifAPI error shape, so callers do not need special handling for each source platform.

Response status codes

200400401402404429500502503

Billing

This operation charges 1 credit per billable record, with a 50 credits ($0.05) operation minimum. Public responses include billing metadata with credits charged, records charged, and remaining workspace balance. Incorrect Credit deductions caused by platform failures can be restored as billing corrections.

Errors and retries

Authentication, validation, rate-limit, not-found, and provider errors use the unified UnifAPI error format. Agents should log `request_id`, retry only retryable failures, and treat invalid API keys, disabled keys, and expired keys as the same public `unauthorized` error type.

Response fields

Fields in the data object

A successful Look up keyword metrics call returns one data object with these fields.

keywordsstring[]
Keywords echoed from the request.
locationstring
languagestring
viewstring
resultsobject[]
Per-keyword metrics: search volume, CPC, competition, difficulty, and intent. Each keyword is one billable record.
Run it

Agents & Skills built on SEO

You rarely call Look up keyword metrics by hand. These prebuilt agents and skills already read SEO data inside Claude or Codex — start from one of them, or call this endpoint yourself.

Try it free in the browser

Keyword search volume checker

Check monthly search volume, difficulty, intent, and CPC for up to 10 keywords.

Keyword generator — ideas, volume & difficulty

Turn one seed keyword into hundreds of related terms with volume and difficulty.

Backlink checker

Referring domains, total backlinks, backlink rank and spam score for any domain.

Domain authority & traffic checker

Authority score, estimated organic traffic and ranked keywords for any domain.

Agents

SEO AgentAI Visibility AgentLocal SEO AgentContent Strategy AgentCompetitive Intelligence AgentReal Estate Marketing AgentMed Spa Marketing AgentDental Marketing AgentLaw Firm Marketing AgentRestaurant Marketing AgentHome Services Marketing Agent

Skills

Content Opportunity Brief AgentSEO AuditSEO Fix PlanKeyword ResearchMed Spa Reputation BenchmarkTreatment Demand RadarAI Visibility AuditAI Answer GapAI Visibility Fix PlanLocal Pack AuditListing Accuracy AuditLocal Competitor ScanContent StrategyCustomer ResearchCompetitor ProfilingNeighborhood Guide OpportunityAgent Reputation BenchmarkDental Reputation BenchmarkPatient Question ContentPractice Area Rank AuditAttorney Reputation BenchmarkRestaurant Local BuzzMenu Demand RadarService Area Rank AuditHomeowner Question Content
Related endpoints

More SEO operations

Combine endpoints from the same platform, then join the results with other UnifAPI categories without changing authentication or response parsing.

POST/seo/keywords/intent

Classify keyword search intent

Return the search intent (informational, navigational, commercial, or transactional) with probabilities for up to 1,000 keywords, for mapping keywords to the right content type.

POST/seo/keywords/related

Find related keywords

Expand a seed keyword using the 'searches related to' element, each with search volume, CPC, competition, keyword difficulty, and search intent for SEO and content research.

POST/seo/keywords/autocomplete

Collect autocomplete keyword suggestions

Run one live autocomplete lookup for a seed query and receive the suggested searches the engine offers, with relevance scores — useful for SEO keyword discovery and content-gap research.

POST/seo/keywords/difficulty

Score keyword difficulty

Return the keyword difficulty (0-100 chance of ranking in the top-10 organic results) for up to 1,000 keywords in one request, for prioritizing achievable SEO targets.

POST/seo/keywords/for-site

Find keywords a domain ranks for

Return the keywords a target domain is relevant for, each with search volume, CPC, competition, keyword difficulty, and search intent, for competitor and own-site keyword research.

POST/seo/keywords/history

Get historical keyword data

Return historical search volume and search ad metrics since 2019 for specified keywords, for trend and seasonality analysis.

All SEO API endpoints