> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osint.ly/llms.txt
> Use this file to discover all available pages before exploring further.

# Logo Service

> Embed domain logos and country flags anywhere using a single URL - no API key required.

Osintly provides a public logo service at `https://logos.osint.ly` that returns logo images for domains and country flags by alias. It works directly in browsers, apps, and any HTTP client - no authentication required.

<CardGroup cols={2}>
  <Card title="One URL per domain" icon="link">
    `https://logos.osint.ly/github.com` - just swap the domain.
  </Card>

  <Card title="Country flags" icon="flag">
    `https://logos.osint.ly/flags/france.svg` - use country names, ISO codes, or common aliases.
  </Card>

  <Card title="Use it anywhere" icon="globe">
    HTML, CSS, JavaScript, React - CORS enabled for direct browser access.
  </Card>
</CardGroup>

***

## How it works

Send a `GET` request with the domain as the path:

```http theme={null}
GET https://logos.osint.ly/{domain}
```

The logo image is returned directly - PNG, SVG, or ICO depending on what is available.

**Examples:**

```
https://logos.osint.ly/avast.com
https://logos.osint.ly/stripe.com
https://logos.osint.ly/openai.com
```

The `www.` prefix is stripped automatically, so `www.github.com` resolves the same as `github.com`.

***

## Country flags

Send a `GET` request to `/flags/{alias}` or `/flags/{alias}.{format}`:

```http theme={null}
GET https://logos.osint.ly/flags/{alias}
GET https://logos.osint.ly/flags/{alias}.{format}
```

The alias is normalized to a canonical country code. The service accepts ISO codes, common country names in English and French, and frequent shortcuts like `uk`.

**Examples:**

```
https://logos.osint.ly/flags/france.svg
https://logos.osint.ly/flags/fr
https://logos.osint.ly/flags/français.webp
https://logos.osint.ly/flags/uk.png
```

If no extension is provided, `svg` is used by default:

```
https://logos.osint.ly/flags/france  →  same as /flags/france.svg
```

Supported formats are `svg`, `png`, `webp`, `jpg`, and `jpeg`. The `jpeg` extension is normalized to `jpg`.

***

## Quick examples

```html theme={null}
<!-- Drop it directly into an <img> tag -->
<img src="https://logos.osint.ly/github.com" alt="GitHub logo" />
```

```html theme={null}
<!-- Country flags work the same way -->
<img src="https://logos.osint.ly/flags/france.svg" alt="France flag" />
```

```jsx theme={null}
{/* In React, use a template literal */}
<img src={`https://logos.osint.ly/${domain}`} alt={`${domain} logo`} />
```

For more integration patterns (CSS, JavaScript) and rate limit details, see the [Logo Service API reference](/api-reference/logos).