GET 요청 한 번으로 URL만 넣으면 모든 웹사이트의 파비콘을 가져옵니다. API 키도, 가입도 필요 없습니다.
favicondl 파비콘 API는 GET 요청 한 번으로 어떤 도메인이나 URL이든 그 사이트의 파비콘으로 바꿔 줍니다. API 키, 계정, SDK가 모두 필요 없습니다. size(16, 32, 48, 64, 128, 180, 192, 256, 512 중 하나. 다른 숫자는 가장 가까운 값, 거리가 같으면 더 작은 값)를 넘기면 그 한 변의 정사각형 PNG가 옵니다.
<img src="https://favicondl.com/api/extract?url=github.com&size=32" width="32" height="32" alt="GitHub 파비콘">
size를 생략하면 원본 파일입니다. 더 작은 래스터는 확대되어 흐려 보일 수 있습니다. SVG는 요청한 크기로 래스터화합니다. 이미지 응답의 X-Favicon-Native-Size와 X-Favicon-Upscaled가 확대 여부를 알려 줍니다.
JSON을 요청하면 어떤 파일을 찾았고 어디서 가져왔는지 확인할 수 있습니다.
curl "https://favicondl.com/api/extract?url=github.com&format=json"
curl "https://favicondl.com/api/extract?url=github.com&size=32&format=json"
{
"ok": true,
"domain": "github.com",
"size": null,
"resized": false,
"upscaled": false,
"vector": true,
"nativeWidth": null,
"nativeHeight": null,
"iconUrl": "https://github.githubassets.com/favicons/favicon.svg",
"proxyUrl": "https://favicondl.com/api/proxy?url=https%3A%2F%2Fgithub.githubassets.com%2Ffavicons%2Ffavicon.svg",
"source": "html",
"rel": "icon",
"format": "svg",
"width": null,
"height": null,
"pageUrl": "https://github.com/",
"candidates": [
{ "url": "https://github.githubassets.com/favicons/favicon.svg", "format": "svg", "vector": true, "source": "html", "rel": "icon", "proxyUrl": "…" },
{ "url": "https://github.githubassets.com/assets/app-icon-512-7f9c4ff2e960.png", "format": "png", "width": 512, "height": 512, "source": "manifest", "rel": "manifest", "proxyUrl": "…" },
{ "url": "https://github.com/favicon.ico", "format": "ico", "width": 32, "height": 32, "source": "direct", "rel": "favicon.ico", "proxyUrl": "…" }
]
}
iconUrl은 웹사이트의 원본 파일입니다. 받는 이미지는 proxyUrl입니다. size를 생략하면 원본이고, size를 주면(예: &size=32) 정확히 그 크기의 정사각형 PNG입니다. Access-Control-Allow-Origin: *가 붙습니다.
width와 height는 측정한 원본입니다(SVG는 null). size가 있으면 outputWidth와 outputHeight가 그 값과 같고, nativeWidth / nativeHeight는 원본 픽셀이며, 래스터를 키운 경우에만 upscaled가 true입니다. 그때 PNG는 흐려 보일 수 있습니다. candidates는 검증된 다른 아이콘을 최대 8개 담습니다. Google이나 DuckDuckGo로 대체되면 비어 있습니다.
www ↔ 기본 도메인 포함)을 따라갑니다. 아이콘 관련 <link>를 모두 읽습니다: icon, shortcut icon, apple-touch-icon, apple-touch-icon-precomposed, mask-icon. 상대 경로와 프로토콜 상대 경로(//cdn…)는 최종 페이지 URL이나 <base> 태그를 기준으로 해석합니다(source: "html").source: "manifest")./favicon.ico와 /apple-touch-icon.png도 시도합니다(source: "direct").size로 사용합니다(source: "google_s2" 또는 "duckduckgo").검증된 후보는 가장 선명한 파일이 선택되도록 순위를 매깁니다. 풀컬러 SVG가 먼저이고, 그다음이 가장 큰 정사각형 PNG/ICO/WebP입니다. Safari의 단색 mask-icon과 maskable로만 표시된 매니페스트 아이콘은 일반 파비콘과 모양이 달라 낮은 순위를 줍니다. 고른 원본은 16, 32, 48, 64, 128, 180, 192, 256, 512 중 하나로 맞춥니다(다른 숫자는 가장 가까운 값). size를 생략하면 원본 파일입니다. 축소는 Lanczos, 확대는 고품질 리샘플링이고, 정사각형이 아니면 투명하게 채우며, SVG는 요청 크기로 래스터화합니다. 확대한 래스터는 흐려 보일 수 있으며, 응답은 그것을 선명한 원본이라고 하지 않습니다.
google_s2가 나왔다면 그 사이트에 저희가 접근할 수 있는 아이콘이 없거나 요청이 차단된 것입니다(예: 봇 확인 페이지). 사이트 하나만 확인한다면 홈페이지의 파비콘 다운로더가 브라우저에서 직접 몇 가지 출처를 더 시도하고, 찾은 모든 크기를 보여 주므로 그중에서 고를 수 있습니다.
네 서비스 모두 무료로 시작할 수 있고 API 키가 필요 없습니다. 차이는 돌려주는 결과에 있습니다.
| favicondl | Google S2 | DuckDuckGo | Icon Horse | |
|---|---|---|---|---|
| 엔드포인트 | /api/extract?url=example.com | google.com/s2/favicons?domain=example.com&sz=64 | icons.duckduckgo.com/ip3/example.com.ico | icon.horse/icon/example.com |
| API 키 | 불필요 | 불필요 | 불필요 | 불필요(무료 요금제) |
| 공개된 무료 한도 | 없음(공정 사용) | 공개 안 됨 | 공개 안 됨 | 무료 요금제 월 1,000개 아이콘 |
| 크기 매개변수 | size는 16, 32, 48, 64, 128, 180, 192, 256, 512. 다른 숫자는 가장 가까운 값. 생략하면 원본 파일. | sz | 없음 | 문서에 없음 |
| 반환 결과 | size가 있으면 정확히 그 크기의 정사각형 PNG, 없으면 원본 파일(SVG, PNG, ICO 등) | PNG 또는 JPEG(실측) | ICO(실측) | PNG(실측) |
| JSON 메타데이터 | 있음(format=json: 아이콘 URL, 출처, 형식, 실측 픽셀 크기, 최대 8개의 대체 아이콘) | 없음 | 없음 | 없음 |
| github.com 테스트 결과 | favicon.svg(벡터) | sz=16일 때 16×16 PNG, sz=256일 때 180×180 | 16×16과 32×32가 든 ICO | 256×256 PNG |
결과는 2026년 10월 12일 저희가 직접 보낸 요청을 기준으로 합니다. Icon Horse 한도는 요금 안내에서 가져왔습니다. 외부 서비스는 언제든 바뀔 수 있으니, 실서비스에 쓰기 전에 각 제공업체의 약관을 확인하세요.
Mzu favicondl은 복사해서 쓸 수 있는 파비콘 URL 템플릿과 파비콘 추출 UI를 제공합니다. 자체 추출 API가 웹사이트가 실제로 게시한 아이콘을 찾아내고, 이미지 프록시를 통해 브라우저 코드에서도 내려받을 수 있습니다.
빠른 미리보기를 위한 최적화
가입 불필요
고가용성 설계
이 프로젝트는 무료 파비콘 서비스 URL 템플릿을 사용하며, 인증이나 API 키가 필요하지 않습니다.
참고: API 키는 필요하지 않지만, 과도한 요청을 피하기 위해 합리적으로 사용해 주세요.
FaviconDL Extract API
도메인이나 URL에서 쓸 수 있는 파비콘을 찾아 다운로드
https://favicondl.com/api/extract
https://favicondl.com/api/extract?url=example.com&size=128
| 파라미터 이름 | 유형 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
url |
string | 예 | - | 대상 도메인 또는 URL (예: example.com) |
size |
number | 아니오 | 없음 (원본 파일) | 허용 크기는 16, 32, 48, 64, 128, 180, 192, 256, 512뿐입니다. 다른 숫자는 가장 가까운 허용 크기로 맞추고(거리가 같으면 더 작은 값), 그 주소로 리다이렉트합니다. size를 생략하면 원본 파일입니다. 숫자가 아니면 400입니다. 더 작은 래스터는 확대되어 흐려 보일 수 있고, SVG는 맞춘 크기로 래스터화합니다. |
format |
string | 아니오 | redirect | 메타데이터가 필요하면 json을 지정하고, 생략하면 다운로드 가능한 이미지로 리디렉션합니다 |
도메인과 전체 웹사이트 URL을 모두 지원합니다:
아래 크기 중 하나의 정사각형 PNG. 다른 숫자는 가장 가까운 값으로 맞춥니다. 생략하면 원본 파일입니다.
16 - 16x1632 - 32x3248 - 48x4864 - 64x64128 - 128x128180 - 180x180192 - 192x192256 - 256x256512 - 512x512읽는 값은 url(domain은 별칭으로 허용), size, format뿐입니다. 다른 쿼리 매개변수는 무시됩니다. 호스트는 소문자로, 스킴은 https로 맞추고, 앞의 www. 하나와 끝의 슬래시를 뺍니다. 이미 그 형태가 아닌 요청은 308로 안정된 주소에 리다이렉트되며, CDN은 그 주소를 캐시합니다. /api/proxy는 파일을 가리키므로 www와 이미지 경로를 유지합니다.
{
"ok": true,
"domain": "example.com",
"size": 32,
"resized": true,
"outputFormat": "png",
"outputWidth": 32,
"outputHeight": 32,
"upscaled": false,
"nativeWidth": null,
"nativeHeight": null,
"vector": true,
"iconUrl": "https://example.com/favicon.svg",
"proxyUrl": "https://favicondl.com/api/proxy?url=...&size=32",
"source": "html",
"rel": "icon",
"format": "svg",
"width": null,
"height": null,
"pageUrl": "https://example.com/",
"candidates": [ ... ]
}
{
"ok": false,
"error": "Missing url"
}
참고: format=redirect 사용 시 API는 JSON 응답을 반환하지 않고 파비콘 URL로 직접 리다이렉트합니다.
async function getFavicon(url, size = 128) {
const endpoint = new URL('https://favicondl.com/api/extract');
endpoint.searchParams.set('url', url);
endpoint.searchParams.set('size', String(size));
const response = await fetch(endpoint);
if (!response.ok) throw new Error(`Favicon request failed: ${response.status}`);
return await response.blob();
}
const icon = await getFavicon('example.com', 128);
const imageUrl = URL.createObjectURL(icon);
document.querySelector('#favicon-preview').src = imageUrl;
import requests
def get_favicon(url: str, size: int = 128) -> bytes:
response = requests.get(
"https://favicondl.com/api/extract",
params={"url": url, "size": size},
timeout=15,
)
response.raise_for_status()
return response.content
icon_bytes = get_favicon("example.com", 128)
with open("example-favicon", "wb") as output:
output.write(icon_bytes)
<?php
function getFavicon(string $url, int $size = 128): string {
$endpoint = 'https://favicondl.com/api/extract?url=' . urlencode($url) . '&size=' . $size;
$context = stream_context_create(['http' => ['follow_location' => 1, 'timeout' => 15]]);
$icon = file_get_contents($endpoint, false, $context);
if ($icon === false) {
throw new RuntimeException('Favicon request failed');
}
return $icon;
}
file_put_contents('example-favicon', getFavicon('example.com', 128));
?>
<!-- Exact 32×32 PNG. Allowed: 16, 32, 48, 64, 128, 180, 192, 256, 512. Other numbers snap to the nearest. -->
<img src="https://favicondl.com/api/extract?url=example.com&size=32" alt="example.com favicon" width="32" height="32">
<!-- Omit size for the original file. Small rasters requested above native size may look soft. -->
<img src="https://favicondl.com/api/extract?url=example.com" alt="example.com favicon">
오류 시 HTTP 상태 코드와 ok가 false이고 오류 메시지가 담긴 짧은 JSON을 반환합니다.
| HTTP 상태 코드 | 오류 메시지 | 설명 | 해결 방법 |
|---|---|---|---|
| 400 | Missing url |
url 또는 domain 매개변수가 전송되지 않았습니다 | 요청에 ?url=example.com을 추가하세요 |
| 400 | Invalid format |
format이 json도 redirect도 아닙니다 | format=json을 사용하거나 생략하여 리디렉션을 받으세요 |
| 400 | Invalid domain |
값을 호스트 이름으로 해석할 수 없습니다 | example.com 같은 도메인이나 전체 https:// URL을 보내세요 |
| 405 | Method not allowed |
GET 요청만 지원됩니다 | GET 요청을 보내세요 |
| 502 | Favicon extraction failed |
추출기가 아이콘을 반환하지 못했습니다 | 나중에 다시 시도하세요 |
| 415 | Target is not an image |
/api/proxy 전용: 해당 URL이 실제 이미지 데이터를 반환하지 않았습니다 | /api/extract가 반환한 iconUrl 또는 candidates[].url을 사용하세요 |
io.github.sweesama/favicondl) exposes an extract_favicon tool so Claude, Cursor and other MCP clients can fetch icons.가입 불필요, 모든 기능을 완전 무료로 사용 가능
유료 요금제나 SLA는 없습니다. 대량 사용이나 중요한 업무 용도라면 필요한 아이콘을 자체 저장소에 보관하세요.