IconArchive Scraper

Scrape IconArchive.com — one of the web's largest free icon directories, covering 700,000+ icons across thousands of free and commercial icon packs. Search by keyword, browse any of the 48 fixed categories or a tag, pull every icon inside a named pack, fetch full metadata for a single icon (license, tags, designer, download URLs at every size), list every pack by a specific designer, or discover valid tags and designers by browsing the site's own directories. HTTP-only, no login, no proxy required.

What this actor does

• 9 modes covering every reliable browse/search axis IconArchive exposes:
  • search — free-text keyword search across all icons
  • category — browse one of the 48 fixed categories (returns icon packs)
  • tag — browse icons by an exact tag (e.g. cat, arrow, folder)
  • pack — every icon inside one named icon pack, with pack-level metadata merged in
  • icon — full metadata for a single icon page (designer, license, tags, all sizes)
  • artist — every icon pack published by one designer, with designer stats merged in
  • curated — the site's curated pack listings: newest, popular, random, SVG, commercial-free, high-resolution, largest, staff picks, and pixelart
  • tags — the full tag directory by starting letter, with each tag's exact icon count (use this to discover valid values for mode=tag)
  • designers — the full designer directory, optionally filtered by starting letter, with each designer's exact pack count (use this to discover valid values for mode=artist)
• Download URLs at every standard size — 16, 24, 32, 48, 64, 72, 96, 128, and 256px, built from the site's own CDN so every link resolves directly to a PNG
• Windows .ico and macOS .icns download URLs — every icon's converted-format downloads, alongside the PNGs
• Designer and license metadata — commercial-usage flag, license text, designer profile links, wherever the source page exposes them
• Automatic pagination up to your maxItems cap
• Omit-empty output — a field only appears on a record if real data was found for it

Output fields

Icon records (recordType: "icon" — from search, tag, pack, icon modes)

Field	Description
iconId	Numeric IconArchive icon ID
name	Icon title
packSlug / packName	Parent icon pack slug / display name
packUrl	Icon pack page URL
designerSlug / designerName	Designer slug / display name (name only available on pack/icon modes)
designerUrl	Designer profile page URL
packIconCount	Number of icons in the parent pack (mode=icon/pack)
license	License text as published on the icon/pack page
commercialUseAllowed	true/false — whether commercial use is allowed (mode=icon only)
categories	Pack's category names (mode=pack only)
tags	Tag list (mode=icon only)
imageUrl16 … imageUrl256	Direct PNG download URLs at 16/24/32/48/64/72/96/128/256px
icoUrl	Windows .ico download URL
icnsUrl	macOS .icns download URL
listingTotalCount	Total icons IconArchive reports for this query/tag, as shown on page 1 (mode=search/tag only)
sourceUrl	Canonical icon page URL
scrapedAt	UTC ISO timestamp
recordType	Always "icon"

Icon pack records (recordType: "iconPack" — from category, artist, curated modes)

