Favicon API & URL Guide

복사하여 사용할 수 있는 파비콘 URL 템플릿 (무료 서비스 기반).

개요

Mzu favicondl은 복사 가능한 파비콘 URL 템플릿과 파비콘 추출 UI를 제공합니다. 기본적으로 Cloudflare Worker를 사용하여 실제 아이콘을 찾고 다운로드를 위해 이미지를 프록시합니다.

빠른

빠른 미리보기를 위한 최적화

무료

가입 불필요

안정적

고가용성 설계

인증

이 프로젝트는 무료 파비콘 서비스 URL 템플릿을 사용하며, 인증이나 API 키가 필요하지 않습니다.

참고: API 키는 필요하지 않지만, 과도한 요청을 피하기 위해 합리적으로 사용해 주세요.

엔드포인트

GET FaviconDL Extract API

Find and download a usable favicon for a domain or URL

기본 URL:

https://favicondl.com/api/extract

전체 예시:

https://favicondl.com/api/extract?url=example.com&size=128

파라미터

파라미터 이름 유형 필수 기본값 설명
url string 예 - The target domain or URL, e.g. example.com
size number 아니오 128 The preferred icon size in pixels, clamped to 16-512
format string 아니오 redirect Use json for metadata; omit it for a downloadable image redirect

파라미터 상세:

url

Supports domains and full website URLs:

  • • example.com
  • • www.example.com
  • • https://example.com/docs
  • • sub.example.com
size

Preferred icon size, from 16 to 512 pixels:

  • • 16 - 16x16
  • • 32 - 32x32
  • • 128 - 128x128
  • • 512 - 512x512 when supported

응답

성공 응답 (JSON 형식)

JSON 응답 
{
  "ok": true,
  "domain": "example.com",
  "size": 128,
  "iconUrl": "https://example.com/favicon.svg",
  "proxyUrl": "https://favicondl.com/api/proxy?url=...",
  "source": "html"
}

오류 응답

오류 응답 
{
  "success": false,
  "error": "Domain not found",
  "message": "Unable to find favicon for the specified domain",
  "code": 404,
  "timestamp": "2026-01-15T10:30:00Z"
}

참고: format=redirect 사용 시 API는 JSON 응답을 반환하지 않고 파비콘 URL로 직접 리다이렉트합니다.

사용 예시

JavaScript (Fetch)

JavaScript 
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;

Python (Requests)

Python 
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 (cURL)

PHP

HTML 직접 참조

HTML 
<!-- 在HTML中直接引用favicon -->
<img src="https://favicondl.com/api/extract?url=example.com&size=32" alt="example.com favicon" width="32" height="32">

<!-- 使用大尺寸图标 -->
<img src="https://favicondl.com/api/extract?url=example.com&size=128" alt="example.com favicon" width="128" height="128">

<!-- 作为网站favicon -->
<link rel="icon" type="image/png" href="https://favicondl.com/api/extract?url=example.com&size=32">

오류

오류 발생 시 API는 해당 HTTP 상태 코드와 오류 메시지를 반환합니다.

HTTP 상태 코드 오류 코드 설명 해결 방법
400 invalid_domain 잘못된 도메인 형식 도메인 형식을 확인하고, 유효한 도메인인지 확인하세요
404 domain_not_found 도메인을 찾을 수 없음 도메인이 올바르고 웹사이트에 접근 가능한지 확인하세요
404 favicon_not_found 파비콘을 찾을 수 없음 웹사이트가 파비콘을 설정하지 않았을 수 있습니다
429 rate_limit_exceeded 요청 제한 초과 요청 빈도를 줄이고 나중에 다시 시도하세요
500 internal_error 내부 서버 오류 서비스가 일시적으로 이용할 수 없습니다. 나중에 다시 시도하세요

요청 제한

무료

가입 불필요, 모든 기능을 완전 무료로 사용 가능

요청 제한

  • • 분당 최대 100회 요청
  • • 시간당 최대 1000회 요청
  • • 일당 최대 10000회 요청

상업적 사용

상업적 사용자는 더 높은 사용량 할당과 우선 지원을 위해 문의해 주세요

복사되었습니다!