Legacy API reference

Kept working for integrations that already use it. It returns fewer fields than v2 for the same single credit, so there is no reason to choose it for anything new.

Use v2 instead What changes if I migrate

This version is frozen

v1 still works and will keep working. It will not gain new fields, and the social counters it documents have returned zero since the networks behind them closed their APIs.

API v2 returns everything below plus our own Pretty metrics and four additional Majestic fields, for the same one credit.

Check domain

1 credit

Moz and Majestic metrics for one domain.

Request

GET https://domdetailer.com/api/checkDomain.php?apikey=YOUR_KEY&app=YourApp&domain=example.com

Parameters

Name	Required	Description
`apikey`	Required	Your account API key.
`app`	Required	Identifier for the software making the call.
`domain`	Required	The domain to look up.
`majesticChoice`	Optional	Which Majestic variant to read. One of: `root` — `domain.com`. The default. `url` — `https://domain.com`. `subdomain` — `www.domain.com`. `asis` — exactly what you sent.

Example response

200 OK · application/json

{
  "domain": "domainhuntergatherer.com",
  "mozLinks": "163",
  "mozPA": "38.7",
  "mozDA": "26.7",
  "mozRank": "4.37",
  "mozTrust": "4.47",
  "majesticStatReturned": "root",
  "majesticLinks": "93365",
  "majesticRefDomains": "248",
  "majesticRefEDU": "22",
  "majesticRefGov": "0",
  "majesticRefSubnets": "209",
  "majesticIPs": "227",
  "majesticCF": "30",
  "majesticTF": "18",
  "majesticTTF0Name": "Society/People",
  "majesticTTF0Value": "17",
  // social counters, all long since zero
  "FB_shares": "1029",
  "pinterest_pins": "0"
}

Note that v1 returns most values as strings, not numbers. v2 returns proper JSON types.

Check balance

Free

Credits remaining on the account. Never charged.

Request

GET https://domdetailer.com/api/checkBalance.php
  ?apikey=YOUR_KEY
  &app=YourApp

Response

["UnitsLeft", "92921"]

Response fields

Moz

Field	Type	Meaning
`mozLinks`	number	External inbound links.
`mozDA`	number	Domain Authority, 1-100.
`mozPA`	number	Page Authority of the home page, 1-100.
`mozRank`	number	MozRank, 0-10.
`mozTrust`	number	MozTrust, 0-10. Deprecated even within v1.

Majestic

Field	Type	Meaning
`majesticLinks`	number	External inbound links.
`majesticRefDomains`	number	Unique referring domains.
`majesticCF`	number	Citation Flow, 0-100.
`majesticTF`	number	Trust Flow, 0-100.
`majesticRefEDU`	number	Inbound links from .edu domains.
`majesticRefGov`	number	Inbound links from .gov domains.
`majesticRefSubnets`	number	Unique referring class C subnets.
`majesticIPs`	number	Unique referring IP addresses.
`majesticTTF0Name`	string	First Topical Trust Flow category.
`majesticTTF0Value`	number	Trust Flow within that category.
`majesticTTF1Name`	string	Second category.
`majesticTTF1Value`	number	Trust Flow within that category.
`majesticTTF2Name`	string	Third category.
`majesticTTF2Value`	number	Trust Flow within that category.
`majesticStatReturned`	string	Echoes the majesticChoice you sent.

Social — retired

Field	What it was
`FB_shares`	Facebook share count.
`FB_comments`	Facebook comment count.
`pinterest_pins`	Pinterest pin count.
`stumbles`	StumbleUpon count. The service itself closed in 2018.
`google_plus_one`	Google+ count. The service closed in 2019.
`linkedin`	LinkedIn share count.

These keys are still present in the response for backwards compatibility and return zero. They are gone entirely in v2.

Migrating to v2

The parameters are unchanged, so in most cases only the path and a handful of field names need touching. v2 then returns Pretty metrics and four extra Majestic fields on top, at the same cost.

Change the path

- https://domdetailer.com/api/checkDomain.php
+ https://domdetailer.com/api2/checkDomain.php

Then rename these two fields

v1	v2	Why it catches people
`majesticRefEDU`	`majesticRefEdu`	Capitalisation only. Reads as undefined if you do not change it.
`majesticIPs`	`majesticRefIPs`	Renamed for consistency with the other referring counts.

Both are silent failures. A renamed key does not raise an error, it just reads as missing, so a migrated integration can quietly start reporting zero referring IPs.

And drop the social keys

FB_shares, FB_comments, pinterest_pins, stumbles, google_plus_one and linkedin do not exist in v2. They have returned zero for years, so nothing of value is lost.

What you gain

Everything above, plus these, for the same single credit.

prettyLinksIn prettyLinksOut prettyPageCount prettyLinksDofollow prettyLinksEdu prettyLinksGov mozSpam majesticRefIPs majesticRefSubnets

Read the v2 reference