Save File from URL in Python

Use Aspose.HTML for Python via .NET network APIs when an application has a direct resource URL and needs to save the response body locally. The workflow applies to images, stylesheets, scripts, documents, and other downloadable files.

To save a file from a URL in Python, create an HTMLDocument, build a RequestMessage for the resource URL, and call context.network.send(). If the response is successful, write response.content.read_as_byte_array() to a local binary file.

Download a File from a URL in Python

The following example downloads message-handlers.png from an absolute URL and saves it in the output directory. An empty HTMLDocument supplies the document context and its network service; it is not the content being downloaded.

To download and save a file from a URL:

1. Create the output directory and an empty HTMLDocument.
2. Create a Url for the resource to download.
3. Pass the URL to RequestMessage and send it through document.context.network.
4. Check response.is_success before reading the response body.
5. Derive the local file name from url.pathname and write the returned byte array in binary mode.

# Download a file from a URL in Python

import os
import aspose.html as ah
import aspose.html.net as ahnet

# Prepare the output directory
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

# Define the file URL
url = ah.Url("https://docs.aspose.com/html/images/handlers/message-handlers.png")

# Download and save the file
with ah.HTMLDocument() as document:
    with ahnet.RequestMessage(url) as request:
        with document.context.network.send(request) as response:
            if response.is_success:
                file_path = os.path.join(output_dir, os.path.basename(url.pathname))
                with open(file_path, "wb") as file:
                    file.write(response.content.read_as_byte_array())

The example reads the entire response into memory before writing it. For a large file, account for memory consumption and use a streaming workflow appropriate to the application.

Choose the Correct URL Workflow

Goal	Recommended workflow
Download one file from a known URL	Send RequestMessage and save the response bytes as shown in this article.
Find file URLs in an HTML document	Navigate the DOM or use XPath or CSS selectors in HTML Navigation.
Save HTML together with CSS and images	Use Save HTML with Resources in Python.
Convert a web page to PDF, DOCX, XPS, or an image	Use the appropriate workflow in the HTML Converter.

Common File Download Issues

Issue	Cause and recommended action
No output file is created	response.is_success is false, so the save block is skipped. Inspect the response and handle unsuccessful requests explicitly.
The output file name is empty	A URL ending in / has no file name in its path. Provide an explicit local file name instead of relying on os.path.basename(url.pathname).
The saved file has unexpected content	The URL returned an error document or another media type. Validate the response status and content type before saving.
Memory usage is high	read_as_byte_array() loads the complete response body into memory. Use a suitable streaming approach for large files.
The request fails	The URL is unavailable, blocked, or unsupported by the active network configuration. Verify the URL, protocol, permissions, and network access.

FAQ

Why does the example create an empty HTMLDocument?

The document provides access to document.context.network, which sends the RequestMessage. The empty document itself is not saved or used as the downloaded content.

Can this example download files other than images?

Yes. The response body is read as bytes, so the same workflow can save other downloadable file types. Use an appropriate local extension and validate the response before writing it.

Does this example save an entire web page?

No. It downloads one resource from a known URL. To preserve HTML with its linked CSS and images, use the resource-saving workflow linked above.

Other Platforms

• Save File from URL in C# – download files with the Aspose.HTML for .NET network API.
• Save File from URL in Java – send a request and save a response body with Aspose.HTML for Java.

Related Articles

• Data Extraction in Python – choose a workflow for navigating HTML and extracting files or resources.
• HTML Navigation in Python – locate resource URLs with DOM navigation, XPath, or CSS selectors.
• Extract Images from Website in Python – find image URLs on a page and save their files locally.
• Extract SVG from Website in Python – extract inline SVG markup and download external SVG resources.