GEThttps://api.rankparse.com/v1/releasesFreeAPI key

Returns the releases logged in your workspace, newest release date first. Use the id as release_id on Get a release report, or read the list to see what else changed around a traffic movement.

Query parameters

sitestring

Only releases of this website, as a host or URL. An invalid value returns 400 invalid_release.

limitintegerdefault 50

Releases to return, 1 to 200. Anything above 200 is clamped.

Response

releasesarray

Each release: id, host, released_on, title, kind, notes, page_contains and created_at.

totalinteger

How many releases are in releases.

Behavior and limits

Credits: 0.
Empty: a workspace with no releases answers 200 with releases: [].

Errors

HTTP	Code	When
400	`invalid_release`	`site` is not a host or URL.
400	`invalid_param`	`limit` is not a positive integer.
401	`invalid_api_key`	Missing, invalid or revoked API key.
429	`rate_limited`	More than 60 requests per minute for this key.

MCP tool: list_releases (optional site and limit).

Log a release

Record a change and the day it went live.

Get a release report

Before and after, read live from the engine.

curl "https://api.rankparse.com/v1/releases?site=reepl.io" \
  -H "X-API-Key: rp_your_key"

Response

{
  "releases": [
    {
      "id": "rel_3f9c1c0e8a534f439b7e3a0f1d2c9e11",
      "host": "reepl.io",
      "released_on": "2026-10-20",
      "title": "New pricing page",
      "kind": "content",
      "notes": null,
      "page_contains": "/pricing",
      "created_at": "2026-11-10T09:12:44.000Z"
    }
  ],
  "total": 1
}

List releases

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

Behavior and limitsCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

Log a release

Get a release report

Query parameters

Response

Behavior and limits

Errors

Related