Plan Metadata

Get machine-readable plan request limits

Changed on

Canonical, keyless source of truth for the free-tier allowance and every paid plan's request limit and window (#5793). First-party clients — the website, docs, SDKs, spreadsheet add-ins and the browser extension — read this instead of hardcoding a limit, which is how "200 requests/month" previously drifted across 229 call sites.

Unauthenticated and heavily cached. Prefer this over parsing pricing copy.

get/v1/meta/limits

Request

  • Base URL
    https://api.oilpriceapi.com
  • Auth
    none required

Response

Current free-tier allowance and the paid plan ladder

statusstring

Example response

{
  "status": "success",
  "data": {
    "free": {
      "limit": 50,
      "window": "day",
      "copy": "50/day"
    },
    "plans": [
      {
        "plan": "developer",
        "limit": 10000,
        "window": "month",
        "copy": "10,000/month"
      }
    ]
  }
}

Changes