Skip to content

Demo tier

fetch.li offers a free demo tier so you can try endpoints in a browser, spreadsheet, or prototype without creating an account.

What is free

Every GET endpoint is available on the demo tier:

Category Endpoints
Sky /v1/moon, /v1/sun
Weather /v1/weather, /v1/weather/forecast
UK /v1/uk/bank-holidays, /v1/uk/bank-holiday, /v1/uk/postcode, /v1/uk/working-days
Money /v1/vat, /v1/fx
Tools /v1/convert, /v1/qr, /v1/hash, /v1/uuid, /v1/slug, /v1/countdown, /v1/readtime, /v1/now

You do not need an Authorization header for these on the demo tier.

Also free and unauthenticated:

  • GET /health (uptime check)
  • GET /v1 (machine-readable route catalog)

Rate limit: 60 calls per hour

Demo GET requests are limited to 60 calls per hour per network, with a short burst cap so a retry loop cannot dump 60 calls in one second.

  • Each HTTP request counts as one call, including retries.
  • Strict networks (high automated-abuse corridors) get a lower hourly cap.
  • Some networks cannot use the free demo at all. A paid key still works. See Abuse protection.
  • Honour Retry-After. Repeated 429s become a temporary ban.

The JSON error is ok: false with error.code rate_limited.

Tip: Cache results in your app or spreadsheet when possible. Weather and bank holidays change slowly; you rarely need to call them every second.

Keys: Authentication · Account · Pricing

What is paid

Endpoint Why it is paid
POST /v1/vibe/classify Uses Anthropic Claude for AI classification; costs compute on every request

Vibe classification always requires Authorization: Bearer <token>. There is no anonymous demo for this route.

Sending a valid API key on GET endpoints may unlock higher limits on production plans. Contact support or see pricing for details.

Demo vs production behaviour

Demo (GET, no key) Production (key on POST, or keyed GET plan)
Auth header Not required for GET Required for POST /v1/vibe/classify
Rate limit 60/hour per IP Per your Unkey plan
Response shape Same JSON contract Same JSON contract
Support Best-effort Per your plan

The JSON response format is identical. Your integration code does not need to change when you add a key; only the header and limits differ.

Try it in the browser

Paste a full URL into the address bar:

https://fetch.li/v1/now
https://fetch.li/v1/uk/postcode?code=EH11AA
https://fetch.li/v1/vat?amount=50&rate=20&mode=add

If you see JSON, the demo tier is working.

When to get a key

Get an API key when you need to:

  • Call POST /v1/vibe/classify
  • Exceed 60 GET calls per hour from one IP (automations, production apps)
  • Meet contractual SLAs or support requirements

See Getting started and Authentication.

Related pages