Dataset Status API

Returns the web graph release, build, date and size behind every link endpoint. Store release and buildId with your results, so you know which numbers can be compared.

GEThttps://rankfield.dev/v1/datasets/current

Send Authorization: Bearer YOUR_API_KEY. Get a free key; no account needed.

curl "https://rankfield.dev/v1/datasets/current" \
  -H "Authorization: Bearer $RANKFIELD_API_KEY"

import os
import requests

response = requests.get(
    "https://rankfield.dev/v1/datasets/current",
    headers={"Authorization": f"Bearer {os.environ['RANKFIELD_API_KEY']}"},
)
print(response.json())

const response = await fetch("https://rankfield.dev/v1/datasets/current", {
  headers: {
    Authorization: `Bearer ${process.env.RANKFIELD_API_KEY}`,
  },
});
console.log(await response.json());

Response

{
  "graph": {
    "release": "2026-may-jun-jul",
    "asOf": "2026-08-19T00:00:00Z",
    "siteStrengthVersion": "authority-continuous-counts-0.3.1",
    "siteStrengthVersionSource": "live",
    "completeRelationships": true,
    "buildId": "graph-2026mayjunjul-v3",
    "domains": 117963409,
    "inboundRelationships": 2774625913,
    "outboundRelationships": 2774625913
  },
  "pageEvidence": { "ready": false, … },
  "backlinkIndex": { "ready": false, … }
}

Parameters#

Name	Type	Description

Response#

Field	Type	Description
`graph.release` `graph.buildId`	string	The web graph release and its build.
`graph.asOf`	string	The date the graph describes (RFC 3339, UTC).
`graph.siteStrengthVersion` `siteStrengthVersionSource`	string	The Site Strength model in effect now, and where we read it: `live` from the Site Strength service, or `manifest` when the service did not answer.
`graph.domains` `graph.inboundRelationships`	integer	Domains and domain-to-domain links in the graph.
`pageEvidence.ready` `backlinkIndex.ready`	boolean	`false` today: page-level link evidence is not published.

Errors#

Errors come as {"error":{"message":"…"}} with the HTTP status.

Status	When
`401`	The key is missing, unknown or revoked.
`503`	The graph is briefly unavailable. Retry after `Retry-After`.

Price and limits#

Free; no per-call charge.
No daily quota or concurrency cap per key.

Dataset Status API

Parameters#

Response#

Errors#

Price and limits#

See also#

Related endpoints#