What a link is worthmxverify / API
Developers
BV API
The BV score of any website — what one new followed link from it is worth to rankings, in dollars — as JSON, so you can show it on your own pages. Free, with a key.
Look up one site
curl https://mxverify.uk/api/v1/bv/google.com \
-H "Authorization: Bearer mxk_your_key"{
"target": "google.com",
"status": "valued",
"bv": {
"usd": 182.92,
"per": "followed link",
"level": "C",
"caps": "",
"version": "2.8",
"audited": false
},
"report_url": "https://mxverify.uk/publications/google.com",
"attribution": {
"text": "BV by mxverify",
"url": "https://mxverify.uk/publications/google.com",
"required": true
}
}bv.usd is the value of one followed link from the site, as its mxverify report and BV badge show it; level is the kind of link it is priced at (A editorial to D link network) and caps what lowered it; version is the BV model; audited says links placed on the site have been checked.
Look up many
curl https://mxverify.uk/api/v1/bv \
-H "Authorization: Bearer mxk_your_key" \
-H "Content-Type: application/json" \
-d '{"targets": ["google.com", "example.org"]}'Up to 100 targets a request; the answer is {"results": [...]}, one entry per target, in order. Each counts as one lookup.
What a result says
| status | Meaning |
|---|---|
valued | The site's BV, in bv. |
unrated | No authority rating is on record for the site, so a link from it is not valued. bv is null: show nothing rather than $0. |
valuing | mxverify had never valued the site and is valuing it now. Ask again after retry_after seconds (about 2 minutes). A single lookup answers HTTP 202. |
not_valued | A new site could not be valued now: your key's or the day's limit, or a moment's failure. reason says which, retry_after when to try. |
not_found | No website was found at the address when it was valued. |
invalid | The target is not a website address. |
Limits
- 1,000 lookups a day per key (UTC days). Past that: HTTP 429 with
Retry-After. Each answer carriesX-RateLimit-Remaining. - 25 new sites valued a day per key. A site mxverify already values costs nothing to look up; one it has never valued is valued on demand, within this limit and a shared daily budget.
- 5 live keys per account. Keys work from a server or a browser (CORS is open); a key in a public page can be used by anyone who reads it.
Terms of use
- Attribution. Wherever you show a BV from this API, show the words BV by mxverify beside it, as a working link to the site's
report_url(each result'sattributionhas both). For example:<span>BV $183 per link · <a href="https://mxverify.uk/publications/google.com">BV by mxverify</a></span> - What it is. BV is the ranking benefit of one new followed link, from a published model (methodology). It is not a price, a promise of results, or a statement about any site's quality. Do not present it as one.
- Fair use. Stay within the limits above; do not spread one use across many keys or accounts to get past them. A key used against these terms may be revoked.
- As it is. Figures move when a site's record or the model changes, and the service may change or stop. It is provided free, without warranty.