# seo API (/api/seo)



Live SEO optimization evidence endpoints.

## When To Use This API [#when-to-use-this-api]

The seo API is for agent workflows that need public, platform-native data without writing a custom collector for every task. Use it when a prompt needs evidence from live social records, when a Skill needs repeatable enrichment, or when product code needs the same contract an agent discovered through MCP.

This section lists 42 live seo operations from the canonical OpenAPI spec. Each operation page documents the route, method, parameters, response envelope, pagination behavior when available, and the error vocabulary shared across UnifAPI.

* Use seo operations when an agent needs public records from this platform.
* Call the documented endpoints through MCP or HTTP and keep the response envelope consistent.
* Combine these records with other UnifAPI APIs for research, monitoring, and enrichment workflows.

## Agent Contract Notes [#agent-contract-notes]

Agents usually discover these endpoints with the hosted UnifAPI MCP server, inspect the operation schema, then call only the records needed for the current task. Developers can call the same endpoints over HTTP with an API key, which makes the path from exploratory agent run to production integration direct.

Every successful response uses a stable envelope with a request id, data payload, optional pagination cursor, and billing metadata. Errors use the same closed vocabulary across platforms, so retry logic, user-facing explanations, and cost reporting can stay consistent even when a workflow spans multiple public-data sources.

When you are choosing an operation, start from the public identifier the user already has: a profile username, post id, channel id, subreddit name, search term, or URL-derived slug. Prefer the narrowest endpoint that answers the question, then expand only when the agent needs more evidence. This keeps record usage predictable, makes citations easier to explain, and avoids turning a focused research task into an expensive crawl.

## Operations [#operations]

### Backlinks [#backlinks]

