Using Requests for URLs
Learn to send GET and POST requests to retrieve web page content using the Python Requests library.
Using Requests for URLs is a free Web Scraping & Bots lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Web Scraping & Bots learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Meet Python's Requests Library
Welcome to using Python for web interactions! In this lesson, we'll dive into the Requests library, your go-to tool for making HTTP requests.
Requests simplifies how your Python program talks to websites, acting like a web browser but without a graphical interface. It's essential for fetching web page content before you can extract data.
Setting Up Requests
Before we can use Requests, we need to install it. If you haven't already, open your terminal or command prompt and run the following command:
pip install requests
This command downloads and installs the library, making it available for your Python scripts. It's a one-time setup for your environment.
Your First GET Request
The most common type of request is GET. It's used to retrieve data from a specified resource, much like when your browser loads a webpage.
Let's make a simple GET request to fetch content from example.com. We'll then print the HTTP status code and a snippet of the page's text.
import requests
# Define the URL you want to fetch
url = "http://www.example.com"
# Send a GET request
response = requests.get(url)
# Print the status code and first 200 characters of the content
print(f"Status Code: {response.status_code}")
print(f"Content snippet:\n{response.text[:200]}")Understanding the Response Object
When you make a request, the requests.get() function returns a Response object. This object holds all the information about the server's reply.
response.status_code: An integer indicating the HTTP status (e.g., 200 for OK, 404 for Not Found).response.text: The content of the response, usually HTML, as a string.response.url: The actual URL of the response.
Basic Error Checking
It's good practice to check if your request was successful. The response.raise_for_status() method is a simple way to do this.
If the HTTP status code indicates an error (e.g., 4xx or 5xx), this method will raise an HTTPError. Otherwise, it does nothing.
import requests
url = "http://www.example.com/nonexistent-page"
try:
response = requests.get(url)
response.raise_for_status() # Raises an HTTPError for bad responses (4xx or 5xx)
print("Request successful!")
except requests.exceptions.HTTPError as err:
print(f"HTTP Error occurred: {err}")
except requests.exceptions.ConnectionError as err:
print(f"Connection Error occurred: {err}")
except Exception as err:
print(f"An unexpected error occurred: {err}")Adding Request Headers
Sometimes, websites check for specific HTTP headers to determine if a request is coming from a legitimate browser or a bot.
You can customize your request by passing a dictionary of headers. A common header to set is User-Agent to mimic a browser.
import requests
url = "http://httpbin.org/get" # A service that echoes your request
headers = {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
"Accept-Language": "en-US,en;q=0.9"
}
response = requests.get(url, headers=headers)
print("Your request headers sent to httpbin.org:")
# httpbin.org returns JSON, so we can use .json()
print(response.json()['headers']['User-Agent'])
print(response.json()['headers']['Accept-Language'])Understanding POST Requests
While GET requests are for retrieving data, POST requests are used to send data to a server, typically for creating or updating a resource.
Think of submitting a form on a website – you're usually sending data via a POST request. The data is included in the request body, not in the URL.
Sending Data with POST
To send a POST request with data, you use requests.post() and pass your data as a dictionary to the data parameter.
Let's try sending some simple form data to httpbin.org/post, which will echo back the data it received.
import requests
url = "http://httpbin.org/post"
# Data to send in the POST request
payload = {
"name": "Coddy",
"city": "Kitland",
"age": "5"
}
response = requests.post(url, data=payload)
print("Data received by httpbin.org:")
# The 'form' key in the JSON response contains the sent data
print(response.json()['form'])GET vs. POST: Key Differences
It's crucial to understand when to use GET versus POST:
- GET: Retrieves data, parameters are visible in the URL, requests can be bookmarked and cached. Best for non-sensitive data retrieval.
- POST: Sends data to be processed, parameters are in the request body (not visible in URL), requests are not cached or bookmarked. Best for submitting forms, uploading files, or sensitive data.
Check Your Understanding
You've learned about GET and POST requests. Consider the following scenario:
You want to retrieve the current weather forecast for a specific city from a public API. Which HTTP request method is most appropriate?
Lesson Summary
Great job! You've taken a significant step in understanding how to interact with the web using Python's Requests library.
- We installed the
requestslibrary. - We learned to send GET requests to fetch web content.
- We explored the response object, checking status codes and content.
- We briefly touched on handling request errors.
- We customized requests with headers.
- We learned to send data using POST requests.
- Finally, we distinguished between GET and POST for different web interactions.
Next, we'll learn how to parse the HTML content you've fetched!
Frequently asked questions
Is the “Using Requests for URLs” lesson free?
Yes — the full text of “Using Requests for URLs” is free to read here on the web, and the Web Scraping & Bots course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Web Scraping & Bots course, upgrade to CoddyKit PRO.
What will I learn in “Using Requests for URLs”?
Learn to send GET and POST requests to retrieve web page content using the Python Requests library. You practise Web Scraping & Bots with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Web Scraping & Bots?
No prior experience is required. Web Scraping & Bots on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Using Requests for URLs” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Web Scraping & Bots lesson?
Yes. Every Web Scraping & Bots lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.