@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.
Files changed (2) hide show
  1. package/README.md +17 -6
  2. 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 31, 2026
105
+ Last updated on August 19, 2026
105
106
 
106
107
  ![logo](https://unavatar.io/api/og ":id=banner")
107
108
 
108
109
  ## Introduction
109
110
 
110
- **unavatar.io** retrieves anyone's avatar from a single URL — by username, email, or domain — across 73 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
+ **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 73 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
+ - **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.4",
5
+ "version": "3.48.6",
6
6
  "main": "src/index.js",
7
7
  "exports": {
8
8
  ".": "./src/index.js",