Use APIs in Python and JavaScript—From Request to Result

Introduction to APIs

An API, or application programming interface, lets software share data and actions. One app sends a request. Another app checks it and sends back a response. This link helps teams add features without rebuilding every service.

A weather app can ask a weather service for a forecast. A payment site can send a payment request to a gateway. APIs also support maps, news, account sign-in, and many other tools.

If you wonder how to use an API, start with the service docs. They explain what the API can do and what your request must contain. The same core steps work across most services.

• Find the endpoint for the task you need.
• Send the right method and any required data.
• Check the reply before using its data.

How APIs work

An endpoint is the web address for a resource or task. A request tells the service what you want to do. It can include a method, headers, and data.

The service sends a response with a status code and often JSON. JSON is a common format that stores data as named fields. Your code can read those fields and use them in another task.

HTTP methods tell a service which action you want. GET reads data, while POST sends new data. PUT updates data, and DELETE removes it. Each service may set its own rules.

• Endpoint: The address for a resource or action.
• Request: The method, address, headers, and optional data you send.
• Response: The status and data the service returns.

Read the endpoint docs before making a call. They show which fields are needed and how to read the reply. This is the first step when asking, “How do you use an API?”

Steps to use an API

Choose a service that offers the data or action you need. Then read its docs and find the endpoint, method, required fields, and access rules. Check its rate limit, which caps calls over a set time.

Some services need an account or an API key. A key identifies your app to the service. Use a test key or sandbox first, if the service offers one.

Make one small test call before adding the API to a live app. Check the status and inspect the returned fields. This can reveal wrong settings or missing data early.

1. Pick a service: Check that it offers the data or action you need.
2. Read the docs: Note the endpoint, method, fields, and access rules.
3. Get access: Create a key if needed and store it safely.
4. Test one call: Send a small request and inspect the reply.
5. Add safeguards: Plan for errors, limits, and missing fields.

For stock prices, find a quote endpoint and the required stock symbol. For news, find a search endpoint and pass a query. The provider sets the exact URL and reply fields.

Make API requests in Python

The Python requests library makes web calls simple. Install it with pip install requests, then import it in your script. The sample URL below is made up. Replace it with your provider’s endpoint.

import requests

response = requests.get("https://api.example.com/v1/quote", params={"symbol": "ABC"}, timeout=10)

response.raise_for_status()

data = response.json()

print(data)

The params setting adds fields to the request URL. To fetch news, use the provider’s news endpoint and pass a search term. For example, set params={"q": "clean energy"} if the docs name the search field q.

This is how to use an API in Python: send a request, check its status, then read the data. The same pattern works when you use an API with Python for quotes or news. See the requests library documentation for more call options.

Use POST to send a record or submit a task. Add JSON data as the docs require, and set a timeout. A timeout stops your script from waiting forever.

Use APIs in JavaScript

Web apps can call an API with JavaScript’s fetch function. The call returns a promise, so use await inside an async function. Check the response status before reading its JSON data.

async function getNews() { const response = await fetch("https://api.example.com/v1/news?q=energy"); if (!response.ok) throw new Error(`Request failed: ${response.status}`); const data = await response.json(); return data; }

This shows how to use an API in JavaScript to fetch data for a web page. For a POST call, set the method, headers, and JSON body in fetch options. Follow the API docs for the right field names.

When learning how to use an API with JavaScript, check where the code runs. A browser may block a call if the service does not allow requests from your site. The service owner must enable the right cross-origin access.

For fetch details and response handling, see MDN’s guide to using Fetch. It covers common browser behavior and ways to read a response.

Understand and protect API keys

An API key is a secret token that helps a service identify your app. Some providers use it to set access rules or track call limits. The docs show whether you should send it in a header or as a query field.

When you learn how to use an API key, keep it out of public code. Do not place a private key in a web page or a public code store. For a browser app, send requests through your own server when the key must stay secret.

In Python, load the key from an environment variable instead of writing it into the script. This is how to use an API key in Python without saving it in source code.

import os

api_key = os.environ["WEATHER_API_KEY"]

headers = {"Authorization": f"Bearer {api_key}"}

response = requests.get(url, headers=headers, timeout=10)

Use the header name and key format listed by your provider. Some services expect a named key field rather than a bearer token. Never share a live key in an example or support post.

Handle API errors and limits

A successful request can still return data your app cannot use. Check the status code before reading the result. A 400 code often means the request needs fixing, while 401 or 403 points to an access problem.

A 404 code means the endpoint or item was not found. A 429 code means you have sent too many calls. A 500-level code signals a problem on the service side.

Plan for errors in both Python and JavaScript. Show a useful message, keep a log, and avoid retrying a bad request without changes. For a short service outage, a brief pause before another attempt may help.

• Set a timeout so calls cannot wait forever.
• Check status codes and required fields.
• Respect rate limits and pause after a 429 reply.
• Do not log secret keys or private user data.

Good error checks make API work steadier. They also help you tell a bad request from a service fault. Start with one small call, then add the API to your app once its replies are clear.