* [`POST /seo/backlinks/anchors`](/api/seo/backlinks/anchors/post) — Get anchor texts used in backlinks to a target — Return the anchor texts used in backlinks pointing to a target, each with backlink, referring-domain, and spam-score counters, to analyze anchor-text distribution.
* [`POST /seo/backlinks/bulk-backlinks`](/api/seo/backlinks/bulk-backlinks/post) — Count backlinks for many targets — Return the total number of backlinks pointing to up to 1000 domains, subdomains, or pages at once, for bulk link-volume comparison.
* [`POST /seo/backlinks/bulk-new-lost-backlinks`](/api/seo/backlinks/bulk-new-lost-backlinks/post) — Count new and lost backlinks for many targets — Return the number of new and lost backlinks for up to 1000 domains, subdomains, or pages since a given date, for bulk link-velocity tracking.
* [`POST /seo/backlinks/bulk-new-lost-referring-domains`](/api/seo/backlinks/bulk-new-lost-referring-domains/post) — Count new and lost referring domains for many targets — Return the number of new and lost referring domains for up to 1000 domains, subdomains, or pages since a given date, for bulk referring-domain velocity tracking.
* [`POST /seo/backlinks/bulk-pages-summary`](/api/seo/backlinks/bulk-pages-summary/post) — Summarize backlinks for many pages at once — Return backlink summaries for up to 1000 pages, domains, or subdomains at once, each with backlink, referring-domain, and spam-score counters, for bulk link-profile comparison.
* [`POST /seo/backlinks/bulk-ranks`](/api/seo/backlinks/bulk-ranks/post) — Get backlink ranks for many targets — Return the backlink rank score (0-1000, similar to PageRank) for up to 1000 domains, subdomains, or pages at once, for quick bulk authority comparison.
* [`POST /seo/backlinks/bulk-referring-domains`](/api/seo/backlinks/bulk-referring-domains/post) — Count referring domains for many targets — Return the number of referring domains pointing to up to 1000 domains, subdomains, or pages at once, for bulk referring-domain comparison.
* [`POST /seo/backlinks/bulk-spam-score`](/api/seo/backlinks/bulk-spam-score/post) — Get spam scores for many targets — Return the DataForSEO spam score (0-100) for up to 1000 domains, subdomains, or pages at once, to flag risky backlink targets in bulk.
* [`POST /seo/backlinks/competitors`](/api/seo/backlinks/competitors/post) — Find competitors by shared referring domains — Return the domains that share referring domains with a target, ranked by the number of shared referring domains, to discover competitors in the same backlink neighborhood.
* [`POST /seo/backlinks/domain-intersection`](/api/seo/backlinks/domain-intersection/post) — Find domains linking to multiple targets — Return the domains that link to a set of targets, with per-target backlink metrics.
* [`POST /seo/backlinks/domain-pages-summary`](/api/seo/backlinks/domain-pages-summary/post) — Summarize backlinks for each page of a target — Return per-page backlink summaries for a target domain or subdomain, each page with backlink, referring-domain, and spam-score counters, to find the most-linked pages.
* [`POST /seo/backlinks/domain-pages`](/api/seo/backlinks/domain-pages/post) — List target pages ranked by backlinks — Return the pages of a target domain or subdomain that receive backlinks, each with crawl data and backlink counters, to find the most-linked pages of a site.
* [`POST /seo/backlinks/history`](/api/seo/backlinks/history/post) — Get historical backlink metrics for a target — Return a monthly time series of a target's backlink profile since 2019 — backlinks, referring domains, new/lost counts, and rank — for link-growth trend analysis.
* [`POST /seo/backlinks/list`](/api/seo/backlinks/list/post) — List individual backlinks pointing to a target — Return the individual backlinks pointing to a target domain, subdomain, or page, each with the referring URL, anchor, dofollow flag, rank, and spam score, for detailed link auditing.
* [`POST /seo/backlinks/page-intersection`](/api/seo/backlinks/page-intersection/post) — Find pages linking to multiple targets — Return the referring pages that link to a set of targets, with the backlinks to each target.
* [`POST /seo/backlinks/referring-domains`](/api/seo/backlinks/referring-domains/post) — List referring domains pointing to a target — Return the domains that link to a target domain, subdomain, or page, each with backlink, referring-domain, and spam-score counters for referring-domain analysis.
* [`POST /seo/backlinks/referring-networks`](/api/seo/backlinks/referring-networks/post) — List referring IP networks pointing to a target — Return the IP addresses or subnets that host pages linking to a target, each with backlink and referring-domain counters, to assess referring-network diversity.
* [`POST /seo/backlinks/summary`](/api/seo/backlinks/summary/post) — Get the backlink profile summary for a target — Return an overview of a target's backlink profile: total backlinks, referring domains/pages/IPs, rank, spam score, and broken-link counters, for a quick link-profile health check.
* [`POST /seo/backlinks/timeseries-new-lost`](/api/seo/backlinks/timeseries-new-lost/post) — Get new and lost backlinks over time — Return a time series of new and lost backlinks and referring domains for a target, grouped by day, week, month, or year, for link-velocity analysis.
* [`POST /seo/backlinks/timeseries`](/api/seo/backlinks/timeseries/post) — Get backlink metrics over time — Return a time series of a target's backlink metrics grouped by day, week, month, or year between two dates, for tracking backlink and referring-domain trends.

### Competitors [#competitors]

