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

Returns the workspace's request log, newest first. The log covers everyone in the workspace, not just your key. It is meant for display and rough reconciliation: not every endpoint writes a row, so treat your credit balance as the source of truth for billing.

Query parameters

limitintegerdefault 50

Rows per page. Values above 200 are clamped to 200. A missing or non-numeric value uses 50.

offsetintegerdefault 0

Rows to skip.

Response

usagearray

Log rows, newest first.

Show properties

endpointstring

Endpoint path without the /v1/ prefix, for example backlinks.

credits_usedinteger

Credits charged for the call. 0 for free calls.

domainstring | null

The domain or url query parameter the call was made with.

created_atinteger

Unix milliseconds.

totalinteger

Total rows in the workspace log, for computing the last page.

Errors

HTTP	Code	When
401	`invalid_api_key`	Missing, invalid or revoked API key.
403	`capability_missing`	Client roles may not view usage.

Get credit balance

The billing source of truth.

Credits

What each endpoint costs.

curl "https://api.rankparse.com/v1/usage?limit=50&offset=50" \
  -H "X-API-Key: rp_your_key"

Response

{
  "usage": [
    {
      "endpoint": "backlinks",
      "credits_used": 2,
      "domain": "stripe.com",
      "created_at": 1760000000000
    },
    {
      "endpoint": "page-seo",
      "credits_used": 3,
      "domain": "https://stripe.com/about",
      "created_at": 1759999900000
    }
  ],
  "total": 1284
}

List usage

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

Get credit balance

Credits

Query parameters

Response

Errors

Related