@unavatar/core 3.45.4 → 3.45.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 +143 -7
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -20,20 +20,25 @@
|
|
|
20
20
|
- [Apple Music](#apple-music)
|
|
21
21
|
- [Apple Store](#apple-store)
|
|
22
22
|
- [Behance](#behance)
|
|
23
|
+
- [Bilibili](#bilibili)
|
|
23
24
|
- [Bluesky](#bluesky)
|
|
24
25
|
- [Buy Me a Coffee](#buy-me-a-coffee)
|
|
26
|
+
- [Cash App](#cash-app)
|
|
25
27
|
- [CodePen](#codepen)
|
|
26
28
|
- [Cults3D](#cults3d)
|
|
27
29
|
- [Cursor](#cursor)
|
|
30
|
+
- [Deezer](#deezer)
|
|
28
31
|
- [DeviantArt](#deviantart)
|
|
29
32
|
- [Discord](#discord)
|
|
30
33
|
- [Docker Hub](#docker-hub)
|
|
31
34
|
- [Domain](#domain)
|
|
35
|
+
- [Douban](#douban)
|
|
32
36
|
- [Dribbble](#dribbble)
|
|
33
37
|
- [DuckDuckGo](#duckduckgo)
|
|
34
38
|
- [Email](#email)
|
|
35
39
|
- [Facebook](#facebook)
|
|
36
40
|
- [Flickr](#flickr)
|
|
41
|
+
- [Gitee](#gitee)
|
|
37
42
|
- [GitHub](#github)
|
|
38
43
|
- [GitLab](#gitlab)
|
|
39
44
|
- [Google](#google)
|
|
@@ -42,22 +47,27 @@
|
|
|
42
47
|
- [Hevy](#hevy)
|
|
43
48
|
- [Hugging Face](#hugging-face)
|
|
44
49
|
- [Instagram](#instagram)
|
|
50
|
+
- [Juejin](#juejin)
|
|
45
51
|
- [Ko-fi](#ko-fi)
|
|
46
52
|
- [LinkedIn](#linkedin)
|
|
47
53
|
- [Mastodon](#mastodon)
|
|
48
54
|
- [Medium](#medium)
|
|
49
55
|
- [Microlink](#microlink)
|
|
56
|
+
- [NetEase Music](#netease-music)
|
|
50
57
|
- [npm](#npm)
|
|
51
58
|
- [OnlyFans](#onlyfans)
|
|
52
59
|
- [OpenStreetMap](#openstreetmap)
|
|
53
60
|
- [Patreon](#patreon)
|
|
61
|
+
- [PayPal](#paypal)
|
|
54
62
|
- [Pinterest](#pinterest)
|
|
55
63
|
- [Primal](#primal)
|
|
56
64
|
- [Printables](#printables)
|
|
57
65
|
- [Product Hunt](#product-hunt)
|
|
58
66
|
- [PSN Profiles](#psn-profiles)
|
|
67
|
+
- [QQ](#qq)
|
|
59
68
|
- [Raycast](#raycast)
|
|
60
69
|
- [Reddit](#reddit)
|
|
70
|
+
- [Revolut](#revolut)
|
|
61
71
|
- [Snapchat](#snapchat)
|
|
62
72
|
- [SoundCloud](#soundcloud)
|
|
63
73
|
- [Spotify](#spotify)
|
|
@@ -68,14 +78,20 @@
|
|
|
68
78
|
- [Telegram](#telegram)
|
|
69
79
|
- [Thingiverse](#thingiverse)
|
|
70
80
|
- [Threads](#threads)
|
|
81
|
+
- [Tidal](#tidal)
|
|
82
|
+
- [Tieba](#tieba)
|
|
71
83
|
- [TikTok](#tiktok)
|
|
72
84
|
- [Tumblr](#tumblr)
|
|
73
85
|
- [Twitch](#twitch)
|
|
86
|
+
- [Venmo](#venmo)
|
|
74
87
|
- [Vimeo](#vimeo)
|
|
88
|
+
- [Weibo](#weibo)
|
|
75
89
|
- [WhatsApp](#whatsapp)
|
|
90
|
+
- [Wise](#wise)
|
|
76
91
|
- [X/Twitter](#xtwitter)
|
|
77
92
|
- [Xbox Gamertag](#xbox-gamertag)
|
|
78
93
|
- [YouTube](#youtube)
|
|
94
|
+
- [Zhihu](#zhihu)
|
|
79
95
|
- [Response Format](#response-format)
|
|
80
96
|
- [Response Headers](#response-headers)
|
|
81
97
|
- [Response Errors](#response-errors)
|
|
@@ -83,23 +99,27 @@
|
|
|
83
99
|
|
|
84
100
|
---
|
|
85
101
|
|
|
86
|
-
Last updated on
|
|
102
|
+
Last updated on June 14, 2026
|
|
87
103
|
|
|
88
104
|

|
|
89
105
|
|
|
90
106
|
## Introduction
|
|
91
107
|
|
|
92
|
-
|
|
108
|
+
**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.
|
|
93
109
|
|
|
94
|
-
|
|
110
|
+
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)
|
|
95
111
|
|
|
96
|
-
|
|
112
|
+
Everything you need to serve avatars at scale:
|
|
97
113
|
|
|
98
|
-
- **
|
|
114
|
+
- **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.
|
|
99
115
|
|
|
100
|
-
- **
|
|
116
|
+
- **Battle-tested**: Already serving 9.59 TB of avatars across 258.5M requests, with a 92% cache hit rate.
|
|
101
117
|
|
|
102
|
-
|
|
118
|
+
- **Optimized**: Every image is compressed and optimized on-the-fly — smaller payloads at high quality, ready to drop straight into your site or app.
|
|
119
|
+
|
|
120
|
+
- **Integration**: Drops into any site or app with zero setup. Clear docs and full support make onboarding quick and painless.
|
|
121
|
+
|
|
122
|
+
It's proudly powered by [microlink.io](https://microlink.io/), the headless browser API that handles all the heavy lifting behind the scenes to keep your avatars always ready.
|
|
103
123
|
|
|
104
124
|
## Quick start
|
|
105
125
|
|
|
@@ -562,6 +582,12 @@ Get any Behance user's profile picture by their username.
|
|
|
562
582
|
|
|
563
583
|
e.g., [unavatar.io/behance/vitormatosinhos](https://unavatar.io/behance/vitormatosinhos)
|
|
564
584
|
|
|
585
|
+
### Bilibili
|
|
586
|
+
|
|
587
|
+
Get any Bilibili user's profile picture by their numeric member ID.
|
|
588
|
+
|
|
589
|
+
e.g., [unavatar.io/bilibili/2](https://unavatar.io/bilibili/2)
|
|
590
|
+
|
|
565
591
|
### Bluesky
|
|
566
592
|
|
|
567
593
|
Get any Bluesky user's profile picture by their handle. Domain-style handles are supported.
|
|
@@ -577,6 +603,12 @@ Get any Buy Me a Coffee creator's profile picture by their username.
|
|
|
577
603
|
|
|
578
604
|
e.g., [unavatar.io/buymeacoffee/mikebarnesdrums](https://unavatar.io/buymeacoffee/mikebarnesdrums)
|
|
579
605
|
|
|
606
|
+
### Cash App
|
|
607
|
+
|
|
608
|
+
Get any Cash App user's profile picture by their Cashtag.
|
|
609
|
+
|
|
610
|
+
e.g., [unavatar.io/cashapp/ninja](https://unavatar.io/cashapp/ninja)
|
|
611
|
+
|
|
580
612
|
### CodePen
|
|
581
613
|
|
|
582
614
|
Get any CodePen user's profile picture by their username.
|
|
@@ -595,6 +627,21 @@ Get any Cursor user's profile picture by their username.
|
|
|
595
627
|
|
|
596
628
|
e.g., [unavatar.io/cursor/leerob](https://unavatar.io/cursor/leerob)
|
|
597
629
|
|
|
630
|
+
### Deezer
|
|
631
|
+
|
|
632
|
+
Get artwork for any Deezer artist, album, playlist, or track by ID.
|
|
633
|
+
|
|
634
|
+
The endpoint supports explicit type as part of the input.
|
|
635
|
+
|
|
636
|
+
If explicit type is not provided, it defaults to `artist`.
|
|
637
|
+
|
|
638
|
+
Available inputs:
|
|
639
|
+
|
|
640
|
+
- `artist` (default): [unavatar.io/deezer/27](https://unavatar.io/deezer/27) or [unavatar.io/deezer/artist:27](https://unavatar.io/deezer/artist:27)
|
|
641
|
+
- `album`: [unavatar.io/deezer/album:302127](https://unavatar.io/deezer/album:302127)
|
|
642
|
+
- `playlist`: [unavatar.io/deezer/playlist:908622995](https://unavatar.io/deezer/playlist:908622995)
|
|
643
|
+
- `track`: [unavatar.io/deezer/track:3135556](https://unavatar.io/deezer/track:3135556)
|
|
644
|
+
|
|
598
645
|
### DeviantArt
|
|
599
646
|
|
|
600
647
|
Get any DeviantArt user's profile picture by their username.
|
|
@@ -622,6 +669,12 @@ Retrieve logos and favicons from any hostname with a single URL. Domain-shaped p
|
|
|
622
669
|
|
|
623
670
|
e.g., [unavatar.io/domain/microlink.io](https://unavatar.io/domain/microlink.io)
|
|
624
671
|
|
|
672
|
+
### Douban
|
|
673
|
+
|
|
674
|
+
Get any Douban user's profile picture by their username.
|
|
675
|
+
|
|
676
|
+
e.g., [unavatar.io/douban/ahbei](https://unavatar.io/douban/ahbei)
|
|
677
|
+
|
|
625
678
|
### Dribbble
|
|
626
679
|
|
|
627
680
|
Get any Dribbble designer's profile picture by their username.
|
|
@@ -678,6 +731,12 @@ Available inputs:
|
|
|
678
731
|
- `user` (default): [unavatar.io/flickr/user:elizabethgadd](https://unavatar.io/flickr/user:elizabethgadd)
|
|
679
732
|
- `group`: [unavatar.io/flickr/group:allthingsearthy](https://unavatar.io/flickr/group:allthingsearthy)
|
|
680
733
|
|
|
734
|
+
### Gitee
|
|
735
|
+
|
|
736
|
+
Get any Gitee user's profile picture by their username.
|
|
737
|
+
|
|
738
|
+
e.g., [unavatar.io/gitee/y_project](https://unavatar.io/gitee/y_project)
|
|
739
|
+
|
|
681
740
|
### GitHub
|
|
682
741
|
|
|
683
742
|
Get any GitHub user or organization's profile picture by username, or resolve an avatar from a public email via GitHub search when the address matches a profile or commit history.
|
|
@@ -751,6 +810,12 @@ Get any Instagram user's profile picture by their username. No authentication or
|
|
|
751
810
|
|
|
752
811
|
e.g., [unavatar.io/instagram/willsmith](https://unavatar.io/instagram/willsmith)
|
|
753
812
|
|
|
813
|
+
### Juejin
|
|
814
|
+
|
|
815
|
+
Get any Juejin user's profile picture by their numeric user ID.
|
|
816
|
+
|
|
817
|
+
e.g., [unavatar.io/juejin/1556564194374926](https://unavatar.io/juejin/1556564194374926)
|
|
818
|
+
|
|
754
819
|
### Ko-fi
|
|
755
820
|
|
|
756
821
|
Get any Ko-fi page's profile picture by the creator username.
|
|
@@ -786,6 +851,12 @@ Extract the logo or representative image from any URL. The page is rendered and
|
|
|
786
851
|
|
|
787
852
|
e.g., [unavatar.io/microlink/microlink.io](https://unavatar.io/microlink/microlink.io)
|
|
788
853
|
|
|
854
|
+
### NetEase Music
|
|
855
|
+
|
|
856
|
+
Get any NetEase Music user's profile picture by their numeric user ID.
|
|
857
|
+
|
|
858
|
+
e.g., [unavatar.io/netease-music/32953014](https://unavatar.io/netease-music/32953014)
|
|
859
|
+
|
|
789
860
|
### npm
|
|
790
861
|
|
|
791
862
|
Get any npm user's profile picture by their username, including scoped handles.
|
|
@@ -813,6 +884,12 @@ Get any Patreon creator's profile picture by their username.
|
|
|
813
884
|
|
|
814
885
|
e.g., [unavatar.io/patreon/gametestro](https://unavatar.io/patreon/gametestro)
|
|
815
886
|
|
|
887
|
+
### PayPal
|
|
888
|
+
|
|
889
|
+
Get any PayPal user's profile picture by their PayPal.Me username.
|
|
890
|
+
|
|
891
|
+
e.g., [unavatar.io/paypal/kikobeats](https://unavatar.io/paypal/kikobeats)
|
|
892
|
+
|
|
816
893
|
### Pinterest
|
|
817
894
|
|
|
818
895
|
Get any Pinterest user's profile picture by their username.
|
|
@@ -850,6 +927,12 @@ Get any PlayStation Network user's profile picture by their PSN username.
|
|
|
850
927
|
|
|
851
928
|
e.g., [unavatar.io/psnprofiles/Duff85](https://unavatar.io/psnprofiles/Duff85)
|
|
852
929
|
|
|
930
|
+
### QQ
|
|
931
|
+
|
|
932
|
+
Get a QQ user's profile picture by their QQ number.
|
|
933
|
+
|
|
934
|
+
e.g., [unavatar.io/qq/10001](https://unavatar.io/qq/10001)
|
|
935
|
+
|
|
853
936
|
### Raycast
|
|
854
937
|
|
|
855
938
|
Get any Raycast user's profile picture by their username.
|
|
@@ -865,6 +948,12 @@ Available inputs:
|
|
|
865
948
|
- Username, e.g., [unavatar.io/reddit/thisisbillgates](https://unavatar.io/reddit/thisisbillgates)
|
|
866
949
|
- Organization, e.g., [unavatar.io/reddit/nasa](https://unavatar.io/reddit/nasa)
|
|
867
950
|
|
|
951
|
+
### Revolut
|
|
952
|
+
|
|
953
|
+
Get any Revolut user's profile picture by their Revolut.Me username.
|
|
954
|
+
|
|
955
|
+
e.g., [unavatar.io/revolut/midudev](https://unavatar.io/revolut/midudev)
|
|
956
|
+
|
|
868
957
|
### Snapchat
|
|
869
958
|
|
|
870
959
|
Get any Snapchat user's profile picture by their username.
|
|
@@ -945,6 +1034,26 @@ Get any Threads user's profile picture by their username.
|
|
|
945
1034
|
|
|
946
1035
|
e.g., [unavatar.io/threads/zuck](https://unavatar.io/threads/zuck)
|
|
947
1036
|
|
|
1037
|
+
### Tidal
|
|
1038
|
+
|
|
1039
|
+
Get artwork for any Tidal artist, album, or playlist by ID.
|
|
1040
|
+
|
|
1041
|
+
The endpoint supports explicit type as part of the input.
|
|
1042
|
+
|
|
1043
|
+
If explicit type is not provided, it defaults to `artist`.
|
|
1044
|
+
|
|
1045
|
+
Available inputs:
|
|
1046
|
+
|
|
1047
|
+
- `artist` (default): [unavatar.io/tidal/1566](https://unavatar.io/tidal/1566) or [unavatar.io/tidal/artist:1566](https://unavatar.io/tidal/artist:1566)
|
|
1048
|
+
- `album`: [unavatar.io/tidal/album:1765857](https://unavatar.io/tidal/album:1765857)
|
|
1049
|
+
- `playlist`: [unavatar.io/tidal/playlist:c3c18106-c4f5-4021-bb18-108255c1f450](https://unavatar.io/tidal/playlist:c3c18106-c4f5-4021-bb18-108255c1f450)
|
|
1050
|
+
|
|
1051
|
+
### Tieba
|
|
1052
|
+
|
|
1053
|
+
Get any Baidu Tieba user's profile picture by their username.
|
|
1054
|
+
|
|
1055
|
+
e.g., [unavatar.io/tieba/Mojang](https://unavatar.io/tieba/Mojang)
|
|
1056
|
+
|
|
948
1057
|
### TikTok
|
|
949
1058
|
|
|
950
1059
|
Get any TikTok user's profile picture by their username. No authentication or API tokens needed — just pass the username.
|
|
@@ -963,12 +1072,27 @@ Get any Twitch streamer's profile picture by their username.
|
|
|
963
1072
|
|
|
964
1073
|
e.g., [unavatar.io/twitch/midudev](https://unavatar.io/twitch/midudev)
|
|
965
1074
|
|
|
1075
|
+
### Venmo
|
|
1076
|
+
|
|
1077
|
+
Get any Venmo user's profile picture by their username.
|
|
1078
|
+
|
|
1079
|
+
e.g., [unavatar.io/venmo/Jessica-Lee-77](https://unavatar.io/venmo/Jessica-Lee-77)
|
|
1080
|
+
|
|
966
1081
|
### Vimeo
|
|
967
1082
|
|
|
968
1083
|
Get any Vimeo user's profile picture by their username.
|
|
969
1084
|
|
|
970
1085
|
e.g., [unavatar.io/vimeo/ladieswithlenses](https://unavatar.io/vimeo/ladieswithlenses)
|
|
971
1086
|
|
|
1087
|
+
### Weibo
|
|
1088
|
+
|
|
1089
|
+
Get any Weibo user's profile picture by numeric user ID or screen name.
|
|
1090
|
+
|
|
1091
|
+
Available inputs:
|
|
1092
|
+
|
|
1093
|
+
- User ID, e.g., [unavatar.io/weibo/2803301701](https://unavatar.io/weibo/2803301701)
|
|
1094
|
+
- Screen name, e.g., [unavatar.io/weibo/%E4%BA%BA%E6%B0%91%E6%97%A5%E6%8A%A5](https://unavatar.io/weibo/%E4%BA%BA%E6%B0%91%E6%97%A5%E6%8A%A5)
|
|
1095
|
+
|
|
972
1096
|
### WhatsApp
|
|
973
1097
|
|
|
974
1098
|
Get the profile picture for a WhatsApp channel or chat by ID.
|
|
@@ -983,6 +1107,12 @@ Available inputs:
|
|
|
983
1107
|
- `channel`: [unavatar.io/whatsapp/channel:0029VaARuQ7KwqSXh9fiMc0m](https://unavatar.io/whatsapp/channel:0029VaARuQ7KwqSXh9fiMc0m)
|
|
984
1108
|
- `chat`: [unavatar.io/whatsapp/chat:D2FFycjQXrEIKG8qQjbwZz](https://unavatar.io/whatsapp/chat:D2FFycjQXrEIKG8qQjbwZz)
|
|
985
1109
|
|
|
1110
|
+
### Wise
|
|
1111
|
+
|
|
1112
|
+
Get any Wise user's profile picture by their Wisetag.
|
|
1113
|
+
|
|
1114
|
+
e.g., [unavatar.io/wise/josev2264](https://unavatar.io/wise/josev2264)
|
|
1115
|
+
|
|
986
1116
|
### X/Twitter
|
|
987
1117
|
|
|
988
1118
|
Get any X (formerly Twitter) user's profile picture by their username.
|
|
@@ -1008,6 +1138,12 @@ Available inputs:
|
|
|
1008
1138
|
- `username`: [unavatar.io/youtube/casey](https://unavatar.io/youtube/casey)
|
|
1009
1139
|
- `channel`: [unavatar.io/youtube/UC_x5XG1OV2P6uZZ5FSM9Ttw](https://unavatar.io/youtube/UC_x5XG1OV2P6uZZ5FSM9Ttw)
|
|
1010
1140
|
|
|
1141
|
+
### Zhihu
|
|
1142
|
+
|
|
1143
|
+
Get any Zhihu user's profile picture by their username.
|
|
1144
|
+
|
|
1145
|
+
e.g., [unavatar.io/zhihu/kaifulee](https://unavatar.io/zhihu/kaifulee)
|
|
1146
|
+
|
|
1011
1147
|
## Response Format
|
|
1012
1148
|
|
|
1013
1149
|
A response is returning the user avatar by default.
|
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.45.
|
|
5
|
+
"version": "3.45.6",
|
|
6
6
|
"main": "src/index.js",
|
|
7
7
|
"exports": {
|
|
8
8
|
".": "./src/index.js",
|
|
@@ -137,7 +137,7 @@
|
|
|
137
137
|
"https-tls": "~1.0.24",
|
|
138
138
|
"ipaddr.js": "~2.4.0",
|
|
139
139
|
"is-absolute-url": "~3.0.3",
|
|
140
|
-
"is-antibot": "~2.
|
|
140
|
+
"is-antibot": "~2.1.0",
|
|
141
141
|
"is-email-like": "~1.0.0",
|
|
142
142
|
"lodash": "~4.18.1",
|
|
143
143
|
"ms": "~2.1.3",
|