* [`POST /seo/competitors/bulk-traffic`](/api/seo/competitors/bulk-traffic/post) — Estimate organic traffic for domains — Return the estimated monthly organic and paid search traffic for a list of domains, for quick competitor sizing and prospecting across many domains at once.
* [`POST /seo/competitors/domain-intersection`](/api/seo/competitors/domain-intersection/post) — Find keywords two domains both rank for — Return the keywords for which two domains both rank, with each domain's position and URL, to find shared keywords or keyword gaps between competitors.
* [`POST /seo/competitors/domain-rank-overview`](/api/seo/competitors/domain-rank-overview/post) — Get a domain's ranking and traffic overview — Return the organic and paid ranking distribution and estimated traffic for a target domain, summarizing how many keywords it ranks for in each position bucket.
* [`POST /seo/competitors/domain`](/api/seo/competitors/domain/post) — Find a domain's organic competitors — Return the domains that compete with a target domain in organic search, with shared-keyword counts and ranking/traffic metrics, for competitive landscape analysis.
* [`POST /seo/competitors/historical-bulk-traffic`](/api/seo/competitors/historical-bulk-traffic/post) — Estimate historical traffic for domains — Return a monthly estimated organic and paid traffic time series for a list of domains since 2019, for comparing competitor growth trajectories over time.
* [`POST /seo/competitors/historical-rank-overview`](/api/seo/competitors/historical-rank-overview/post) — Get a domain's historical ranking overview — Return a monthly time series of a domain's organic and paid ranking distribution and estimated traffic since 2019, for trend and seasonality analysis.
* [`POST /seo/competitors/historical-serps`](/api/seo/competitors/historical-serps/post) — Get historical SERP snapshots for a keyword — Return historical snapshots of the SERP composition for a keyword since 2019, summarizing how many results and which SERP feature types appeared over time.
* [`POST /seo/competitors/page-intersection`](/api/seo/competitors/page-intersection/post) — Find keywords specific pages rank for — Return the keywords that a set of specific page URLs rank for, with each page's position, to analyze keyword overlap across competing pages or your own content.
* [`POST /seo/competitors/ranked-keywords`](/api/seo/competitors/ranked-keywords/post) — Find the keywords a domain ranks for — Return the keywords a target domain or page ranks for in organic search, each with search volume, difficulty, and the exact ranking position and URL, for competitor keyword research.
* [`POST /seo/competitors/relevant-pages`](/api/seo/competitors/relevant-pages/post) — List a domain's top ranking pages — Return the pages of a target domain that drive the most organic search traffic, each with its ranking distribution and estimated traffic, for content gap and page-level analysis.
* [`POST /seo/competitors/serp`](/api/seo/competitors/serp/post) — Find domains competing for keywords — Return the domains that rank for a set of seed keywords, ranked by visibility, with average position, estimated traffic, and the number of shared keywords, to discover SERP competitors.
* [`POST /seo/competitors/subdomains`](/api/seo/competitors/subdomains/post) — List a domain's subdomains with traffic — Return the subdomains of a target domain, each with its organic ranking distribution and estimated traffic, to see which subdomains drive search visibility.

### Keywords [#keywords]

* [`POST /seo/keywords/autocomplete`](/api/seo/keywords/autocomplete/post) — 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`](/api/seo/keywords/difficulty/post) — 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`](/api/seo/keywords/for-site/post) — 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`](/api/seo/keywords/history/post) — Get historical keyword data — Return historical search volume and search ad metrics since 2019 for specified keywords, for trend and seasonality analysis.
* [`POST /seo/keywords/ideas`](/api/seo/keywords/ideas/post) — Discover keyword ideas — Expand seed keywords into related search terms that fall into the same product or service categories, each with search volume, CPC, competition, keyword difficulty, and search intent for SEO and content research.
* [`POST /seo/keywords/intent`](/api/seo/keywords/intent/post) — 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/overview`](/api/seo/keywords/overview/post) — Look up keyword metrics — Return current SEO metrics for specified keywords, including search volume, CPC, competition, keyword difficulty, and search intent, for prioritizing keyword targets.
* [`POST /seo/keywords/related`](/api/seo/keywords/related/post) — 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/suggestions`](/api/seo/keywords/suggestions/post) — Find keyword suggestions — Expand a seed keyword into long-tail search queries that include it, each with search volume, CPC, competition, keyword difficulty, and search intent for SEO and content research.

### Serp [#serp]

* [`POST /seo/serp`](/api/seo/serp/post) — Collect organic SERP SEO evidence — Run one live organic SERP check for SEO optimization evidence, including target visibility, competitor domains, rich SERP features, People Also Ask context, AI Overview presence, and optional pixel ranking data.