Getting started

fetch.li is designed so you can try most endpoints immediately, without signing up or reading code.

For everyone: use the free Try buttons

On the main site, each documented endpoint has a Try it section with sensible defaults (for example, London coordinates or a sample postcode).

1. Open the docs page for the thing you want (moon times, VAT, weather, and so on).
2. Copy the Try it URL from that page. It looks like a normal web link with ? and parameters at the end.
3. Paste it into your browser address bar and press Enter.
4. You will see JSON text in the browser. That is the answer.

Example: to see today’s moon data for central London, open:

https://fetch.li/v1/moon?postcode=SW1A1AA

No account. No key. The demo tier allows 60 calls per hour from your connection. See Demo tier for limits and what counts as a call.

What you can do without a key

• All GET endpoints are on the free demo tier
• Read answer first, or add ?format=text
• See Spreadsheets and no-code and Answer contract

The one paid endpoint is POST /v1/vibe/classify. Keys, annual billing, and PAYG top-ups: pricing. Who builds this: About.

Tips for non-technical users

• Spreadsheets: Google Sheets can pull format=text or format=csv. See Spreadsheets and no-code.
• No-code tools: Zapier, Make, and similar tools can call a URL and use answer. Same guide.
• Bookmark useful links: A VAT calculator URL with your usual rate saved in bookmarks is a one-click tool.

For developers: get an API key

You only need a key when you call POST /v1/vibe/classify or when you want higher rate limits on GET endpoints (contact support for production plans).

Step 1: Choose a plan

Visit the pricing section on the main site. Keys are sold per product, not per seat: one key can serve your backend, cron jobs, and staging environment if you manage it carefully.

Step 2: Receive your key

After checkout you receive a Bearer token (a long secret string). Treat it like a password.

Your key is managed through Unkey. fetch.li verifies it on every protected request. You do not send your Unkey root key; you send the customer API key issued to you.

Step 3: Send the key on protected requests

Add an HTTP header:

Authorization: Bearer YOUR_API_KEY_HERE

Never put this header in frontend JavaScript that ships to browsers, and never commit it to Git. See Authentication.

Step 4: Make a test call

With a key, classify a short piece of copy:

curl -sS https://fetch.li/v1/vibe/classify \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"texts":["Quiet luxury without the theatre."]}'

You should receive a JSON array with primary_vibe, mood_tags, and color_palette. Full details: Vibe classify.

Step 5: Explore GET endpoints

GET endpoints work the same with or without a key on the demo tier. With a production key (when available), you may get higher limits; the request shape does not change.

curl -sS "https://fetch.li/v1/vat?amount=100&rate=20&mode=add"

Where to go next