How to Use an API: A Complete Beginner's Guide

1. What is an API?

An API (Application Programming Interface) lets your code talk to another service over the internet. You send a request to a URL, and the server sends back data (usually in JSON format).

For example, a weather API lets you ask "What's the temperature in Tokyo?" and get back a structured answer that your program can use.

2. What You Need

3. Try it in Your Browser

The simplest way to call an API is to paste its URL into your browser's address bar. Try this right now:

https://theaxolotlapi.netlify.app/

You should see JSON data appear in your browser. That's it — you just made your first API call!

4. Using curl (Terminal / Command Line)

curl is a command-line tool for making HTTP requests. It comes pre-installed on Mac and Linux. On Windows, PowerShell has it built-in too.

Mac / Linux

Open Terminal and run:

curl https://theaxolotlapi.netlify.app/

Windows (PowerShell)

Open PowerShell and run:

curl.exe https://theaxolotlapi.netlify.app/

Or using PowerShell's native command:

Invoke-WebRequest -Uri "https://theaxolotlapi.netlify.app/" | Select-Object -ExpandProperty Content

5. Using JavaScript (Node.js)

Install Node.js

Quick One-Liner

node -e "fetch('https://theaxolotlapi.netlify.app/').then(r=>r.json()).then(d=>console.log(JSON.stringify(d,null,2)))"

As a File (app.js)

const url = "https://theaxolotlapi.netlify.app/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

Save as app.js and run: node app.js

6. Using Python

Install Python

Install requests library

pip install requests

Quick One-Liner

python -c "import requests; print(requests.get('https://theaxolotlapi.netlify.app/').json())"

As a File (app.py)

import requests

url = "https://theaxolotlapi.netlify.app/"
headers = {}

response = requests.get(url, headers=headers, timeout=30)
response.raise_for_status()
data = response.json()
print(data)

Save as app.py and run: python app.py

7. When an API Key is Required

Many APIs require an API key to identify you. Here is how to use one:

1. Sign up on the API provider's website
2. Find the "API Keys" or "Developer" section in your dashboard
3. Copy your API key
4. Add it to your request header or URL

Example: curl with API key in header

curl -H "X-API-Key: YOUR_API_KEY" https://api.example.com/data

Example: curl with API key in URL

curl "https://api.example.com/data?api_key=YOUR_API_KEY"

For a deeper dive, read our Authentication Guide.

8. Next Steps