@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.
Files changed (2) hide show
  1. package/README.md +143 -7
  2. 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 May 13, 2026
102
+ Last updated on June 14, 2026
87
103
 
88
104
  ![logo](https://unavatar.io/api/og ":id=banner")
89
105
 
90
106
  ## Introduction
91
107
 
92
- Welcome to **unavatar.io**, the ultimate avatar service that offers everything you need to easily retrieve user avatars:
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
- - **Versatile**: A wide range of platforms and services including [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), etc., meaning you can rule all of them just querying against unavatar.
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
- - **Speed**: Designed to be fast and efficient with a 92% cache hit rate, serving 9.59 TB of data across 258.5M requests.
112
+ Everything you need to serve avatars at scale:
97
113
 
98
- - **Optimize**: All the images are not only compressed on-the-fly to reduce their size and save bandwidth, but also optimized to maintain a high-quality ratio. They are ready for immediate use, enhancing the overall optimization of your website or application.
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
- - **Integration**: The service seamlessly incorporates into your current applications or websites with ease. We offer straightforward documentation and comprehensive support to ensure a quick and effortless onboarding experience.
116
+ - **Battle-tested**: Already serving 9.59 TB of avatars across 258.5M requests, with a 92% cache hit rate.
101
117
 
102
- It's proudly powered by [microlink.io](https://microlink.io/), the headless browser API that handles all the heavy lifting behind the scenes to ensure your avatars are always ready.
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.4",
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.0.0",
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",