# 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.

- Page: https://rankfield.dev/endpoints/dataset-status
- Full reference: https://rankfield.dev/docs/data/get-dataset-status

## Request

`GET https://rankfield.dev/v1/datasets/current`

Send `Authorization: Bearer YOUR_API_KEY`. Get a free key at https://rankfield.dev/?tab=key#playground (no account).

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

Response:

```json
{
  "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 | In | Type | Required | Default | 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.

## MCP

Tools on https://rankfield.dev/mcp: `get_dataset_status`.