@unavatar/core 3.71.2 → 3.71.3
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 +223 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -24,42 +24,62 @@
|
|
|
24
24
|
- [Behance](#behance)
|
|
25
25
|
- [Bilibili](#bilibili)
|
|
26
26
|
- [BIMI](#bimi)
|
|
27
|
+
- [Bitbucket](#bitbucket)
|
|
27
28
|
- [Bluesky](#bluesky)
|
|
28
29
|
- [Buy Me a Coffee](#buy-me-a-coffee)
|
|
29
30
|
- [Cash App](#cash-app)
|
|
31
|
+
- [Chess.com](#chesscom)
|
|
32
|
+
- [Codeforces](#codeforces)
|
|
30
33
|
- [CodePen](#codepen)
|
|
31
34
|
- [Cults3D](#cults3d)
|
|
32
35
|
- [Cursor](#cursor)
|
|
36
|
+
- [Dailymotion](#dailymotion)
|
|
33
37
|
- [Deezer](#deezer)
|
|
38
|
+
- [DEV](#dev)
|
|
34
39
|
- [DeviantArt](#deviantart)
|
|
35
40
|
- [Discord](#discord)
|
|
36
41
|
- [Docker Hub](#docker-hub)
|
|
37
42
|
- [Domain](#domain)
|
|
38
43
|
- [Dribbble](#dribbble)
|
|
39
44
|
- [DuckDuckGo](#duckduckgo)
|
|
45
|
+
- [Duolingo](#duolingo)
|
|
40
46
|
- [Email](#email)
|
|
47
|
+
- [ENS](#ens)
|
|
41
48
|
- [Facebook](#facebook)
|
|
49
|
+
- [Farcaster](#farcaster)
|
|
42
50
|
- [Flickr](#flickr)
|
|
43
51
|
- [Gitee](#gitee)
|
|
44
52
|
- [GitHub](#github)
|
|
45
53
|
- [GitLab](#gitlab)
|
|
54
|
+
- [Goodreads](#goodreads)
|
|
46
55
|
- [Google](#google)
|
|
47
56
|
- [Google Play](#google-play)
|
|
48
57
|
- [Gravatar](#gravatar)
|
|
58
|
+
- [Gumroad](#gumroad)
|
|
49
59
|
- [Hevy](#hevy)
|
|
50
60
|
- [Hugging Face](#hugging-face)
|
|
51
61
|
- [Instagram](#instagram)
|
|
52
62
|
- [Juejin](#juejin)
|
|
63
|
+
- [Kaggle](#kaggle)
|
|
64
|
+
- [Keybase](#keybase)
|
|
53
65
|
- [Kick](#kick)
|
|
54
66
|
- [Ko-fi](#ko-fi)
|
|
67
|
+
- [Lemmy](#lemmy)
|
|
68
|
+
- [Libravatar](#libravatar)
|
|
55
69
|
- [LinkedIn](#linkedin)
|
|
56
70
|
- [Mastodon](#mastodon)
|
|
71
|
+
- [Matrix](#matrix)
|
|
57
72
|
- [Medium](#medium)
|
|
58
73
|
- [Microlink](#microlink)
|
|
74
|
+
- [Minecraft](#minecraft)
|
|
75
|
+
- [Mixcloud](#mixcloud)
|
|
59
76
|
- [NetEase Music](#netease-music)
|
|
77
|
+
- [note](#note)
|
|
60
78
|
- [npm](#npm)
|
|
61
79
|
- [OnlyFans](#onlyfans)
|
|
80
|
+
- [Open Collective](#open-collective)
|
|
62
81
|
- [OpenStreetMap](#openstreetmap)
|
|
82
|
+
- [osu!](#osu)
|
|
63
83
|
- [Patreon](#patreon)
|
|
64
84
|
- [PayPal](#paypal)
|
|
65
85
|
- [Pinterest](#pinterest)
|
|
@@ -71,12 +91,16 @@
|
|
|
71
91
|
- [Raycast](#raycast)
|
|
72
92
|
- [Reddit](#reddit)
|
|
73
93
|
- [Revolut](#revolut)
|
|
94
|
+
- [Roblox](#roblox)
|
|
95
|
+
- [Sketchfab](#sketchfab)
|
|
74
96
|
- [Snapchat](#snapchat)
|
|
75
97
|
- [SoundCloud](#soundcloud)
|
|
98
|
+
- [Speedrun.com](#speedruncom)
|
|
76
99
|
- [Spotify](#spotify)
|
|
77
100
|
- [Stack Overflow](#stack-overflow)
|
|
78
101
|
- [Steam](#steam)
|
|
79
102
|
- [Strava](#strava)
|
|
103
|
+
- [Stripe](#stripe)
|
|
80
104
|
- [Substack](#substack)
|
|
81
105
|
- [Telegram](#telegram)
|
|
82
106
|
- [Thingiverse](#thingiverse)
|
|
@@ -88,6 +112,7 @@
|
|
|
88
112
|
- [Twitch](#twitch)
|
|
89
113
|
- [Venmo](#venmo)
|
|
90
114
|
- [Vimeo](#vimeo)
|
|
115
|
+
- [Wattpad](#wattpad)
|
|
91
116
|
- [Weibo](#weibo)
|
|
92
117
|
- [WhatsApp](#whatsapp)
|
|
93
118
|
- [Wise](#wise)
|
|
@@ -102,21 +127,21 @@
|
|
|
102
127
|
|
|
103
128
|
---
|
|
104
129
|
|
|
105
|
-
Last updated on
|
|
130
|
+
Last updated on October 5, 2026
|
|
106
131
|
|
|
107
132
|

|
|
108
133
|
|
|
109
134
|
## Introduction
|
|
110
135
|
|
|
111
|
-
**unavatar.io** retrieves anyone's avatar from a single URL — by username, email, or domain — across
|
|
136
|
+
**unavatar.io** retrieves anyone's avatar from a single URL — by username, email, or domain — across 99 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.
|
|
112
137
|
|
|
113
138
|
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)
|
|
114
139
|
|
|
115
140
|
Everything you need to serve avatars at scale:
|
|
116
141
|
|
|
117
|
-
- **Versatile**: One endpoint rules
|
|
142
|
+
- **Versatile**: One endpoint rules 99 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.
|
|
118
143
|
|
|
119
|
-
- **Battle-tested**: Already serving 2.
|
|
144
|
+
- **Battle-tested**: Already serving 2.96 TB of avatars across 226.5M requests, with a 70% cache hit rate.
|
|
120
145
|
|
|
121
146
|
- **Optimized**: Every image is compressed and optimized on-the-fly — smaller payloads at high quality, ready to drop straight into your site or app.
|
|
122
147
|
|
|
@@ -413,6 +438,11 @@ Domains can be managed from the [dashboard](https://unavatar.io/dashboard?tab=cr
|
|
|
413
438
|
- `example.com` — exact domain match
|
|
414
439
|
- `*.example.com` — all subdomains of example.com
|
|
415
440
|
- `app.example.com` — a specific subdomain
|
|
441
|
+
- `localhost` — local development, on any port
|
|
442
|
+
|
|
443
|
+
Only the hostname is compared, so ports, protocols and paths are ignored: `localhost:3000` and `http://localhost:3000` are both stored as `localhost`. `127.0.0.1` is a different hostname than `localhost`; add it as its own entry if you browse your local site that way.
|
|
444
|
+
|
|
445
|
+
`localhost` is never allowed implicitly. A key with domain restrictions rejects local requests with [`EPKDOMAIN`](https://unavatar.io/docs#response-errors) until you add it.
|
|
416
446
|
|
|
417
447
|
## Pricing
|
|
418
448
|
|
|
@@ -600,6 +630,12 @@ Available inputs:
|
|
|
600
630
|
- Domain, e.g., [unavatar.io/bimi/cnn.com](https://unavatar.io/bimi/cnn.com)
|
|
601
631
|
- Email address, e.g., [unavatar.io/bimi/support@ebay.com](https://unavatar.io/bimi/support@ebay.com)
|
|
602
632
|
|
|
633
|
+
### Bitbucket
|
|
634
|
+
|
|
635
|
+
Get any Bitbucket workspace's avatar by its workspace slug, which matches the owner's username.
|
|
636
|
+
|
|
637
|
+
e.g., [unavatar.io/bitbucket/atlassian](https://unavatar.io/bitbucket/atlassian)
|
|
638
|
+
|
|
603
639
|
### Bluesky
|
|
604
640
|
|
|
605
641
|
Get any Bluesky user's profile picture by their handle. Domain-style handles are supported.
|
|
@@ -621,6 +657,18 @@ Get any Cash App user's profile picture by their Cashtag.
|
|
|
621
657
|
|
|
622
658
|
e.g., [unavatar.io/cashapp/ninja](https://unavatar.io/cashapp/ninja)
|
|
623
659
|
|
|
660
|
+
### Chess.com
|
|
661
|
+
|
|
662
|
+
Get any Chess.com player's profile picture by their username.
|
|
663
|
+
|
|
664
|
+
e.g., [unavatar.io/chesscom/hikaru](https://unavatar.io/chesscom/hikaru)
|
|
665
|
+
|
|
666
|
+
### Codeforces
|
|
667
|
+
|
|
668
|
+
Get any Codeforces user's profile picture by their handle.
|
|
669
|
+
|
|
670
|
+
e.g., [unavatar.io/codeforces/tourist](https://unavatar.io/codeforces/tourist)
|
|
671
|
+
|
|
624
672
|
### CodePen
|
|
625
673
|
|
|
626
674
|
Get any CodePen user's profile picture by their username.
|
|
@@ -639,6 +687,12 @@ Get any Cursor user's profile picture by their username.
|
|
|
639
687
|
|
|
640
688
|
e.g., [unavatar.io/cursor/leerob](https://unavatar.io/cursor/leerob)
|
|
641
689
|
|
|
690
|
+
### Dailymotion
|
|
691
|
+
|
|
692
|
+
Get any Dailymotion user's or channel's avatar by their username.
|
|
693
|
+
|
|
694
|
+
e.g., [unavatar.io/dailymotion/dailymotion](https://unavatar.io/dailymotion/dailymotion)
|
|
695
|
+
|
|
642
696
|
### Deezer
|
|
643
697
|
|
|
644
698
|
Get artwork for any Deezer artist, album, playlist, or track by ID.
|
|
@@ -654,6 +708,15 @@ Available inputs:
|
|
|
654
708
|
- `playlist`: [unavatar.io/deezer/playlist:908622995](https://unavatar.io/deezer/playlist:908622995)
|
|
655
709
|
- `track`: [unavatar.io/deezer/track:3135556](https://unavatar.io/deezer/track:3135556)
|
|
656
710
|
|
|
711
|
+
### DEV
|
|
712
|
+
|
|
713
|
+
Get any DEV Community member's or organization's profile picture by their username or organization slug.
|
|
714
|
+
|
|
715
|
+
Available inputs:
|
|
716
|
+
|
|
717
|
+
- Username, e.g., [unavatar.io/devto/ben](https://unavatar.io/devto/ben)
|
|
718
|
+
- Organization, e.g., [unavatar.io/devto/devteam](https://unavatar.io/devto/devteam)
|
|
719
|
+
|
|
657
720
|
### DeviantArt
|
|
658
721
|
|
|
659
722
|
Get any DeviantArt user's profile picture by their username.
|
|
@@ -693,15 +756,21 @@ Get the favicon or logo for any domain via DuckDuckGo's icon service. Useful as
|
|
|
693
756
|
|
|
694
757
|
e.g., [unavatar.io/duckduckgo/microsoft.com](https://unavatar.io/duckduckgo/microsoft.com)
|
|
695
758
|
|
|
759
|
+
### Duolingo
|
|
760
|
+
|
|
761
|
+
Get any Duolingo learner's avatar by their username.
|
|
762
|
+
|
|
763
|
+
e.g., [unavatar.io/duolingo/luis](https://unavatar.io/duolingo/luis)
|
|
764
|
+
|
|
696
765
|
### Email
|
|
697
766
|
|
|
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.
|
|
767
|
+
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, Libravatar, BIMI in order until one returns an image. No API keys and no SDK are required.
|
|
699
768
|
|
|
700
769
|
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.
|
|
701
770
|
|
|
702
771
|
Automatic resolution
|
|
703
772
|
|
|
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).
|
|
773
|
+
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, Libravatar, BIMI).
|
|
705
774
|
|
|
706
775
|
- Typed route `unavatar.io/email/{email}`: [unavatar.io/email/hello@microlink.io](https://unavatar.io/email/hello@microlink.io)
|
|
707
776
|
- Bare path `unavatar.io/{email}`: [unavatar.io/hello@microlink.io](https://unavatar.io/hello@microlink.io)
|
|
@@ -716,6 +785,15 @@ Target a specific provider when you know where the avatar comes from.
|
|
|
716
785
|
|
|
717
786
|
e.g., [unavatar.io/email/hello@microlink.io](https://unavatar.io/email/hello@microlink.io)
|
|
718
787
|
|
|
788
|
+
### ENS
|
|
789
|
+
|
|
790
|
+
Get the avatar record of any ENS name, including `.base.eth` subnames. A bare label resolves as a `.eth` name, and `.eth` inputs are detected automatically without the provider prefix.
|
|
791
|
+
|
|
792
|
+
Available inputs:
|
|
793
|
+
|
|
794
|
+
- ENS name, e.g., [unavatar.io/ens/vitalik.eth](https://unavatar.io/ens/vitalik.eth)
|
|
795
|
+
- Subname, e.g., [unavatar.io/ens/jesse.base.eth](https://unavatar.io/ens/jesse.base.eth)
|
|
796
|
+
|
|
719
797
|
### Facebook
|
|
720
798
|
|
|
721
799
|
Get any Facebook user, page, or group profile picture by their username or ID.
|
|
@@ -725,6 +803,12 @@ Available inputs:
|
|
|
725
803
|
- Username, e.g., [unavatar.io/facebook/zuck](https://unavatar.io/facebook/zuck)
|
|
726
804
|
- Page, e.g., [unavatar.io/facebook/windtodayco](https://unavatar.io/facebook/windtodayco)
|
|
727
805
|
|
|
806
|
+
### Farcaster
|
|
807
|
+
|
|
808
|
+
Get any Farcaster user's profile picture by their username.
|
|
809
|
+
|
|
810
|
+
e.g., [unavatar.io/farcaster/dwr](https://unavatar.io/farcaster/dwr)
|
|
811
|
+
|
|
728
812
|
### Flickr
|
|
729
813
|
|
|
730
814
|
Get any Flickr user's buddy icon or group icon by username or group slug.
|
|
@@ -763,6 +847,19 @@ Available inputs:
|
|
|
763
847
|
- User, e.g., [unavatar.io/gitlab/sytses](https://unavatar.io/gitlab/sytses)
|
|
764
848
|
- Organization, e.g., [unavatar.io/gitlab/inkscape](https://unavatar.io/gitlab/inkscape)
|
|
765
849
|
|
|
850
|
+
### Goodreads
|
|
851
|
+
|
|
852
|
+
Get any Goodreads reader's or author's photo by username, user ID, or author ID.
|
|
853
|
+
|
|
854
|
+
The input supports a URI format `type:id`.
|
|
855
|
+
|
|
856
|
+
When no type is provided, it defaults to `user`.
|
|
857
|
+
|
|
858
|
+
Available inputs:
|
|
859
|
+
|
|
860
|
+
- `user` (default): [unavatar.io/goodreads/otis](https://unavatar.io/goodreads/otis) or [unavatar.io/goodreads/1](https://unavatar.io/goodreads/1)
|
|
861
|
+
- `author`: [unavatar.io/goodreads/author:4](https://unavatar.io/goodreads/author:4)
|
|
862
|
+
|
|
766
863
|
### Google
|
|
767
864
|
|
|
768
865
|
Get the favicon or logo for any domain using Google's favicon service.
|
|
@@ -796,6 +893,12 @@ When you pass an email address directly in the URL, it is visible in plain text
|
|
|
796
893
|
|
|
797
894
|
To avoid this, pass a pre-computed `MD5` or `SHA256` hash of the email instead. Unavatar detects the hash automatically and routes it to Gravatar, which natively supports both hash formats.
|
|
798
895
|
|
|
896
|
+
### Gumroad
|
|
897
|
+
|
|
898
|
+
Get any Gumroad creator's profile picture by their username.
|
|
899
|
+
|
|
900
|
+
e.g., [unavatar.io/gumroad/sahil](https://unavatar.io/gumroad/sahil)
|
|
901
|
+
|
|
799
902
|
### Hevy
|
|
800
903
|
|
|
801
904
|
Get any Hevy user's profile picture by their username.
|
|
@@ -823,6 +926,18 @@ Get any Juejin user's profile picture by their numeric user ID.
|
|
|
823
926
|
|
|
824
927
|
e.g., [unavatar.io/juejin/1556564194374926](https://unavatar.io/juejin/1556564194374926)
|
|
825
928
|
|
|
929
|
+
### Kaggle
|
|
930
|
+
|
|
931
|
+
Get any Kaggle user's profile picture by their username.
|
|
932
|
+
|
|
933
|
+
e.g., [unavatar.io/kaggle/jhoward](https://unavatar.io/kaggle/jhoward)
|
|
934
|
+
|
|
935
|
+
### Keybase
|
|
936
|
+
|
|
937
|
+
Get any Keybase user's profile picture by their username.
|
|
938
|
+
|
|
939
|
+
e.g., [unavatar.io/keybase/chris](https://unavatar.io/keybase/chris)
|
|
940
|
+
|
|
826
941
|
### Kick
|
|
827
942
|
|
|
828
943
|
Get any Kick streamer's profile picture by their username.
|
|
@@ -835,6 +950,21 @@ Get any Ko-fi page's profile picture by the creator username.
|
|
|
835
950
|
|
|
836
951
|
e.g., [unavatar.io/ko-fi/geekshock](https://unavatar.io/ko-fi/geekshock)
|
|
837
952
|
|
|
953
|
+
### Lemmy
|
|
954
|
+
|
|
955
|
+
Get any Lemmy user's avatar from their home instance by their `user@instance` handle.
|
|
956
|
+
|
|
957
|
+
e.g., [unavatar.io/lemmy/ruud@lemmy.world](https://unavatar.io/lemmy/ruud@lemmy.world)
|
|
958
|
+
|
|
959
|
+
### Libravatar
|
|
960
|
+
|
|
961
|
+
Resolve avatars via Libravatar, the federated open-source avatar service, using an email or a precomputed MD5 or SHA-256 hash. Emails on domains that run their own Libravatar server are resolved from that server.
|
|
962
|
+
|
|
963
|
+
Available inputs:
|
|
964
|
+
|
|
965
|
+
- MD5 hash, e.g., [unavatar.io/libravatar/7cc352a2907216992f0f16d2af50b070](https://unavatar.io/libravatar/7cc352a2907216992f0f16d2af50b070)
|
|
966
|
+
- SHA-256 hash, e.g., [unavatar.io/libravatar/857915e8681217376523fa2c4653a499a7dc6826197b077d35fc029d7c38bda1](https://unavatar.io/libravatar/857915e8681217376523fa2c4653a499a7dc6826197b077d35fc029d7c38bda1)
|
|
967
|
+
|
|
838
968
|
### LinkedIn
|
|
839
969
|
|
|
840
970
|
Get any LinkedIn user or company profile picture by username or company slug.
|
|
@@ -852,6 +982,12 @@ Get any Mastodon user's profile picture from any instance using the public accou
|
|
|
852
982
|
|
|
853
983
|
e.g., [unavatar.io/mastodon/kpwags@hachyderm.io](https://unavatar.io/mastodon/kpwags@hachyderm.io)
|
|
854
984
|
|
|
985
|
+
### Matrix
|
|
986
|
+
|
|
987
|
+
Get any Matrix user's avatar by their Matrix ID, resolved from their homeserver.
|
|
988
|
+
|
|
989
|
+
e.g., [unavatar.io/matrix/@matthew:matrix.org](https://unavatar.io/matrix/@matthew:matrix.org)
|
|
990
|
+
|
|
855
991
|
### Medium
|
|
856
992
|
|
|
857
993
|
Get any Medium author's profile picture by their username.
|
|
@@ -864,12 +1000,33 @@ Extract the logo or representative image from any URL. The page is rendered and
|
|
|
864
1000
|
|
|
865
1001
|
e.g., [unavatar.io/microlink/microlink.io](https://unavatar.io/microlink/microlink.io)
|
|
866
1002
|
|
|
1003
|
+
### Minecraft
|
|
1004
|
+
|
|
1005
|
+
Get any Minecraft Java Edition player's face by their username or UUID.
|
|
1006
|
+
|
|
1007
|
+
Available inputs:
|
|
1008
|
+
|
|
1009
|
+
- Username, e.g., [unavatar.io/minecraft/notch](https://unavatar.io/minecraft/notch)
|
|
1010
|
+
- UUID, e.g., [unavatar.io/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5](https://unavatar.io/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5)
|
|
1011
|
+
|
|
1012
|
+
### Mixcloud
|
|
1013
|
+
|
|
1014
|
+
Get any Mixcloud user's profile picture by their username.
|
|
1015
|
+
|
|
1016
|
+
e.g., [unavatar.io/mixcloud/spartacus](https://unavatar.io/mixcloud/spartacus)
|
|
1017
|
+
|
|
867
1018
|
### NetEase Music
|
|
868
1019
|
|
|
869
1020
|
Get any NetEase Music user's profile picture by their numeric user ID.
|
|
870
1021
|
|
|
871
1022
|
e.g., [unavatar.io/netease-music/32953014](https://unavatar.io/netease-music/32953014)
|
|
872
1023
|
|
|
1024
|
+
### note
|
|
1025
|
+
|
|
1026
|
+
Get any note creator's profile picture by their note ID.
|
|
1027
|
+
|
|
1028
|
+
e.g., [unavatar.io/note/info](https://unavatar.io/note/info)
|
|
1029
|
+
|
|
873
1030
|
### npm
|
|
874
1031
|
|
|
875
1032
|
Get any npm user's profile picture by their username, including scoped handles.
|
|
@@ -882,6 +1039,12 @@ Get any OnlyFans creator's profile picture by their username.
|
|
|
882
1039
|
|
|
883
1040
|
e.g., [unavatar.io/onlyfans/amandaribas](https://unavatar.io/onlyfans/amandaribas)
|
|
884
1041
|
|
|
1042
|
+
### Open Collective
|
|
1043
|
+
|
|
1044
|
+
Get any Open Collective account's avatar by its slug, for collectives, organizations, and individuals.
|
|
1045
|
+
|
|
1046
|
+
e.g., [unavatar.io/opencollective/webpack](https://unavatar.io/opencollective/webpack)
|
|
1047
|
+
|
|
885
1048
|
### OpenStreetMap
|
|
886
1049
|
|
|
887
1050
|
Get any OpenStreetMap contributor's profile picture. Accepts either a numeric user ID or a username.
|
|
@@ -891,6 +1054,15 @@ Available inputs:
|
|
|
891
1054
|
- Numeric user ID, e.g., [unavatar.io/openstreetmap/98672](https://unavatar.io/openstreetmap/98672)
|
|
892
1055
|
- Username, e.g., [unavatar.io/openstreetmap/Terence%20Eden](https://unavatar.io/openstreetmap/Terence%20Eden)
|
|
893
1056
|
|
|
1057
|
+
### osu!
|
|
1058
|
+
|
|
1059
|
+
Get any osu! player's profile picture by their username or user ID.
|
|
1060
|
+
|
|
1061
|
+
Available inputs:
|
|
1062
|
+
|
|
1063
|
+
- Username, e.g., [unavatar.io/osu/peppy](https://unavatar.io/osu/peppy)
|
|
1064
|
+
- User ID, e.g., [unavatar.io/osu/7562902](https://unavatar.io/osu/7562902)
|
|
1065
|
+
|
|
894
1066
|
### Patreon
|
|
895
1067
|
|
|
896
1068
|
Get any Patreon creator's profile picture by their username.
|
|
@@ -967,6 +1139,25 @@ Get any Revolut user's profile picture by their Revolut.Me username.
|
|
|
967
1139
|
|
|
968
1140
|
e.g., [unavatar.io/revolut/midudev](https://unavatar.io/revolut/midudev)
|
|
969
1141
|
|
|
1142
|
+
### Roblox
|
|
1143
|
+
|
|
1144
|
+
Get any Roblox player's avatar headshot by username or user ID.
|
|
1145
|
+
|
|
1146
|
+
The input supports a URI format `type:id`.
|
|
1147
|
+
|
|
1148
|
+
When no type is provided, it defaults to `username`.
|
|
1149
|
+
|
|
1150
|
+
Available inputs:
|
|
1151
|
+
|
|
1152
|
+
- `username` (default): [unavatar.io/roblox/builderman](https://unavatar.io/roblox/builderman)
|
|
1153
|
+
- `id`: [unavatar.io/roblox/id:156](https://unavatar.io/roblox/id:156)
|
|
1154
|
+
|
|
1155
|
+
### Sketchfab
|
|
1156
|
+
|
|
1157
|
+
Get any Sketchfab creator's profile picture by their username.
|
|
1158
|
+
|
|
1159
|
+
e.g., [unavatar.io/sketchfab/nasa](https://unavatar.io/sketchfab/nasa)
|
|
1160
|
+
|
|
970
1161
|
### Snapchat
|
|
971
1162
|
|
|
972
1163
|
Get any Snapchat user's profile picture by their username.
|
|
@@ -979,6 +1170,12 @@ Get any SoundCloud artist's profile picture by their username.
|
|
|
979
1170
|
|
|
980
1171
|
e.g., [unavatar.io/soundcloud/gorillaz](https://unavatar.io/soundcloud/gorillaz)
|
|
981
1172
|
|
|
1173
|
+
### Speedrun.com
|
|
1174
|
+
|
|
1175
|
+
Get any Speedrun.com runner's profile picture by their username.
|
|
1176
|
+
|
|
1177
|
+
e.g., [unavatar.io/speedrun/cheese](https://unavatar.io/speedrun/cheese)
|
|
1178
|
+
|
|
982
1179
|
### Spotify
|
|
983
1180
|
|
|
984
1181
|
Get artwork for any Spotify entity — users, artists, albums, playlists, shows, episodes, or tracks. Look up by username or Spotify ID.
|
|
@@ -1023,6 +1220,12 @@ Get any Strava athlete's profile picture by their username or athlete ID.
|
|
|
1023
1220
|
|
|
1024
1221
|
e.g., [unavatar.io/strava/kikobeats](https://unavatar.io/strava/kikobeats)
|
|
1025
1222
|
|
|
1223
|
+
### Stripe
|
|
1224
|
+
|
|
1225
|
+
Get any Stripe user's profile picture by their username.
|
|
1226
|
+
|
|
1227
|
+
e.g., [unavatar.io/stripe/levelsio](https://unavatar.io/stripe/levelsio)
|
|
1228
|
+
|
|
1026
1229
|
### Substack
|
|
1027
1230
|
|
|
1028
1231
|
Get any Substack author's profile picture by their publication username.
|
|
@@ -1097,6 +1300,12 @@ Get any Vimeo user's profile picture by their username.
|
|
|
1097
1300
|
|
|
1098
1301
|
e.g., [unavatar.io/vimeo/ladieswithlenses](https://unavatar.io/vimeo/ladieswithlenses)
|
|
1099
1302
|
|
|
1303
|
+
### Wattpad
|
|
1304
|
+
|
|
1305
|
+
Get any Wattpad writer's profile picture by their username.
|
|
1306
|
+
|
|
1307
|
+
e.g., [unavatar.io/wattpad/Wattpad](https://unavatar.io/wattpad/Wattpad)
|
|
1308
|
+
|
|
1100
1309
|
### Weibo
|
|
1101
1310
|
|
|
1102
1311
|
Get any Weibo user's profile picture by numeric user ID or screen name.
|
|
@@ -1165,14 +1374,14 @@ However, you can get a [json](https://unavatar.io/docs#json) as response payload
|
|
|
1165
1374
|
|
|
1166
1375
|
When an endpoint returns JSON, the shape is predictable so you can parse it reliably in your app:
|
|
1167
1376
|
|
|
1168
|
-
| Field | Type | Present in
|
|
1169
|
-
| --------- | -------------- |
|
|
1170
|
-
| `status` | `string` | all JSON responses
|
|
1171
|
-
| `message` | `string` | all JSON responses
|
|
1172
|
-
| `data` | `object` | `success`
|
|
1173
|
-
| `code` | `string` | `fail`, `error`
|
|
1174
|
-
| `more` | `string (URL)` | most `fail
|
|
1175
|
-
| `report` | `string` | some `error` responses
|
|
1377
|
+
| Field | Type | Present in | Description |
|
|
1378
|
+
| --------- | -------------- | ----------------------------- | ------------------------------------------------ |
|
|
1379
|
+
| `status` | `string` | all JSON responses | One of: `success`, `fail`, `error`. |
|
|
1380
|
+
| `message` | `string` | all JSON responses | Human-readable summary for display/logging. |
|
|
1381
|
+
| `data` | `object` | `success` | Response payload for successful requests. |
|
|
1382
|
+
| `code` | `string` | `fail`, `error` | Stable machine-readable error code. |
|
|
1383
|
+
| `more` | `string (URL)` | most `fail`/`error` responses | Documentation URL with troubleshooting details. |
|
|
1384
|
+
| `report` | `string` | some `error` responses | Support contact channel (for example `mailto:`). |
|
|
1176
1385
|
|
|
1177
1386
|
## Response Headers
|
|
1178
1387
|
|
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.71.
|
|
5
|
+
"version": "3.71.3",
|
|
6
6
|
"main": "src/index.js",
|
|
7
7
|
"exports": {
|
|
8
8
|
".": "./src/index.js",
|