Hanzo
OpenapiSeo

Who links to a target, and how much of it is broken or spam

Summarises who links to a target. It returns the authority score, how many links point at it and from how many distinct sites, how many of those are…

POST /v1/seo/backlinks

Addresshttps://api.hanzo.ai/v1/seo/backlinks
MethodPOST
OperationseoBacklink
AuthAuthorization: Bearer $HANZO_API_KEY

Summarises who links to a target.

It returns the authority score, how many links point at it and from how many distinct sites, how many of those are broken, and how much of the profile reads as spam. Distinct sites is the number to read: a thousand links from one domain is one endorsement, and a profile that grew fast in links and not in domains is usually a profile somebody bought.

The target can be a whole domain, a subdomain, or one page URL — the summary is scoped to whatever is named. It is priced per request, so a domain with ten million links costs the same as one with ten.

Request

1 field, body application/json (required).

FieldInTypeRequiredDescription
targetbodystringTarget is a domain, a subdomain or a single page URL.

Response

StatusBodyMeaning
200seoBacklinkOutok

200 body — 9 fields.

FieldInTypeAlwaysDescription
backlinksbodyintegerBacklinks is how many links point at it.
brokenbodyintegerBroken is how many of those links point at something that no longer answers.
costbodystringCost is what this call cost, in USD, as an exact decimal string.
domainsbodyintegerDomains is how many distinct sites those links come from — the number that matters, since a thousand links from one site is one site.
firstSeenbodystringFirstSeen is when the upstream first saw a link to this target, RFC 3339.
pagesbodyintegerPages is how many distinct pages link in.
rankbodyintegerRank is the upstream's authority score for the target, 0 to 1000.
spambodyintegerSpam is the share of the profile judged spam, 0 to 100.
targetbodystringTarget is the target as the upstream resolved it.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


SEO API · All Hanzo APIs · Interactive reference

How is this guide?

On this page