Field	Description
packSlug / packName	Icon pack slug / display name
sourceUrl	Icon pack page URL
designerSlug / designerUrl	Designer slug / profile URL (derived from the pack's own URL)
designerName / designerWebsite	Designer display name / external website (mode=artist only)
designerTotalPacks / designerTotalIcons	Designer's total published pack / icon counts across all of IconArchive (mode=artist only)
iconCount	Number of icons in the pack
previewImageUrl	Preview strip image for the pack
maxResolution	Highest available resolution badge (e.g. 1024px), where shown
category	Requested category slug (mode=category only)
listingTotalCount	Total icon packs IconArchive reports for this browse axis, as shown on page 1 (mode=category/curated only)
scrapedAt	UTC ISO timestamp
recordType	Always "iconPack"

Tag directory records (recordType: "tag" — from tags mode)

Field	Description
tagSlug	Tag URL slug, e.g. cat — feed this into tag on mode=tag
tagName	Human-readable tag name
iconCount	Exact number of icons tagged with this tag, as published by IconArchive
sourceUrl	Tag browse page URL
scrapedAt	UTC ISO timestamp
recordType	Always "tag"

Designer directory records (recordType: "designer" — from designers mode)

Field	Description
designerSlug	Designer URL slug, e.g. fasticon — feed this into artistSlug on mode=artist
designerName	Designer display name
designerUrl	Designer profile page URL
totalPacks	Exact number of icon packs published by this designer, as published by IconArchive
scrapedAt	UTC ISO timestamp
recordType	Always "designer"

Input

Field	Type	Default	Description
mode	select	search	search / category / tag / pack / icon / artist / curated / tags / designers
query	string	cat	Keyword (mode=search)
categorySlug	select	animals-icons	One of 48 fixed categories (mode=category)
tag	string	cat	Exact tag (mode=tag)
packSlug	string	–	Icon pack slug, e.g. cat-icons-by-fasticon (mode=pack)
iconUrl	string	–	Full single-icon page URL (mode=icon)
artistSlug	string	–	Designer slug, e.g. fasticon (mode=artist)
listingType	select	newest	newest / popular / random / svg / commercialFree / highRes / largest / staffPicks / pixelart (mode=curated)
tagLetter	select	a	Starting letter a–z of the tag directory to browse (mode=tags)
artistLetter	select	all	Starting letter filter for the designer directory: all / 0-9 / a–z (mode=designers)
minIconCount	int	–	Drop records with fewer icons than this: icon packs (mode=category/artist/curated) or tags (mode=tags)
maxItems	int	20	Hard cap on emitted records (1–2000)

Example: search for icons by keyword

{ "mode": "search", "query": "cat", "maxItems": 50 }

Example: browse a category, only large packs

{ "mode": "category", "categorySlug": "food-icons", "minIconCount": 30, "maxItems": 100 }

Example: every icon inside one pack

{ "mode": "pack", "packSlug": "cat-icons-by-fasticon", "maxItems": 50 }

Example: full metadata for a single icon

{ "mode": "icon", "iconUrl": "https://www.iconarchive.com/show/cat-icons-by-fasticon/Cat-Orange-icon.html" }

Example: all packs by one designer

{ "mode": "artist", "artistSlug": "fasticon", "maxItems": 50 }

Example: newest icon packs

{ "mode": "curated", "listingType": "newest", "maxItems": 30 }

Example: discover tags starting with a letter, only popular ones

{ "mode": "tags", "tagLetter": "c", "minIconCount": 500, "maxItems": 100 }

Example: discover designers whose name starts with "F"

{ "mode": "designers", "artistLetter": "f", "maxItems": 100 }

Use cases

• App / web design — bulk-discover icon packs in a matching category and license
• Design-system audits — pull every icon in a pack with license and commercial-use terms
• Asset cataloging — build a searchable local index of icon metadata and download links
• Designer research — track a designer's full catalog and pack count over time
• Content curation — surface newest, most popular, or staff-picked icon packs

FAQ

Do I need to log in or provide an API key? No — the actor scrapes IconArchive's public pages directly; no account, cookies, or proxy are required.

What license do the icons have? Each icon page publishes its own license text and a commercial-use flag as set by the pack's designer — always check the license and commercialUseAllowed fields (mode=icon/pack) before using an icon commercially.

Why do some icon records have a designerName and others only a designerSlug? Search, tag, and category listing pages only expose the designer's URL slug; the full display name is only shown on the pack detail (pack), single-icon (icon), and designer (artist) pages. When you need the designer's display name, use one of those three modes.

What image sizes are available? Every icon is available at 16, 24, 32, 48, 64, 72, 96, 128, and 256 pixels square — all nine are included as direct PNG URLs on every icon record.

Can I filter icon packs by size? Yes — set minIconCount on category, artist, or curated mode to drop packs with fewer icons than your threshold.

How many categories are there? 48 fixed categories, from Adobe to Vintage — see the categorySlug dropdown for the full list.

How do I find a valid tag or designer slug without guessing? Use mode=tags (browse every tag starting with a chosen letter, with its exact icon count) or mode=designers (browse every designer, optionally filtered by starting letter, with their exact pack count) to discover slugs before feeding them into mode=tag or mode=artist.

Is this affiliated with IconArchive? No, this is a third-party actor that scrapes IconArchive's public pages. It is not affiliated with, endorsed by, or sponsored by IconArchive.com.