How to Test a REST API for Free — Complete Beginner's Guide 2025

Learning to test REST APIs is one of the most valuable skills a developer can have in 2025. The good news: you don't need to spend a single cent. This guide walks you through everything — what REST is, how HTTP methods work, how to read JSON responses, and how to make your first free API call using three different methods — all with real, working free API endpoints.

What is a REST API?

A REST API (Representational State Transfer Application Programming Interface) is a web service that lets you send requests over HTTP and receive structured data back — almost always in JSON format. Think of it as a menu at a restaurant: you send an order (a request), and the kitchen (the server) sends back exactly what you asked for (the response).

REST APIs power almost every modern application. When your weather app shows today's forecast, when Twitter loads your feed, when you log in with Google — all of that is REST API communication happening behind the scenes.

What makes REST special is that it's stateless: each request contains all the information needed to process it, and the server doesn't remember previous requests. This makes REST APIs fast, scalable, and easy to test independently.

The 4 HTTP Methods Explained

HTTP methods (also called verbs) tell the API server what action you want to perform. There are four you need to know for REST API testing:

For beginner API testing, you'll mostly use GET requests — they're the simplest, require no request body, and are safe to call on any public free API. All the free API endpoints in our directory support GET requests.

PATCH vs PUT

You'll sometimes also see PATCH, which partially updates a resource (only the fields you specify), versus PUT which replaces the entire resource. For testing purposes, treat them similarly — both require sending a JSON body.

HTTP Status Codes You Must Know

Every API response includes a status code — a three-digit number that tells you whether your request succeeded or failed. Always check the status code before trying to parse the response body.

Understanding JSON Responses

JSON (JavaScript Object Notation) is the standard data format used by REST APIs. It's human-readable, lightweight, and natively supported by every modern programming language. When you call a free API, you'll almost always get JSON back.

Here's a real JSON response from the JSONPlaceholder free test API:

// GET https://jsonplaceholder.typicode.com/users/1
{
  "id": 1,
  "name": "Leanne Graham",
  "username": "Bret",
  "email": "[email protected]",
  "address": {
    "street": "Kulas Light",
    "city": "Gwenborough",
    "zipcode": "92998-3874"
  },
  "phone": "1-770-736-0988",
  "website": "hildegard.org"
}

JSON has just four data types you need to know: strings (text in quotes), numbers (no quotes), booleans (true / false), null, objects (key-value pairs in {}), and arrays (ordered lists in []). That's it. Every JSON response you'll ever encounter is made of these building blocks.

Method 1: Test in Your Browser (Zero Setup)

The fastest way to test a free REST API is to paste its URL directly into your browser address bar. Your browser will make a GET request and display the raw JSON. This works for any public API that doesn't require authentication.

Try it right now — copy this URL and paste it into a new browser tab:

https://jsonplaceholder.typicode.com/posts/1

You'll see raw JSON in the browser. To make it readable, install the JSON Formatter extension (available free for Chrome and Firefox). It will automatically pretty-print and colorize every JSON response you view in the browser.

Method 2: Test with curl (Command Line)

curl is a command-line tool pre-installed on Mac and Linux (and available on Windows via Git Bash or WSL). It gives you full control over HTTP requests and is the industry standard for API testing from the terminal.

# Basic GET request — the simplest free API test
curl https://jsonplaceholder.typicode.com/posts/1

# Pretty-print JSON output (requires Python)
curl https://jsonplaceholder.typicode.com/posts/1 | python3 -m json.tool

# See the HTTP status code and headers
curl -I https://jsonplaceholder.typicode.com/posts/1

# Make a POST request with a JSON body
curl -X POST https://jsonplaceholder.typicode.com/posts \
  -H "Content-Type: application/json" \
  -d '{"title":"My Post","body":"Hello world","userId":1}'

# Pass query parameters to a free API
curl "https://open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.1¤t_weather=true"

The -H flag adds a request header, -d sends request body data, and -X specifies the HTTP method. For GET requests you don't need -X GET — it's the default.

Method 3: Test with JavaScript fetch()

For web developers, the fetch() API built into every modern browser is the most practical way to test free APIs. Open your browser DevTools console (F12 → Console tab) and run this directly:

// Test a free REST API right in your browser console
const testAPI = async () => {
  try {
    const response = await fetch('https://jsonplaceholder.typicode.com/posts/1');

    // Always check the status code first
    if (!response.ok) {
      throw new Error(`HTTP error: ${response.status}`);
    }

    const data = await response.json();
    console.log('Status:', response.status);     // 200
    console.log('Data:', data);
    console.log('Title:', data.title);            // Access a field
  } catch (error) {
    console.error('API call failed:', error.message);
  }
};

testAPI();

This pattern — async/await with try/catch — is the professional way to call any free API in JavaScript. The response.ok check catches any 4xx or 5xx errors before you try to parse the body.

5 Free API Endpoints to Practice With

These five free API endpoints are perfect for beginners — no key required, reliable uptime, and clean JSON responses:

1. JSONPlaceholder — https://jsonplaceholder.typicode.com/posts
Returns 100 fake blog posts. Perfect for practicing GET, POST, PUT, and DELETE requests with fake data.

2. Open-Meteo — https://open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.1¤t_weather=true
Real weather data for any location. Great for practicing query parameters.

3. Dog CEO — https://dog.ceo/api/breeds/image/random
Returns a random dog image URL. Simple, fun, and perfect for your first API call.

4. CoinGecko — https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd
Live Bitcoin price. Teaches you how query parameters work in real financial APIs.

5. RestCountries — https://restcountries.com/v3.1/name/canada
Detailed country data. Shows you how APIs return nested objects and arrays.

Next Steps

Now that you understand REST API fundamentals, here's what to do next: pick one of the free APIs above and build something small — a page that shows a random dog photo, a live weather card, or a Bitcoin price ticker. Building a real (even tiny) project will cement these concepts far faster than reading.

When you're ready to go deeper, read our guides on mastering JavaScript's Fetch API, using Postman for API testing, and building a complete weather app with free APIs.