LIVEReading: Test Any API for Free with Hoppscotch (No Install Needed)Total time: 8 minSteps: 6Worked first time: 95% LIVEReading: Test Any API for Free with Hoppscotch (No Install Needed)Total time: 8 minSteps: 6Worked first time: 95%
CBW
Test Any API for Free with Hoppscotch (No Install Needed)
Easygithub.com/hoppscotch/hoppscotch2026-06-17

Test Any API for Free with Hoppscotch (No Install Needed)

Hoppscotch is a free, open-source alternative to Postman that runs in your browser. Send HTTP requests, test APIs, and organize your work — no account required to start.

// Build stats

  • Total time8 min
  • Number of steps6
  • DifficultyEasy
  • Worked first time95%
// Before you start

What you need

  • A modern web browser (Chrome, Firefox, Edge, or Safari)
  • An API URL you want to test (or use a public one from the guide)
  • Optional: a free Hoppscotch account for saving and syncing work
01
Step 1 of 6

Open Hoppscotch in your browser

1 min

Hoppscotch runs entirely in your browser — nothing to download or install. Just open the URL and you land directly in the API testing interface. It looks similar to Postman but loads instantly.

Terminal · mac
$ https://hoppscotch.io
What you should see
A dark-themed app loads with a URL bar in the center, a method dropdown on the left (showing GET), and a Send button on the right.
02
Step 2 of 6

Send your first test request

2 min

You will use a free public API to confirm everything works. This API returns a random joke as JSON — a safe, no-auth-required endpoint. Paste the URL into the address bar, make sure the method is set to GET, then click Send. The response appears in the panel below.

Terminal · mac
$ https://official-joke-api.appspot.com/random_joke
What you should see
A JSON response appears in the bottom panel, something like: {"id":1,"type":"general","setup":"Why did the scarecrow win an award?","punchline":"Because he was outstanding in his field."}. The status shows 200 OK.
This might happen

Response panel stays empty or shows a CORS error

Click the shield/proxy icon in the top-right toolbar and enable the Hoppscotch proxy. This routes your request through their server and fixes most CORS and HTTP-only endpoint issues.

03
Step 3 of 6

Add headers or authorization to a request

3 min

Most real APIs require an API key or a Bearer token. Click the 'Headers' tab below the URL bar to add key-value pairs, or click the 'Authorization' tab to pick a type (None, Basic, Bearer Token, OAuth 2.0) and fill in your credentials. Hoppscotch sends them automatically with every request.

Terminal · mac
$ Click the 'Authorization' tab → select 'Bearer Token' → paste your token into the Token field
What you should see
An Authorization header appears automatically in the Headers tab showing: Bearer <your-token>. The next request you send will include it.
This might happen

You are not sure where to get a Bearer token

Check the API's own documentation — it is usually under 'Authentication' or 'Getting Started'. Many APIs let you generate a free token on their dashboard.

04
Step 4 of 6

Save requests into a Collection

3 min

Collections keep your requests organized, just like folders on your desktop. Click the save icon (floppy disk) next to the Send button, give the request a name, then create a new Collection to put it in. You can build unlimited collections and nest folders inside them. Collections are saved locally in your browser — no account needed.

Terminal · mac
$ Click the save icon → enter a Request Name → click 'New Collection' → name it → click Save
What you should see
A sidebar panel on the left shows your new collection with the saved request listed inside it. Click the request name any time to reload it instantly.
This might happen

Collections disappear after clearing browser data

Sign up for a free Hoppscotch account and sign in. Your collections then sync to the cloud and survive browser clears.

05
Step 5 of 6

Use Environment Variables to avoid repeating values

3 min

If your base URL or API key appears in many requests, store it once as a variable. Click the Environments icon (looks like a leaf) in the left sidebar, create a new environment, and add a variable like 'base_url' with the value of your API's root URL. Then in any request URL, type {{base_url}} and Hoppscotch replaces it automatically.

Terminal · mac
$ Click Environments icon → New Environment → Add Variable: Name = base_url, Value = https://api.example.com → Save. In the URL bar type: {{base_url}}/endpoint
What you should see
The URL bar shows {{base_url}}/endpoint in orange/highlighted text. When you click Send, Hoppscotch substitutes the real value and the request goes to https://api.example.com/endpoint.
This might happen

{{base_url}} is not replaced and the request fails

Make sure the correct environment is selected. Click the environment dropdown in the top-right corner of the app and choose the environment you just created.

06
Step 6 of 6

Install the Desktop app or CLI (optional)

5 min

If you prefer a standalone app instead of a browser tab, Hoppscotch offers a desktop download for Windows, Mac, and Linux. For automation or scripting, there is also a CLI. Both are optional — the web version does everything described above.

Terminal · mac
$ Desktop app: https://hoppscotch.com/download
$
$ CLI (requires Node.js already installed):
$ npx @hoppscotch/cli --help
What you should see
Desktop: an installer downloads and launches a native window identical to the web app. CLI: a help menu prints available commands in your terminal.
This might happen

npx command not found

You need Node.js installed first. Download it from https://nodejs.org — choose the LTS version and run the installer. Then retry the npx command.

// Status

cooked. baked. worked.

A fully working API testing workspace in your browser. You can send GET, POST, PUT, DELETE, and other requests; add headers and auth tokens; organize requests into collections; and reuse values with environment variables — all for free, with no installation.

// the honest bit

The honest part

Hoppscotch is excellent for manual API testing and beats Postman for simplicity. However, the free web version stores data only in your browser — clear your cache and your unsaved work is gone. Team collaboration, SSO, and self-hosting require either a free cloud account or setting up the self-hosted version (which does require Docker and developer knowledge). The CLI is powerful but not beginner-friendly without reading the docs. This guide covers the zero-install web workflow only.