Extract Images From Website using Aspose.HTML

Suppose you are a web developer, graphic designer, researcher, journalist, or student, in a word, a person working on his own project. In that case, you will obviously need images for your project in the development process. To download images from website manually, you spend a very long time. You will have to copy each image URL and then save the image, but you can use Aspose.HTML for .NET library to extract images from website programmatically.

In this article we demonstrate how to extract both standard images (<img> tags) and website icons (<link rel="icon">) using the Aspose.HTML for .NET API. Automating the download process is far more efficient than hunting for files manually. Let’s get started!

Extract Images from Website – C# Example

Most pictures in an HTML document are represented using the <img> element. Here is an example of how to use Aspose.HTML for .NET to find images specified by this element. So, to download images from website, you should take a few following steps:

1. Use the HTMLDocument(Url) constructor to create an instance of the HTMLDocument class and pass it the URL of the website from which you want to find images.
2. Use the GetElementsByTagName(“img”) method to collect all <img> elements. The method returns a list of the HTML document’s <img> elements.
3. Use the Select() method to create a distinct collection of relative image URLs and the GetAttribute(“src”) method to extract the src attribute of each <img> element.
4. Create absolute image URLs using the Url class and the BaseURI property of the HTMLDocument class.
5. For each absolute URL, create a request using the RequestMessage(url) constructor.
6. Use the document’s Context.Network.Send(request) method to send the request. The response is checked to ensure it was successful.
7. Finally, if the response was successful, use the File.WriteAllBytes() method to save each image to a local file.

// Extract images from website using C#

// Open a document you want to download images from
using HTMLDocument document = new HTMLDocument("https://docs.aspose.com/svg/net/drawing-basics/svg-shapes/");

// Collect all <img> elements
HTMLCollection images = document.GetElementsByTagName("img");

// Create a distinct collection of relative image URLs
IEnumerable<string> urls = images.Select(element => element.GetAttribute("src")).Distinct();

// Create absolute image URLs
IEnumerable<Url> absUrls = urls.Select(src => new Url(src, document.BaseURI));

foreach (Url url in absUrls)
{
    // Create an image request message
    using RequestMessage request = new RequestMessage(url);

    // Extract image
    using ResponseMessage response = document.Context.Network.Send(request);

    // Check whether a response is successful
    if (response.IsSuccess)
    {
        // Save image to a local file system
        File.WriteAllBytes(Path.Combine(OutputDir, url.Pathname.Split('/').Last()), response.Content.ReadAsByteArray());
    }
}

Note: It is important to adhere to copyright laws and obtain proper permission or licensing before using saved images for commercial purposes. We do not support data extraction and use of other people’s files for commercial purposes without their permission.

Extract Icons – C# Example

Icons are a kind of image in HTML documents that are specified using <link> elements with the rel attribute set to icon. Let’s look at how to extract icons from website using the Aspose.HTML for .NET library:

1. Use the HTMLDocument(Url) constructor to create an instance of the HTMLDocument class and pass it the URL of the website from which you want to extract icons.
2. Use the GetElementsByTagName(“link”) method to collect all <link> elements.
3. To filter out non-icon images, use the Where() method that filters the collection based on the link => link.GetAttribute("rel") == "icon" expression. Thus, the icons collection will contain only links with a rel attribute with the value icon.
4. Use the Select() method to create a distinct collection of relative icon URLs and the GetAttribute(“href”) method to extract the href attribute of each <link> element.
5. Create absolute icon URLs using the Url class and the BaseURI property of the HTMLDocument class.
6. Then, for each absolute URL, create a request using the RequestMessage class.
7. Use the document’s Context.Network.Send(request) method to send the request. The response is checked to ensure it was successful.
8. If the response was successful, use the File.WriteAllBytes() method to save icons to a local file. As a result, you will have a collection of icons from website in your local folder.

// Download icons from website using C#

// Open a document you want to download icons from
using HTMLDocument document = new HTMLDocument("https://docs.aspose.com/html/net/message-handlers/");

// Collect all <link> elements
HTMLCollection links = document.GetElementsByTagName("link");

// Leave only "icon" elements
IEnumerable<Element> icons = links.Where(link => link.GetAttribute("rel") == "icon");

// Create a distinct collection of relative icon URLs
IEnumerable<string> urls = icons.Select(icon => icon.GetAttribute("href")).Distinct();

// Create absolute icon URLs
IEnumerable<Url> absUrls = urls.Select(src => new Url(src, document.BaseURI));

foreach (Url url in absUrls)
{
    // Create a downloading request
    using RequestMessage request = new RequestMessage(url);

    // Extract icon
    using ResponseMessage response = document.Context.Network.Send(request);

    // Check whether a response is successful
    if (response.IsSuccess)
    {
        // Save icon to a local file system
        File.WriteAllBytes(Path.Combine(OutputDir, url.Pathname.Split('/').Last()), response.Content.ReadAsByteArray());
    }
}

You can use these C# examples to automate extracting all images from website, which can be helpful for tasks such as archiving, researching, analyzing web content, or any other application for personal use. Also, this is great for web designers and developers wanting to pull images from sites without diving into the source code.

Common Mistakes and Fixes

Problem	Cause	Solution
Images are not downloaded	src attribute contains a data URI or empty string	Skip data URIs (src.StartsWith("data:")) and filter out empty values before downloading
Relative URLs resolve incorrectly	BaseURI is missing or the page uses <base> tag	Use document.BaseURI or read the <base> element and combine it with the relative path
HTTP errors (404/403) stop the script	No error handling around Network.Send	Check response.IsSuccess and continue the loop on failure
Files are overwritten	Duplicate file names from different URLs	Generate unique names (e.g., include a counter or hash of the URL)
Icons are missed	rel can contain multiple values like "shortcut icon", so == "icon" fails.	Split rel by spaces and check if it contains "icon". Also match "shortcut" or "apple-touch-icon" if needed.

Conclusion

Aspose.HTML for .NET makes extracting images and icons from any web page straightforward and reliable. By leveraging the DOM API and built‑in networking features, you can automate bulk downloads, archive web content, or gather assets for research without manual effort. The provided examples cover both standard images and favicon extraction, complete with error handling and best‑practice tips.

Related Resources

• HTML Navigation using C#
• Extract SVG From Website
• Save File from URL Using C#
• Save Website Using C#
• Edit HTML Document

You can download the complete C# examples and data files from GitHub.