Get historical backlink metrics for a target · SEO API
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.
Using ChatGPT, Claude Code or another client? See the setup steps
curl -X POST https://api.unifapi.com/seo/backlinks/history \ -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.
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.
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
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.
Fields in the data object
A successful Get historical backlink metrics for a target call returns one data object with these fields.
- targetstring
- Target echoed from the request.
- viewstring
- date_fromstring
- Start date of the history echoed from the request.
- date_tostring
- End date of the history echoed from the request.
- seriesobject[]
- Monthly snapshots of the target's backlink profile, oldest to newest.
Agents & Skills built on SEO
You rarely call Get historical backlink metrics for a target 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
Skills
More SEO operations
Combine endpoints from the same platform, then join the results with other UnifAPI categories without changing authentication or response parsing.
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.
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.
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.
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.
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.
Count new and lost referring domains in bulk
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.