Installation

There is nothing to download for the public API. fetch.li is already live on HTTPS. You either open a URL, or your software requests that URL.

For everyone (no terminal)

1. Open a link

Paste this in your browser and press Enter:

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

You will see JSON. The useful line is "answer". Add ?format=text if you only want the sentence:

https://fetch.li/v1/coat?postcode=SW1A1AA&format=text

Bookmark any URL you like. Change the postcode when you move office.

2. Google Sheets

=IMPORTDATA("https://fetch.li/v1/vat?amount=100&rate=20&mode=add&format=text")

Full walkthrough: Spreadsheets and no-code.

3. Zapier / Make / n8n

Use an HTTP GET module. URL is the same as the browser. Map the answer field into Slack, email, or a Google Doc. Guide: Spreadsheets and no-code.

4. Drop a live card on a webpage

Paste this where you want a Pulse line (vanilla JavaScript, no React):

<div data-odrix-pulse data-postcode="SW1A 1AA"></div>
<script src="https://fetch.li/js/pulse-widget.js" defer></script>

The script calls Pulse and fills the box. Honour “reduce motion” in the browser: the widget does not spin.

For developers

Base URL: https://fetch.li (apex also reverse-proxies /v1). Dedicated API host: https://api.fetch.li.

curl -sS "https://fetch.li/v1/pulse?postcode=SW1A%201AA"
curl -sS "https://fetch.li/v1/pulse?postcode=SW1A%201AA&format=text"
curl -sS "https://fetch.li/v1/pulse?postcode=SW1A%201AA&format=svg" -o pulse.svg
curl -sS "https://fetch.li/v1/pulse?postcode=SW1A%201AA&format=prompt"

JavaScript:

const res = await fetch("https://fetch.li/v1/pulse?postcode=SW1A%201AA");
const data = await res.json();
console.log(data.answer, data.kit, data.vibe);

Python:

import requests
data = requests.get(
    "https://fetch.li/v1/pulse",
    params={"postcode": "SW1A 1AA"},
    timeout=8,
).json()
print(data["answer"])

Machine catalog: GET https://fetch.li/v1. Health: GET https://fetch.li/health.

Paid classify needs Authorization: Bearer YOUR_KEY. Never put that key in frontend JavaScript. See Authentication.

What you do not install

No npm package required to call the HTTP API
No React, no Next.js, no Laravel client
Local clone of this repo is only if you are running your own VPS copy

Next: Spreadsheets and no-code or Answer contract.