@unavatar/core 3.48.4 → 3.48.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -23,6 +23,7 @@
|
|
|
23
23
|
- [Apple Store](#apple-store)
|
|
24
24
|
- [Behance](#behance)
|
|
25
25
|
- [Bilibili](#bilibili)
|
|
26
|
+
- [BIMI](#bimi)
|
|
26
27
|
- [Bluesky](#bluesky)
|
|
27
28
|
- [Buy Me a Coffee](#buy-me-a-coffee)
|
|
28
29
|
- [Cash App](#cash-app)
|
|
@@ -101,19 +102,19 @@
|
|
|
101
102
|
|
|
102
103
|
---
|
|
103
104
|
|
|
104
|
-
Last updated on August
|
|
105
|
+
Last updated on August 19, 2026
|
|
105
106
|
|
|
106
107
|

|
|
107
108
|
|
|
108
109
|
## Introduction
|
|
109
110
|
|
|
110
|
-
**unavatar.io** retrieves anyone's avatar from a single URL — by username, email, or domain — across
|
|
111
|
+
**unavatar.io** retrieves anyone's avatar from a single URL — by username, email, or domain — across 74 platforms including [Instagram](https://unavatar.io/docs#instagram), [GitHub](https://unavatar.io/docs#github), [YouTube](https://unavatar.io/docs#youtube), [X/Twitter](https://unavatar.io/docs#xtwitter), and [Gravatar](https://unavatar.io/docs#gravatar). No API keys, no SDKs, free to start.
|
|
111
112
|
|
|
112
113
|
Try it: [unavatar.io/github/kikobeats](https://unavatar.io/github/kikobeats) · [unavatar.io/x/josebaseba](https://unavatar.io/x/josebaseba) · [unavatar.io/domain/reddit.com](https://unavatar.io/domain/reddit.com)
|
|
113
114
|
|
|
114
115
|
Everything you need to serve avatars at scale:
|
|
115
116
|
|
|
116
|
-
- **Versatile**: One endpoint rules
|
|
117
|
+
- **Versatile**: One endpoint rules 74 platforms and services — [TikTok](https://unavatar.io/docs#tiktok), [Instagram](https://unavatar.io/docs#instagram), [YouTube](https://unavatar.io/docs#youtube), [X/Twitter](https://unavatar.io/docs#xtwitter), [Gravatar](https://unavatar.io/docs#gravatar), and more — all queried the same way.
|
|
117
118
|
|
|
118
119
|
- **Battle-tested**: Already serving 2.77 TB of avatars across 189.4M requests, with a 70% cache hit rate.
|
|
119
120
|
|
|
@@ -590,6 +591,15 @@ Get any Bilibili user's profile picture by their numeric member ID.
|
|
|
590
591
|
|
|
591
592
|
e.g., [unavatar.io/bilibili/2](https://unavatar.io/bilibili/2)
|
|
592
593
|
|
|
594
|
+
### BIMI
|
|
595
|
+
|
|
596
|
+
Get the official brand logo published via Brand Indicators for Message Identification (BIMI) for a domain or email address.
|
|
597
|
+
|
|
598
|
+
Available inputs:
|
|
599
|
+
|
|
600
|
+
- Domain, e.g., [unavatar.io/bimi/cnn.com](https://unavatar.io/bimi/cnn.com)
|
|
601
|
+
- Email address, e.g., [unavatar.io/bimi/support@ebay.com](https://unavatar.io/bimi/support@ebay.com)
|
|
602
|
+
|
|
593
603
|
### Bluesky
|
|
594
604
|
|
|
595
605
|
Get any Bluesky user's profile picture by their handle. Domain-style handles are supported.
|
|
@@ -667,7 +677,7 @@ e.g., [unavatar.io/dockerhub/tensorflow](https://unavatar.io/dockerhub/tensorflo
|
|
|
667
677
|
|
|
668
678
|
### Domain
|
|
669
679
|
|
|
670
|
-
Retrieve logos and favicons from any hostname with a single URL. Domain-shaped paths try DuckDuckGo, Google, Microlink in order until one returns an image, same as the explicit `/domain/:key` route.
|
|
680
|
+
Retrieve logos and favicons from any hostname with a single URL. Domain-shaped paths try BIMI, DuckDuckGo, Google, Microlink in order until one returns an image, same as the explicit `/domain/:key` route.
|
|
671
681
|
|
|
672
682
|
e.g., [unavatar.io/domain/microlink.io](https://unavatar.io/domain/microlink.io)
|
|
673
683
|
|
|
@@ -685,13 +695,13 @@ e.g., [unavatar.io/duckduckgo/microsoft.com](https://unavatar.io/duckduckgo/micr
|
|
|
685
695
|
|
|
686
696
|
### Email
|
|
687
697
|
|
|
688
|
-
Resolve user avatars from an email address with a single URL. The `/email/:key` route uses the same provider chain as a bare `/user@domain` path: the service tries Gravatar, GitHub in order until one returns an image. No API keys and no SDK are required.
|
|
698
|
+
Resolve user avatars from an email address with a single URL. The `/email/:key` route uses the same provider chain as a bare `/user@domain` path: the service tries Gravatar, GitHub, BIMI in order until one returns an image. No API keys and no SDK are required.
|
|
689
699
|
|
|
690
700
|
When the path looks like an email, unavatar walks that chain until a provider succeeds. You can also skip the chain and call a named email provider directly when you know where the avatar should come from.
|
|
691
701
|
|
|
692
702
|
Automatic resolution
|
|
693
703
|
|
|
694
|
-
Pass the address as the only path segment, or prefix it with `email/`. The API auto-detects email-shaped inputs and runs the same chain (Gravatar, GitHub).
|
|
704
|
+
Pass the address as the only path segment, or prefix it with `email/`. The API auto-detects email-shaped inputs and runs the same chain (Gravatar, GitHub, BIMI).
|
|
695
705
|
|
|
696
706
|
- Typed route `unavatar.io/email/{email}`: [unavatar.io/email/hello@microlink.io](https://unavatar.io/email/hello@microlink.io)
|
|
697
707
|
- Bare path `unavatar.io/{email}`: [unavatar.io/hello@microlink.io](https://unavatar.io/hello@microlink.io)
|
|
@@ -702,6 +712,7 @@ Target a specific provider when you know where the avatar comes from.
|
|
|
702
712
|
|
|
703
713
|
- Gravatar (`unavatar.io/gravatar/{email-or-hash}`) — email is normalized and SHA-256 hashed; 64-hex SHA-256 or 32-hex MD5 passes through. Example: [unavatar.io/gravatar/hello@microlink.io](https://unavatar.io/gravatar/hello@microlink.io)
|
|
704
714
|
- GitHub (`unavatar.io/github/{email}`) — public profile email or commit history: [unavatar.io/github/sindresorhus@gmail.com](https://unavatar.io/github/sindresorhus@gmail.com)
|
|
715
|
+
- BIMI (`unavatar.io/bimi/{email}`) — official brand logo from the address domain: [unavatar.io/bimi/support@ebay.com](https://unavatar.io/bimi/support@ebay.com)
|
|
705
716
|
|
|
706
717
|
e.g., [unavatar.io/email/hello@microlink.io](https://unavatar.io/email/hello@microlink.io)
|
|
707
718
|
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "@unavatar/core",
|
|
3
3
|
"description": "Get unified user avatar from social networks, including Instagram, SoundCloud, Telegram, Twitter, YouTube & more.",
|
|
4
4
|
"homepage": "https://unavatar.io",
|
|
5
|
-
"version": "3.48.
|
|
5
|
+
"version": "3.48.6",
|
|
6
6
|
"main": "src/index.js",
|
|
7
7
|
"exports": {
|
|
8
8
|
".": "./src/index.js",
|