Skip to main content

Favicon

developer
GET/v1/domain/favicon

Discovers all favicon and icon files for a domain including traditional favicons, Apple touch icons, and modern manifest icons in various sizes.

What It Does

Analyzes the HTML head section for link tags pointing to icons, checks common favicon locations (/favicon.ico, /apple-touch-icon.png), parses web app manifests for icon definitions, and validates that discovered icons are accessible.

Why It's Useful

Favicons are useful for brand identification, UI enhancement (displaying site icons in applications), and can sometimes reveal technology platforms through default icons.

Use Cases

Designer

Brand Asset Collection

Collect all icon variations for a brand to ensure consistency across platforms.

Audit and standardize favicon implementations across properties.

Frontend Developer

UI Enhancement

Dynamically display favicons next to links in a bookmark manager or aggregator app.

Improve UI with visual brand identification for external links.

Security Researcher

Technology Fingerprinting

Identify default CMS or platform favicons that reveal the underlying technology.

Discover technology platforms through favicon analysis.

Parameters

NameTypeRequiredDescription
domainstringRequiredThe domain to find favicons forExample: github.com

Response Fields

FieldTypeDescription
domainstringThe queried domain
iconsarrayAll discovered icons with URL, type, and size
primaryFaviconstringBest available favicon URL
countnumberTotal number of unique icons discovered
scorenumberFavicon health score (0-100)
gradestringLetter grade (A-F) based on score
recommendationsarraySuggestions to improve favicon coverage

Code Examples

cURL
curl "https://api.edgedns.dev/v1/domain/favicon" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=github.com"
JavaScript
const response = await fetch(
  'https://api.edgedns.dev/v1/domain/favicon?domain=github.com',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);
Python
import requests

response = requests.get(
    'https://api.edgedns.dev/v1/domain/favicon',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'domain': 'github.com'
    }
)

data = response.json()
print(data)

Read the full Favicon guide

Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.

Read the guide →

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.

Try This Endpoint

Test the Favicon endpoint live in the playground.