@unavatar/core 3.72.2 → 3.72.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 +201 -3
- package/package.json +3 -3
- package/src/util/reachable-url.js +71 -8
package/README.md
CHANGED
|
@@ -128,7 +128,7 @@
|
|
|
128
128
|
|
|
129
129
|
---
|
|
130
130
|
|
|
131
|
-
Last updated on November
|
|
131
|
+
Last updated on November 12, 2026
|
|
132
132
|
|
|
133
133
|

|
|
134
134
|
|
|
@@ -597,6 +597,8 @@ Available inputs:
|
|
|
597
597
|
- by song name: [unavatar.io/apple-music/song:harder%20better%20faster%20stronger](https://unavatar.io/apple-music/song:harder%20better%20faster%20stronger)
|
|
598
598
|
- by song ID: [unavatar.io/apple-music/song:697195787](https://unavatar.io/apple-music/song:697195787)
|
|
599
599
|
|
|
600
|
+
Try lookups live on the [Apple Music artwork API](https://unavatar.io/apple-music) page.
|
|
601
|
+
|
|
600
602
|
### Apple Store
|
|
601
603
|
|
|
602
604
|
Get the icon for any iOS or macOS app on the App Store by numeric Apple ID.
|
|
@@ -610,18 +612,24 @@ Available inputs:
|
|
|
610
612
|
- `id` (default): [unavatar.io/apple-store/id:529479190](https://unavatar.io/apple-store/id:529479190) or [unavatar.io/apple-store/id:6474323148@es](https://unavatar.io/apple-store/id:6474323148@es)
|
|
611
613
|
- `name`: [unavatar.io/apple-store/name:pokemon%20go](https://unavatar.io/apple-store/name:pokemon%20go)
|
|
612
614
|
|
|
615
|
+
Try lookups live on the [Apple Store app icon API](https://unavatar.io/apple-store) page.
|
|
616
|
+
|
|
613
617
|
### Behance
|
|
614
618
|
|
|
615
619
|
Get any Behance user's profile picture by their username.
|
|
616
620
|
|
|
617
621
|
e.g., [unavatar.io/behance/vitormatosinhos](https://unavatar.io/behance/vitormatosinhos)
|
|
618
622
|
|
|
623
|
+
Try lookups live on the [Behance avatar API](https://unavatar.io/behance) page.
|
|
624
|
+
|
|
619
625
|
### Bilibili
|
|
620
626
|
|
|
621
627
|
Get any Bilibili user's profile picture by their numeric member ID.
|
|
622
628
|
|
|
623
629
|
e.g., [unavatar.io/bilibili/2](https://unavatar.io/bilibili/2)
|
|
624
630
|
|
|
631
|
+
Try lookups live on the [Bilibili avatar API](https://unavatar.io/bilibili) page.
|
|
632
|
+
|
|
625
633
|
### BIMI
|
|
626
634
|
|
|
627
635
|
Get the official brand logo published via Brand Indicators for Message Identification (BIMI) for a domain or email address.
|
|
@@ -631,12 +639,16 @@ Available inputs:
|
|
|
631
639
|
- Domain, e.g., [unavatar.io/bimi/cnn.com](https://unavatar.io/bimi/cnn.com)
|
|
632
640
|
- Email address, e.g., [unavatar.io/bimi/support@ebay.com](https://unavatar.io/bimi/support@ebay.com)
|
|
633
641
|
|
|
642
|
+
Try lookups live on the [BIMI site icon API](https://unavatar.io/bimi) page.
|
|
643
|
+
|
|
634
644
|
### Bitbucket
|
|
635
645
|
|
|
636
646
|
Get any Bitbucket workspace's avatar by its workspace slug, which matches the owner's username.
|
|
637
647
|
|
|
638
648
|
e.g., [unavatar.io/bitbucket/atlassian](https://unavatar.io/bitbucket/atlassian)
|
|
639
649
|
|
|
650
|
+
Try lookups live on the [Bitbucket avatar API](https://unavatar.io/bitbucket) page.
|
|
651
|
+
|
|
640
652
|
### Bluesky
|
|
641
653
|
|
|
642
654
|
Get any Bluesky user's profile picture by their handle. Domain-style handles are supported.
|
|
@@ -646,54 +658,72 @@ Available inputs:
|
|
|
646
658
|
- User handle, e.g., [unavatar.io/bluesky/pfrazee.com](https://unavatar.io/bluesky/pfrazee.com)
|
|
647
659
|
- Domain handle, e.g., [unavatar.io/bluesky/bsky.app](https://unavatar.io/bluesky/bsky.app)
|
|
648
660
|
|
|
661
|
+
Try lookups live on the [Bluesky avatar API](https://unavatar.io/bluesky) page.
|
|
662
|
+
|
|
649
663
|
### Buy Me a Coffee
|
|
650
664
|
|
|
651
665
|
Get any Buy Me a Coffee creator's profile picture by their username.
|
|
652
666
|
|
|
653
667
|
e.g., [unavatar.io/buymeacoffee/mikebarnesdrums](https://unavatar.io/buymeacoffee/mikebarnesdrums)
|
|
654
668
|
|
|
669
|
+
Try lookups live on the [Buy Me a Coffee avatar API](https://unavatar.io/buymeacoffee) page.
|
|
670
|
+
|
|
655
671
|
### Cash App
|
|
656
672
|
|
|
657
673
|
Get any Cash App user's profile picture by their Cashtag.
|
|
658
674
|
|
|
659
675
|
e.g., [unavatar.io/cashapp/ninja](https://unavatar.io/cashapp/ninja)
|
|
660
676
|
|
|
677
|
+
Try lookups live on the [Cash App avatar API](https://unavatar.io/cashapp) page.
|
|
678
|
+
|
|
661
679
|
### Chess.com
|
|
662
680
|
|
|
663
681
|
Get any Chess.com player's profile picture by their username.
|
|
664
682
|
|
|
665
683
|
e.g., [unavatar.io/chesscom/hikaru](https://unavatar.io/chesscom/hikaru)
|
|
666
684
|
|
|
685
|
+
Try lookups live on the [Chess.com avatar API](https://unavatar.io/chesscom) page.
|
|
686
|
+
|
|
667
687
|
### Codeforces
|
|
668
688
|
|
|
669
689
|
Get any Codeforces user's profile picture by their handle.
|
|
670
690
|
|
|
671
691
|
e.g., [unavatar.io/codeforces/tourist](https://unavatar.io/codeforces/tourist)
|
|
672
692
|
|
|
693
|
+
Try lookups live on the [Codeforces avatar API](https://unavatar.io/codeforces) page.
|
|
694
|
+
|
|
673
695
|
### CodePen
|
|
674
696
|
|
|
675
697
|
Get any CodePen user's profile picture by their username.
|
|
676
698
|
|
|
677
699
|
e.g., [unavatar.io/codepen/chriscoyier](https://unavatar.io/codepen/chriscoyier)
|
|
678
700
|
|
|
701
|
+
Try lookups live on the [CodePen avatar API](https://unavatar.io/codepen) page.
|
|
702
|
+
|
|
679
703
|
### Cults3D
|
|
680
704
|
|
|
681
705
|
Get any Cults3D creator's profile picture by username.
|
|
682
706
|
|
|
683
707
|
e.g., [unavatar.io/cults3d/RaBros](https://unavatar.io/cults3d/RaBros)
|
|
684
708
|
|
|
709
|
+
Try lookups live on the [Cults3D avatar API](https://unavatar.io/cults3d) page.
|
|
710
|
+
|
|
685
711
|
### Cursor
|
|
686
712
|
|
|
687
713
|
Get any Cursor user's profile picture by their username.
|
|
688
714
|
|
|
689
715
|
e.g., [unavatar.io/cursor/leerob](https://unavatar.io/cursor/leerob)
|
|
690
716
|
|
|
717
|
+
Try lookups live on the [Cursor avatar API](https://unavatar.io/cursor) page.
|
|
718
|
+
|
|
691
719
|
### Dailymotion
|
|
692
720
|
|
|
693
721
|
Get any Dailymotion user's or channel's avatar by their username.
|
|
694
722
|
|
|
695
723
|
e.g., [unavatar.io/dailymotion/dailymotion](https://unavatar.io/dailymotion/dailymotion)
|
|
696
724
|
|
|
725
|
+
Try lookups live on the [Dailymotion avatar API](https://unavatar.io/dailymotion) page.
|
|
726
|
+
|
|
697
727
|
### Deezer
|
|
698
728
|
|
|
699
729
|
Get artwork for any Deezer artist, album, playlist, or track by ID.
|
|
@@ -709,6 +739,8 @@ Available inputs:
|
|
|
709
739
|
- `playlist`: [unavatar.io/deezer/playlist:908622995](https://unavatar.io/deezer/playlist:908622995)
|
|
710
740
|
- `track`: [unavatar.io/deezer/track:3135556](https://unavatar.io/deezer/track:3135556)
|
|
711
741
|
|
|
742
|
+
Try lookups live on the [Deezer artwork API](https://unavatar.io/deezer) page.
|
|
743
|
+
|
|
712
744
|
### DEV
|
|
713
745
|
|
|
714
746
|
Get any DEV Community member's or organization's profile picture by their username or organization slug.
|
|
@@ -718,12 +750,16 @@ Available inputs:
|
|
|
718
750
|
- Username, e.g., [unavatar.io/devto/ben](https://unavatar.io/devto/ben)
|
|
719
751
|
- Organization, e.g., [unavatar.io/devto/devteam](https://unavatar.io/devto/devteam)
|
|
720
752
|
|
|
753
|
+
Try lookups live on the [DEV avatar API](https://unavatar.io/devto) page.
|
|
754
|
+
|
|
721
755
|
### DeviantArt
|
|
722
756
|
|
|
723
757
|
Get any DeviantArt user's profile picture by their username.
|
|
724
758
|
|
|
725
759
|
e.g., [unavatar.io/deviantart/spyed](https://unavatar.io/deviantart/spyed)
|
|
726
760
|
|
|
761
|
+
Try lookups live on the [DeviantArt avatar API](https://unavatar.io/deviantart) page.
|
|
762
|
+
|
|
727
763
|
### Discord
|
|
728
764
|
|
|
729
765
|
Get a Discord server's icon by server name or server ID.
|
|
@@ -733,15 +769,19 @@ Available inputs:
|
|
|
733
769
|
- Server name, e.g., [unavatar.io/discord/lilnasx](https://unavatar.io/discord/lilnasx)
|
|
734
770
|
- Server ID, e.g., [unavatar.io/discord/uW6Hyf3E9r](https://unavatar.io/discord/uW6Hyf3E9r)
|
|
735
771
|
|
|
772
|
+
Try lookups live on the [Discord server icon API](https://unavatar.io/discord) page.
|
|
773
|
+
|
|
736
774
|
### Docker Hub
|
|
737
775
|
|
|
738
776
|
Get any Docker Hub user's profile picture by username or organization.
|
|
739
777
|
|
|
740
778
|
e.g., [unavatar.io/dockerhub/tensorflow](https://unavatar.io/dockerhub/tensorflow)
|
|
741
779
|
|
|
780
|
+
Try lookups live on the [Docker Hub avatar API](https://unavatar.io/dockerhub) page.
|
|
781
|
+
|
|
742
782
|
### Domain
|
|
743
783
|
|
|
744
|
-
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.
|
|
784
|
+
Retrieve [logos and favicons from any hostname](https://unavatar.io/domain) 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.
|
|
745
785
|
|
|
746
786
|
e.g., [unavatar.io/domain/microlink.io](https://unavatar.io/domain/microlink.io)
|
|
747
787
|
|
|
@@ -751,21 +791,27 @@ Get any Dribbble designer's profile picture by their username.
|
|
|
751
791
|
|
|
752
792
|
e.g., [unavatar.io/dribbble/omidnikrah](https://unavatar.io/dribbble/omidnikrah)
|
|
753
793
|
|
|
794
|
+
Try lookups live on the [Dribbble avatar API](https://unavatar.io/dribbble) page.
|
|
795
|
+
|
|
754
796
|
### DuckDuckGo
|
|
755
797
|
|
|
756
798
|
Get the favicon or logo for any domain via DuckDuckGo's icon service. Useful as a fallback when a domain doesn't expose its favicon directly.
|
|
757
799
|
|
|
758
800
|
e.g., [unavatar.io/duckduckgo/microsoft.com](https://unavatar.io/duckduckgo/microsoft.com)
|
|
759
801
|
|
|
802
|
+
Try lookups live on the [DuckDuckGo site icon API](https://unavatar.io/duckduckgo) page.
|
|
803
|
+
|
|
760
804
|
### Duolingo
|
|
761
805
|
|
|
762
806
|
Get any Duolingo learner's avatar by their username.
|
|
763
807
|
|
|
764
808
|
e.g., [unavatar.io/duolingo/luis](https://unavatar.io/duolingo/luis)
|
|
765
809
|
|
|
810
|
+
Try lookups live on the [Duolingo avatar API](https://unavatar.io/duolingo) page.
|
|
811
|
+
|
|
766
812
|
### Email
|
|
767
813
|
|
|
768
|
-
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.
|
|
814
|
+
Resolve user avatars [from an email address](https://unavatar.io/email) 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.
|
|
769
815
|
|
|
770
816
|
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.
|
|
771
817
|
|
|
@@ -795,6 +841,8 @@ Available inputs:
|
|
|
795
841
|
- ENS name, e.g., [unavatar.io/ens/vitalik.eth](https://unavatar.io/ens/vitalik.eth)
|
|
796
842
|
- Subname, e.g., [unavatar.io/ens/jesse.base.eth](https://unavatar.io/ens/jesse.base.eth)
|
|
797
843
|
|
|
844
|
+
Try lookups live on the [ENS avatar API](https://unavatar.io/ens) page.
|
|
845
|
+
|
|
798
846
|
### Facebook
|
|
799
847
|
|
|
800
848
|
Get any Facebook user, page, or group profile picture by their username or ID.
|
|
@@ -804,12 +852,16 @@ Available inputs:
|
|
|
804
852
|
- Username, e.g., [unavatar.io/facebook/zuck](https://unavatar.io/facebook/zuck)
|
|
805
853
|
- Page, e.g., [unavatar.io/facebook/windtodayco](https://unavatar.io/facebook/windtodayco)
|
|
806
854
|
|
|
855
|
+
Try lookups live on the [Facebook avatar API](https://unavatar.io/facebook) page.
|
|
856
|
+
|
|
807
857
|
### Farcaster
|
|
808
858
|
|
|
809
859
|
Get any Farcaster user's profile picture by their username.
|
|
810
860
|
|
|
811
861
|
e.g., [unavatar.io/farcaster/dwr](https://unavatar.io/farcaster/dwr)
|
|
812
862
|
|
|
863
|
+
Try lookups live on the [Farcaster avatar API](https://unavatar.io/farcaster) page.
|
|
864
|
+
|
|
813
865
|
### Flickr
|
|
814
866
|
|
|
815
867
|
Get any Flickr user's buddy icon or group icon by username or group slug.
|
|
@@ -823,12 +875,16 @@ Available inputs:
|
|
|
823
875
|
- `user` (default): [unavatar.io/flickr/user:elizabethgadd](https://unavatar.io/flickr/user:elizabethgadd)
|
|
824
876
|
- `group`: [unavatar.io/flickr/group:allthingsearthy](https://unavatar.io/flickr/group:allthingsearthy)
|
|
825
877
|
|
|
878
|
+
Try lookups live on the [Flickr avatar API](https://unavatar.io/flickr) page.
|
|
879
|
+
|
|
826
880
|
### Gitee
|
|
827
881
|
|
|
828
882
|
Get any Gitee user's profile picture by their username.
|
|
829
883
|
|
|
830
884
|
e.g., [unavatar.io/gitee/y_project](https://unavatar.io/gitee/y_project)
|
|
831
885
|
|
|
886
|
+
Try lookups live on the [Gitee avatar API](https://unavatar.io/gitee) page.
|
|
887
|
+
|
|
832
888
|
### GitHub
|
|
833
889
|
|
|
834
890
|
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.
|
|
@@ -839,6 +895,8 @@ Available inputs:
|
|
|
839
895
|
- Organization, e.g., [unavatar.io/github/vercel](https://unavatar.io/github/vercel)
|
|
840
896
|
- Email address, e.g., [unavatar.io/github/sindresorhus@gmail.com](https://unavatar.io/github/sindresorhus@gmail.com)
|
|
841
897
|
|
|
898
|
+
Try lookups live on the [GitHub avatar API](https://unavatar.io/github) page.
|
|
899
|
+
|
|
842
900
|
### GitLab
|
|
843
901
|
|
|
844
902
|
Get any GitLab user or organization's profile picture by their username.
|
|
@@ -848,6 +906,8 @@ Available inputs:
|
|
|
848
906
|
- User, e.g., [unavatar.io/gitlab/sytses](https://unavatar.io/gitlab/sytses)
|
|
849
907
|
- Organization, e.g., [unavatar.io/gitlab/inkscape](https://unavatar.io/gitlab/inkscape)
|
|
850
908
|
|
|
909
|
+
Try lookups live on the [GitLab avatar API](https://unavatar.io/gitlab) page.
|
|
910
|
+
|
|
851
911
|
### Goodreads
|
|
852
912
|
|
|
853
913
|
Get any Goodreads reader's or author's photo by username, user ID, or author ID.
|
|
@@ -861,12 +921,16 @@ Available inputs:
|
|
|
861
921
|
- `user` (default): [unavatar.io/goodreads/otis](https://unavatar.io/goodreads/otis) or [unavatar.io/goodreads/1](https://unavatar.io/goodreads/1)
|
|
862
922
|
- `author`: [unavatar.io/goodreads/author:4](https://unavatar.io/goodreads/author:4)
|
|
863
923
|
|
|
924
|
+
Try lookups live on the [Goodreads avatar API](https://unavatar.io/goodreads) page.
|
|
925
|
+
|
|
864
926
|
### Google
|
|
865
927
|
|
|
866
928
|
Get the favicon or logo for any domain using Google's favicon service.
|
|
867
929
|
|
|
868
930
|
e.g., [unavatar.io/google/stremio.com](https://unavatar.io/google/stremio.com)
|
|
869
931
|
|
|
932
|
+
Try lookups live on the [Google site icon API](https://unavatar.io/google) page.
|
|
933
|
+
|
|
870
934
|
### Google Play
|
|
871
935
|
|
|
872
936
|
Get the icon for any Android app on Google Play by its package name, or get a developer icon by numeric ID.
|
|
@@ -880,6 +944,8 @@ Available inputs:
|
|
|
880
944
|
- `app` (default): [unavatar.io/google-play/app:com.devolver.grispaid](https://unavatar.io/google-play/app:com.devolver.grispaid)
|
|
881
945
|
- `dev`: [unavatar.io/google-play/dev:6592603558263828430](https://unavatar.io/google-play/dev:6592603558263828430)
|
|
882
946
|
|
|
947
|
+
Try lookups live on the [Google Play app icon API](https://unavatar.io/google-play) page.
|
|
948
|
+
|
|
883
949
|
### Gravatar
|
|
884
950
|
|
|
885
951
|
Resolve avatars via Gravatar using a plain email or a precomputed hash. Emails are trimmed, lowercased, and hashed with SHA-256 for the Gravatar URL; 64-hex SHA-256 and 32-hex MD5 values are passed through (normalized to lowercase).
|
|
@@ -894,18 +960,24 @@ When you pass an email address directly in the URL, it is visible in plain text
|
|
|
894
960
|
|
|
895
961
|
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.
|
|
896
962
|
|
|
963
|
+
Try lookups live on the [Gravatar avatar API](https://unavatar.io/gravatar) page.
|
|
964
|
+
|
|
897
965
|
### Gumroad
|
|
898
966
|
|
|
899
967
|
Get any Gumroad creator's profile picture by their username.
|
|
900
968
|
|
|
901
969
|
e.g., [unavatar.io/gumroad/sahil](https://unavatar.io/gumroad/sahil)
|
|
902
970
|
|
|
971
|
+
Try lookups live on the [Gumroad avatar API](https://unavatar.io/gumroad) page.
|
|
972
|
+
|
|
903
973
|
### Hevy
|
|
904
974
|
|
|
905
975
|
Get any Hevy user's profile picture by their username.
|
|
906
976
|
|
|
907
977
|
e.g., [unavatar.io/hevy/om_giigo](https://unavatar.io/hevy/om_giigo)
|
|
908
978
|
|
|
979
|
+
Try lookups live on the [Hevy avatar API](https://unavatar.io/hevy) page.
|
|
980
|
+
|
|
909
981
|
### Hugging Face
|
|
910
982
|
|
|
911
983
|
Get profile pictures for Hugging Face users or organizations by their handle.
|
|
@@ -915,48 +987,64 @@ Available inputs:
|
|
|
915
987
|
- User, e.g., [unavatar.io/huggingface/jonatasgrosman](https://unavatar.io/huggingface/jonatasgrosman)
|
|
916
988
|
- Organization, e.g., [unavatar.io/huggingface/nvidia](https://unavatar.io/huggingface/nvidia)
|
|
917
989
|
|
|
990
|
+
Try lookups live on the [Hugging Face avatar API](https://unavatar.io/huggingface) page.
|
|
991
|
+
|
|
918
992
|
### Instagram
|
|
919
993
|
|
|
920
994
|
Get any Instagram user's profile picture by their username. No authentication or API tokens needed — just pass the username.
|
|
921
995
|
|
|
922
996
|
e.g., [unavatar.io/instagram/willsmith](https://unavatar.io/instagram/willsmith)
|
|
923
997
|
|
|
998
|
+
Try lookups live on the [Instagram avatar API](https://unavatar.io/instagram) page.
|
|
999
|
+
|
|
924
1000
|
### Juejin
|
|
925
1001
|
|
|
926
1002
|
Get any Juejin user's profile picture by their numeric user ID.
|
|
927
1003
|
|
|
928
1004
|
e.g., [unavatar.io/juejin/1556564194374926](https://unavatar.io/juejin/1556564194374926)
|
|
929
1005
|
|
|
1006
|
+
Try lookups live on the [Juejin avatar API](https://unavatar.io/juejin) page.
|
|
1007
|
+
|
|
930
1008
|
### Kaggle
|
|
931
1009
|
|
|
932
1010
|
Get any Kaggle user's profile picture by their username.
|
|
933
1011
|
|
|
934
1012
|
e.g., [unavatar.io/kaggle/jhoward](https://unavatar.io/kaggle/jhoward)
|
|
935
1013
|
|
|
1014
|
+
Try lookups live on the [Kaggle avatar API](https://unavatar.io/kaggle) page.
|
|
1015
|
+
|
|
936
1016
|
### Keybase
|
|
937
1017
|
|
|
938
1018
|
Get any Keybase user's profile picture by their username.
|
|
939
1019
|
|
|
940
1020
|
e.g., [unavatar.io/keybase/chris](https://unavatar.io/keybase/chris)
|
|
941
1021
|
|
|
1022
|
+
Try lookups live on the [Keybase avatar API](https://unavatar.io/keybase) page.
|
|
1023
|
+
|
|
942
1024
|
### Kick
|
|
943
1025
|
|
|
944
1026
|
Get any Kick streamer's profile picture by their username.
|
|
945
1027
|
|
|
946
1028
|
e.g., [unavatar.io/kick/xqc](https://unavatar.io/kick/xqc)
|
|
947
1029
|
|
|
1030
|
+
Try lookups live on the [Kick avatar API](https://unavatar.io/kick) page.
|
|
1031
|
+
|
|
948
1032
|
### Ko-fi
|
|
949
1033
|
|
|
950
1034
|
Get any Ko-fi page's profile picture by the creator username.
|
|
951
1035
|
|
|
952
1036
|
e.g., [unavatar.io/ko-fi/geekshock](https://unavatar.io/ko-fi/geekshock)
|
|
953
1037
|
|
|
1038
|
+
Try lookups live on the [Ko-fi avatar API](https://unavatar.io/ko-fi) page.
|
|
1039
|
+
|
|
954
1040
|
### Lemmy
|
|
955
1041
|
|
|
956
1042
|
Get any Lemmy user's avatar from their home instance by their `user@instance` handle.
|
|
957
1043
|
|
|
958
1044
|
e.g., [unavatar.io/lemmy/ruud@lemmy.world](https://unavatar.io/lemmy/ruud@lemmy.world)
|
|
959
1045
|
|
|
1046
|
+
Try lookups live on the [Lemmy avatar API](https://unavatar.io/lemmy) page.
|
|
1047
|
+
|
|
960
1048
|
### Libravatar
|
|
961
1049
|
|
|
962
1050
|
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.
|
|
@@ -966,6 +1054,8 @@ Available inputs:
|
|
|
966
1054
|
- MD5 hash, e.g., [unavatar.io/libravatar/7cc352a2907216992f0f16d2af50b070](https://unavatar.io/libravatar/7cc352a2907216992f0f16d2af50b070)
|
|
967
1055
|
- SHA-256 hash, e.g., [unavatar.io/libravatar/857915e8681217376523fa2c4653a499a7dc6826197b077d35fc029d7c38bda1](https://unavatar.io/libravatar/857915e8681217376523fa2c4653a499a7dc6826197b077d35fc029d7c38bda1)
|
|
968
1056
|
|
|
1057
|
+
Try lookups live on the [Libravatar avatar API](https://unavatar.io/libravatar) page.
|
|
1058
|
+
|
|
969
1059
|
### LinkedIn
|
|
970
1060
|
|
|
971
1061
|
Get any LinkedIn user or company profile picture by username or company slug.
|
|
@@ -977,30 +1067,40 @@ Available inputs:
|
|
|
977
1067
|
- `user` (default): [unavatar.io/linkedin/user:wesbos](https://unavatar.io/linkedin/user:wesbos)
|
|
978
1068
|
- `company`: [unavatar.io/linkedin/company:microlinkhq](https://unavatar.io/linkedin/company:microlinkhq)
|
|
979
1069
|
|
|
1070
|
+
Try lookups live on the [LinkedIn avatar API](https://unavatar.io/linkedin) page.
|
|
1071
|
+
|
|
980
1072
|
### Mastodon
|
|
981
1073
|
|
|
982
1074
|
Get any Mastodon user's profile picture from any instance using the public account lookup API. Pass the handle as `user@server` so the account resolves on the correct home instance.
|
|
983
1075
|
|
|
984
1076
|
e.g., [unavatar.io/mastodon/kpwags@hachyderm.io](https://unavatar.io/mastodon/kpwags@hachyderm.io)
|
|
985
1077
|
|
|
1078
|
+
Try lookups live on the [Mastodon avatar API](https://unavatar.io/mastodon) page.
|
|
1079
|
+
|
|
986
1080
|
### Matrix
|
|
987
1081
|
|
|
988
1082
|
Get any Matrix user's avatar by their Matrix ID, resolved from their homeserver.
|
|
989
1083
|
|
|
990
1084
|
e.g., [unavatar.io/matrix/@matthew:matrix.org](https://unavatar.io/matrix/@matthew:matrix.org)
|
|
991
1085
|
|
|
1086
|
+
Try lookups live on the [Matrix avatar API](https://unavatar.io/matrix) page.
|
|
1087
|
+
|
|
992
1088
|
### Medium
|
|
993
1089
|
|
|
994
1090
|
Get any Medium author's profile picture by their username.
|
|
995
1091
|
|
|
996
1092
|
e.g., [unavatar.io/medium/juancalmaraz](https://unavatar.io/medium/juancalmaraz)
|
|
997
1093
|
|
|
1094
|
+
Try lookups live on the [Medium avatar API](https://unavatar.io/medium) page.
|
|
1095
|
+
|
|
998
1096
|
### Microlink
|
|
999
1097
|
|
|
1000
1098
|
Extract the logo or representative image from any URL. The page is rendered and the best available image is selected — useful for getting brand logos from any website.
|
|
1001
1099
|
|
|
1002
1100
|
e.g., [unavatar.io/microlink/microlink.io](https://unavatar.io/microlink/microlink.io)
|
|
1003
1101
|
|
|
1102
|
+
Try lookups live on the [Microlink site icon API](https://unavatar.io/microlink) page.
|
|
1103
|
+
|
|
1004
1104
|
### Minecraft
|
|
1005
1105
|
|
|
1006
1106
|
Get any Minecraft Java Edition player's face by their username or UUID.
|
|
@@ -1010,42 +1110,56 @@ Available inputs:
|
|
|
1010
1110
|
- Username, e.g., [unavatar.io/minecraft/notch](https://unavatar.io/minecraft/notch)
|
|
1011
1111
|
- UUID, e.g., [unavatar.io/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5](https://unavatar.io/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5)
|
|
1012
1112
|
|
|
1113
|
+
Try lookups live on the [Minecraft avatar API](https://unavatar.io/minecraft) page.
|
|
1114
|
+
|
|
1013
1115
|
### Mixcloud
|
|
1014
1116
|
|
|
1015
1117
|
Get any Mixcloud user's profile picture by their username.
|
|
1016
1118
|
|
|
1017
1119
|
e.g., [unavatar.io/mixcloud/spartacus](https://unavatar.io/mixcloud/spartacus)
|
|
1018
1120
|
|
|
1121
|
+
Try lookups live on the [Mixcloud avatar API](https://unavatar.io/mixcloud) page.
|
|
1122
|
+
|
|
1019
1123
|
### NetEase Music
|
|
1020
1124
|
|
|
1021
1125
|
Get any NetEase Music user's profile picture by their numeric user ID.
|
|
1022
1126
|
|
|
1023
1127
|
e.g., [unavatar.io/netease-music/32953014](https://unavatar.io/netease-music/32953014)
|
|
1024
1128
|
|
|
1129
|
+
Try lookups live on the [NetEase Music avatar API](https://unavatar.io/netease-music) page.
|
|
1130
|
+
|
|
1025
1131
|
### note
|
|
1026
1132
|
|
|
1027
1133
|
Get any note creator's profile picture by their note ID.
|
|
1028
1134
|
|
|
1029
1135
|
e.g., [unavatar.io/note/info](https://unavatar.io/note/info)
|
|
1030
1136
|
|
|
1137
|
+
Try lookups live on the [note avatar API](https://unavatar.io/note) page.
|
|
1138
|
+
|
|
1031
1139
|
### npm
|
|
1032
1140
|
|
|
1033
1141
|
Get any npm user's profile picture by their username, including scoped handles.
|
|
1034
1142
|
|
|
1035
1143
|
e.g., [unavatar.io/npm/mafintosh](https://unavatar.io/npm/mafintosh)
|
|
1036
1144
|
|
|
1145
|
+
Try lookups live on the [npm avatar API](https://unavatar.io/npm) page.
|
|
1146
|
+
|
|
1037
1147
|
### OnlyFans
|
|
1038
1148
|
|
|
1039
1149
|
Get any OnlyFans creator's profile picture by their username.
|
|
1040
1150
|
|
|
1041
1151
|
e.g., [unavatar.io/onlyfans/amandaribas](https://unavatar.io/onlyfans/amandaribas)
|
|
1042
1152
|
|
|
1153
|
+
Try lookups live on the [OnlyFans avatar API](https://unavatar.io/onlyfans) page.
|
|
1154
|
+
|
|
1043
1155
|
### Open Collective
|
|
1044
1156
|
|
|
1045
1157
|
Get any Open Collective account's avatar by its slug, for collectives, organizations, and individuals.
|
|
1046
1158
|
|
|
1047
1159
|
e.g., [unavatar.io/opencollective/webpack](https://unavatar.io/opencollective/webpack)
|
|
1048
1160
|
|
|
1161
|
+
Try lookups live on the [Open Collective avatar API](https://unavatar.io/opencollective) page.
|
|
1162
|
+
|
|
1049
1163
|
### OpenStreetMap
|
|
1050
1164
|
|
|
1051
1165
|
Get any OpenStreetMap contributor's profile picture. Accepts either a numeric user ID or a username.
|
|
@@ -1055,6 +1169,8 @@ Available inputs:
|
|
|
1055
1169
|
- Numeric user ID, e.g., [unavatar.io/openstreetmap/98672](https://unavatar.io/openstreetmap/98672)
|
|
1056
1170
|
- Username, e.g., [unavatar.io/openstreetmap/Terence%20Eden](https://unavatar.io/openstreetmap/Terence%20Eden)
|
|
1057
1171
|
|
|
1172
|
+
Try lookups live on the [OpenStreetMap avatar API](https://unavatar.io/openstreetmap) page.
|
|
1173
|
+
|
|
1058
1174
|
### osu!
|
|
1059
1175
|
|
|
1060
1176
|
Get any osu! player's profile picture by their username or user ID.
|
|
@@ -1064,36 +1180,48 @@ Available inputs:
|
|
|
1064
1180
|
- Username, e.g., [unavatar.io/osu/peppy](https://unavatar.io/osu/peppy)
|
|
1065
1181
|
- User ID, e.g., [unavatar.io/osu/7562902](https://unavatar.io/osu/7562902)
|
|
1066
1182
|
|
|
1183
|
+
Try lookups live on the [osu! avatar API](https://unavatar.io/osu) page.
|
|
1184
|
+
|
|
1067
1185
|
### Patreon
|
|
1068
1186
|
|
|
1069
1187
|
Get any Patreon creator's profile picture by their username.
|
|
1070
1188
|
|
|
1071
1189
|
e.g., [unavatar.io/patreon/gametestro](https://unavatar.io/patreon/gametestro)
|
|
1072
1190
|
|
|
1191
|
+
Try lookups live on the [Patreon avatar API](https://unavatar.io/patreon) page.
|
|
1192
|
+
|
|
1073
1193
|
### PayPal
|
|
1074
1194
|
|
|
1075
1195
|
Get any PayPal user's profile picture by their PayPal.Me username.
|
|
1076
1196
|
|
|
1077
1197
|
e.g., [unavatar.io/paypal/kikobeats](https://unavatar.io/paypal/kikobeats)
|
|
1078
1198
|
|
|
1199
|
+
Try lookups live on the [PayPal avatar API](https://unavatar.io/paypal) page.
|
|
1200
|
+
|
|
1079
1201
|
### Pinterest
|
|
1080
1202
|
|
|
1081
1203
|
Get any Pinterest user's profile picture by their username.
|
|
1082
1204
|
|
|
1083
1205
|
e.g., [unavatar.io/pinterest/ohjoy](https://unavatar.io/pinterest/ohjoy)
|
|
1084
1206
|
|
|
1207
|
+
Try lookups live on the [Pinterest avatar API](https://unavatar.io/pinterest) page.
|
|
1208
|
+
|
|
1085
1209
|
### Primal
|
|
1086
1210
|
|
|
1087
1211
|
Get any Primal user's profile picture by their username.
|
|
1088
1212
|
|
|
1089
1213
|
e.g., [unavatar.io/primal/jack](https://unavatar.io/primal/jack)
|
|
1090
1214
|
|
|
1215
|
+
Try lookups live on the [Primal avatar API](https://unavatar.io/primal) page.
|
|
1216
|
+
|
|
1091
1217
|
### Printables
|
|
1092
1218
|
|
|
1093
1219
|
Get any Printables user's profile picture by their username.
|
|
1094
1220
|
|
|
1095
1221
|
e.g., [unavatar.io/printables/DukeDoks](https://unavatar.io/printables/DukeDoks)
|
|
1096
1222
|
|
|
1223
|
+
Try lookups live on the [Printables avatar API](https://unavatar.io/printables) page.
|
|
1224
|
+
|
|
1097
1225
|
### Product Hunt
|
|
1098
1226
|
|
|
1099
1227
|
Get profile pictures for Product Hunt users or logos for Product Hunt products.
|
|
@@ -1107,24 +1235,32 @@ Available inputs:
|
|
|
1107
1235
|
- `user` (default): [unavatar.io/producthunt/rajiv_ayyangar](https://unavatar.io/producthunt/rajiv_ayyangar)
|
|
1108
1236
|
- `product`: [unavatar.io/producthunt/product:optimo](https://unavatar.io/producthunt/product:optimo)
|
|
1109
1237
|
|
|
1238
|
+
Try lookups live on the [Product Hunt avatar API](https://unavatar.io/producthunt) page.
|
|
1239
|
+
|
|
1110
1240
|
### PSN Profiles
|
|
1111
1241
|
|
|
1112
1242
|
Get any PlayStation Network user's profile picture by their PSN username.
|
|
1113
1243
|
|
|
1114
1244
|
e.g., [unavatar.io/psnprofiles/Duff85](https://unavatar.io/psnprofiles/Duff85)
|
|
1115
1245
|
|
|
1246
|
+
Try lookups live on the [PSN Profiles avatar API](https://unavatar.io/psnprofiles) page.
|
|
1247
|
+
|
|
1116
1248
|
### QQ
|
|
1117
1249
|
|
|
1118
1250
|
Get a QQ user's profile picture by their QQ number.
|
|
1119
1251
|
|
|
1120
1252
|
e.g., [unavatar.io/qq/10001](https://unavatar.io/qq/10001)
|
|
1121
1253
|
|
|
1254
|
+
Try lookups live on the [QQ avatar API](https://unavatar.io/qq) page.
|
|
1255
|
+
|
|
1122
1256
|
### Raycast
|
|
1123
1257
|
|
|
1124
1258
|
Get any Raycast user's profile picture by their username.
|
|
1125
1259
|
|
|
1126
1260
|
e.g., [unavatar.io/raycast/peduarte](https://unavatar.io/raycast/peduarte)
|
|
1127
1261
|
|
|
1262
|
+
Try lookups live on the [Raycast avatar API](https://unavatar.io/raycast) page.
|
|
1263
|
+
|
|
1128
1264
|
### Reddit
|
|
1129
1265
|
|
|
1130
1266
|
Get any Reddit user's avatar by their username.
|
|
@@ -1134,12 +1270,16 @@ Available inputs:
|
|
|
1134
1270
|
- Username, e.g., [unavatar.io/reddit/thisisbillgates](https://unavatar.io/reddit/thisisbillgates)
|
|
1135
1271
|
- Organization, e.g., [unavatar.io/reddit/nasa](https://unavatar.io/reddit/nasa)
|
|
1136
1272
|
|
|
1273
|
+
Try lookups live on the [Reddit avatar API](https://unavatar.io/reddit) page.
|
|
1274
|
+
|
|
1137
1275
|
### Revolut
|
|
1138
1276
|
|
|
1139
1277
|
Get any Revolut user's profile picture by their Revolut.Me username.
|
|
1140
1278
|
|
|
1141
1279
|
e.g., [unavatar.io/revolut/midudev](https://unavatar.io/revolut/midudev)
|
|
1142
1280
|
|
|
1281
|
+
Try lookups live on the [Revolut avatar API](https://unavatar.io/revolut) page.
|
|
1282
|
+
|
|
1143
1283
|
### Roblox
|
|
1144
1284
|
|
|
1145
1285
|
Get any Roblox player's avatar headshot by username or user ID.
|
|
@@ -1153,30 +1293,40 @@ Available inputs:
|
|
|
1153
1293
|
- `username` (default): [unavatar.io/roblox/builderman](https://unavatar.io/roblox/builderman)
|
|
1154
1294
|
- `id`: [unavatar.io/roblox/id:156](https://unavatar.io/roblox/id:156)
|
|
1155
1295
|
|
|
1296
|
+
Try lookups live on the [Roblox avatar API](https://unavatar.io/roblox) page.
|
|
1297
|
+
|
|
1156
1298
|
### Sketchfab
|
|
1157
1299
|
|
|
1158
1300
|
Get any Sketchfab creator's profile picture by their username.
|
|
1159
1301
|
|
|
1160
1302
|
e.g., [unavatar.io/sketchfab/nasa](https://unavatar.io/sketchfab/nasa)
|
|
1161
1303
|
|
|
1304
|
+
Try lookups live on the [Sketchfab avatar API](https://unavatar.io/sketchfab) page.
|
|
1305
|
+
|
|
1162
1306
|
### Snapchat
|
|
1163
1307
|
|
|
1164
1308
|
Get any Snapchat user's profile picture by their username.
|
|
1165
1309
|
|
|
1166
1310
|
e.g., [unavatar.io/snapchat/teddysdaytoday](https://unavatar.io/snapchat/teddysdaytoday)
|
|
1167
1311
|
|
|
1312
|
+
Try lookups live on the [Snapchat avatar API](https://unavatar.io/snapchat) page.
|
|
1313
|
+
|
|
1168
1314
|
### SoundCloud
|
|
1169
1315
|
|
|
1170
1316
|
Get any SoundCloud artist's profile picture by their username.
|
|
1171
1317
|
|
|
1172
1318
|
e.g., [unavatar.io/soundcloud/gorillaz](https://unavatar.io/soundcloud/gorillaz)
|
|
1173
1319
|
|
|
1320
|
+
Try lookups live on the [SoundCloud avatar API](https://unavatar.io/soundcloud) page.
|
|
1321
|
+
|
|
1174
1322
|
### Speedrun.com
|
|
1175
1323
|
|
|
1176
1324
|
Get any Speedrun.com runner's profile picture by their username.
|
|
1177
1325
|
|
|
1178
1326
|
e.g., [unavatar.io/speedrun/cheese](https://unavatar.io/speedrun/cheese)
|
|
1179
1327
|
|
|
1328
|
+
Try lookups live on the [Speedrun.com avatar API](https://unavatar.io/speedrun) page.
|
|
1329
|
+
|
|
1180
1330
|
### Spotify
|
|
1181
1331
|
|
|
1182
1332
|
Get artwork for any Spotify entity — users, artists, albums, playlists, shows, episodes, or tracks. Look up by username or Spotify ID.
|
|
@@ -1195,12 +1345,16 @@ Available inputs:
|
|
|
1195
1345
|
- `track`: [unavatar.io/spotify/track:4OROzZUy6gOWN4UGQVaZMF](https://unavatar.io/spotify/track:4OROzZUy6gOWN4UGQVaZMF)
|
|
1196
1346
|
- `user` (default): [unavatar.io/spotify/user:kikobeats](https://unavatar.io/spotify/user:kikobeats)
|
|
1197
1347
|
|
|
1348
|
+
Try lookups live on the [Spotify image API](https://unavatar.io/spotify) page.
|
|
1349
|
+
|
|
1198
1350
|
### Stack Overflow
|
|
1199
1351
|
|
|
1200
1352
|
Get any Stack Overflow user's profile picture by their numeric user ID only (slug paths are not supported).
|
|
1201
1353
|
|
|
1202
1354
|
e.g., [unavatar.io/stackoverflow/19082](https://unavatar.io/stackoverflow/19082)
|
|
1203
1355
|
|
|
1356
|
+
Try lookups live on the [Stack Overflow avatar API](https://unavatar.io/stackoverflow) page.
|
|
1357
|
+
|
|
1204
1358
|
### Steam
|
|
1205
1359
|
|
|
1206
1360
|
Get any Steam player or community group profile picture by public profile name, numeric account ID, or group name.
|
|
@@ -1215,42 +1369,56 @@ Available inputs:
|
|
|
1215
1369
|
- `profile`: [unavatar.io/steam/profile:76561198044605749](https://unavatar.io/steam/profile:76561198044605749)
|
|
1216
1370
|
- `group`: [unavatar.io/steam/group:murcia-gaming](https://unavatar.io/steam/group:murcia-gaming)
|
|
1217
1371
|
|
|
1372
|
+
Try lookups live on the [Steam avatar API](https://unavatar.io/steam) page.
|
|
1373
|
+
|
|
1218
1374
|
### Strava
|
|
1219
1375
|
|
|
1220
1376
|
Get any Strava athlete's profile picture by their username or athlete ID.
|
|
1221
1377
|
|
|
1222
1378
|
e.g., [unavatar.io/strava/kikobeats](https://unavatar.io/strava/kikobeats)
|
|
1223
1379
|
|
|
1380
|
+
Try lookups live on the [Strava avatar API](https://unavatar.io/strava) page.
|
|
1381
|
+
|
|
1224
1382
|
### Stripe
|
|
1225
1383
|
|
|
1226
1384
|
Get any Stripe user's profile picture by their username.
|
|
1227
1385
|
|
|
1228
1386
|
e.g., [unavatar.io/stripe/levelsio](https://unavatar.io/stripe/levelsio)
|
|
1229
1387
|
|
|
1388
|
+
Try lookups live on the [Stripe avatar API](https://unavatar.io/stripe) page.
|
|
1389
|
+
|
|
1230
1390
|
### Substack
|
|
1231
1391
|
|
|
1232
1392
|
Get any Substack author's profile picture by their publication username.
|
|
1233
1393
|
|
|
1234
1394
|
e.g., [unavatar.io/substack/bankless](https://unavatar.io/substack/bankless)
|
|
1235
1395
|
|
|
1396
|
+
Try lookups live on the [Substack avatar API](https://unavatar.io/substack) page.
|
|
1397
|
+
|
|
1236
1398
|
### Telegram
|
|
1237
1399
|
|
|
1238
1400
|
Get any Telegram user's profile picture by their username.
|
|
1239
1401
|
|
|
1240
1402
|
e.g., [unavatar.io/telegram/drsdavidsoft](https://unavatar.io/telegram/drsdavidsoft)
|
|
1241
1403
|
|
|
1404
|
+
Try lookups live on the [Telegram avatar API](https://unavatar.io/telegram) page.
|
|
1405
|
+
|
|
1242
1406
|
### Thingiverse
|
|
1243
1407
|
|
|
1244
1408
|
Get any Thingiverse maker's profile picture by their username.
|
|
1245
1409
|
|
|
1246
1410
|
e.g., [unavatar.io/thingiverse/vitaminrad](https://unavatar.io/thingiverse/vitaminrad)
|
|
1247
1411
|
|
|
1412
|
+
Try lookups live on the [Thingiverse avatar API](https://unavatar.io/thingiverse) page.
|
|
1413
|
+
|
|
1248
1414
|
### Threads
|
|
1249
1415
|
|
|
1250
1416
|
Get any Threads user's profile picture by their username.
|
|
1251
1417
|
|
|
1252
1418
|
e.g., [unavatar.io/threads/zuck](https://unavatar.io/threads/zuck)
|
|
1253
1419
|
|
|
1420
|
+
Try lookups live on the [Threads avatar API](https://unavatar.io/threads) page.
|
|
1421
|
+
|
|
1254
1422
|
### Tidal
|
|
1255
1423
|
|
|
1256
1424
|
Get artwork for any Tidal artist, album, or playlist by ID.
|
|
@@ -1265,48 +1433,64 @@ Available inputs:
|
|
|
1265
1433
|
- `album`: [unavatar.io/tidal/album:1765857](https://unavatar.io/tidal/album:1765857)
|
|
1266
1434
|
- `playlist`: [unavatar.io/tidal/playlist:c3c18106-c4f5-4021-bb18-108255c1f450](https://unavatar.io/tidal/playlist:c3c18106-c4f5-4021-bb18-108255c1f450)
|
|
1267
1435
|
|
|
1436
|
+
Try lookups live on the [Tidal artwork API](https://unavatar.io/tidal) page.
|
|
1437
|
+
|
|
1268
1438
|
### Tieba
|
|
1269
1439
|
|
|
1270
1440
|
Get any Baidu Tieba user's profile picture by their username.
|
|
1271
1441
|
|
|
1272
1442
|
e.g., [unavatar.io/tieba/Mojang](https://unavatar.io/tieba/Mojang)
|
|
1273
1443
|
|
|
1444
|
+
Try lookups live on the [Tieba avatar API](https://unavatar.io/tieba) page.
|
|
1445
|
+
|
|
1274
1446
|
### TikTok
|
|
1275
1447
|
|
|
1276
1448
|
Get any TikTok user's profile picture by their username. No authentication or API tokens needed — just pass the username.
|
|
1277
1449
|
|
|
1278
1450
|
e.g., [unavatar.io/tiktok/carlosazaustre](https://unavatar.io/tiktok/carlosazaustre)
|
|
1279
1451
|
|
|
1452
|
+
Try lookups live on the [TikTok avatar API](https://unavatar.io/tiktok) page.
|
|
1453
|
+
|
|
1280
1454
|
### Tumblr
|
|
1281
1455
|
|
|
1282
1456
|
Get any Tumblr blog's profile picture by their username.
|
|
1283
1457
|
|
|
1284
1458
|
e.g., [unavatar.io/tumblr/nasa](https://unavatar.io/tumblr/nasa)
|
|
1285
1459
|
|
|
1460
|
+
Try lookups live on the [Tumblr avatar API](https://unavatar.io/tumblr) page.
|
|
1461
|
+
|
|
1286
1462
|
### Twitch
|
|
1287
1463
|
|
|
1288
1464
|
Get any Twitch streamer's profile picture by their username.
|
|
1289
1465
|
|
|
1290
1466
|
e.g., [unavatar.io/twitch/midudev](https://unavatar.io/twitch/midudev)
|
|
1291
1467
|
|
|
1468
|
+
Try lookups live on the [Twitch avatar API](https://unavatar.io/twitch) page.
|
|
1469
|
+
|
|
1292
1470
|
### Venmo
|
|
1293
1471
|
|
|
1294
1472
|
Get any Venmo user's profile picture by their username.
|
|
1295
1473
|
|
|
1296
1474
|
e.g., [unavatar.io/venmo/Jessica-Lee-77](https://unavatar.io/venmo/Jessica-Lee-77)
|
|
1297
1475
|
|
|
1476
|
+
Try lookups live on the [Venmo avatar API](https://unavatar.io/venmo) page.
|
|
1477
|
+
|
|
1298
1478
|
### Vimeo
|
|
1299
1479
|
|
|
1300
1480
|
Get any Vimeo user's profile picture by their username.
|
|
1301
1481
|
|
|
1302
1482
|
e.g., [unavatar.io/vimeo/ladieswithlenses](https://unavatar.io/vimeo/ladieswithlenses)
|
|
1303
1483
|
|
|
1484
|
+
Try lookups live on the [Vimeo avatar API](https://unavatar.io/vimeo) page.
|
|
1485
|
+
|
|
1304
1486
|
### Wattpad
|
|
1305
1487
|
|
|
1306
1488
|
Get any Wattpad writer's profile picture by their username.
|
|
1307
1489
|
|
|
1308
1490
|
e.g., [unavatar.io/wattpad/Wattpad](https://unavatar.io/wattpad/Wattpad)
|
|
1309
1491
|
|
|
1492
|
+
Try lookups live on the [Wattpad avatar API](https://unavatar.io/wattpad) page.
|
|
1493
|
+
|
|
1310
1494
|
### Weibo
|
|
1311
1495
|
|
|
1312
1496
|
Get any Weibo user's profile picture by numeric user ID or screen name.
|
|
@@ -1316,6 +1500,8 @@ Available inputs:
|
|
|
1316
1500
|
- User ID, e.g., [unavatar.io/weibo/2803301701](https://unavatar.io/weibo/2803301701)
|
|
1317
1501
|
- 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)
|
|
1318
1502
|
|
|
1503
|
+
Try lookups live on the [Weibo avatar API](https://unavatar.io/weibo) page.
|
|
1504
|
+
|
|
1319
1505
|
### WhatsApp
|
|
1320
1506
|
|
|
1321
1507
|
Get the profile picture for a WhatsApp channel or chat by ID.
|
|
@@ -1330,24 +1516,32 @@ Available inputs:
|
|
|
1330
1516
|
- `channel`: [unavatar.io/whatsapp/channel:0029VaARuQ7KwqSXh9fiMc0m](https://unavatar.io/whatsapp/channel:0029VaARuQ7KwqSXh9fiMc0m)
|
|
1331
1517
|
- `chat`: [unavatar.io/whatsapp/chat:D2FFycjQXrEIKG8qQjbwZz](https://unavatar.io/whatsapp/chat:D2FFycjQXrEIKG8qQjbwZz)
|
|
1332
1518
|
|
|
1519
|
+
Try lookups live on the [WhatsApp channel image API](https://unavatar.io/whatsapp) page.
|
|
1520
|
+
|
|
1333
1521
|
### Wise
|
|
1334
1522
|
|
|
1335
1523
|
Get any Wise user's profile picture by their Wisetag.
|
|
1336
1524
|
|
|
1337
1525
|
e.g., [unavatar.io/wise/josev2264](https://unavatar.io/wise/josev2264)
|
|
1338
1526
|
|
|
1527
|
+
Try lookups live on the [Wise avatar API](https://unavatar.io/wise) page.
|
|
1528
|
+
|
|
1339
1529
|
### X/Twitter
|
|
1340
1530
|
|
|
1341
1531
|
Get any X (formerly Twitter) user's profile picture by their username.
|
|
1342
1532
|
|
|
1343
1533
|
e.g., [unavatar.io/x/elonmusk](https://unavatar.io/x/elonmusk)
|
|
1344
1534
|
|
|
1535
|
+
Try lookups live on the [X/Twitter avatar API](https://unavatar.io/x) page.
|
|
1536
|
+
|
|
1345
1537
|
### Xbox Gamertag
|
|
1346
1538
|
|
|
1347
1539
|
Get any Xbox player's profile picture by their gamertag.
|
|
1348
1540
|
|
|
1349
1541
|
e.g., [unavatar.io/xboxgamertag/GD-BerserkerTTD](https://unavatar.io/xboxgamertag/GD-BerserkerTTD)
|
|
1350
1542
|
|
|
1543
|
+
Try lookups live on the [Xbox Gamertag avatar API](https://unavatar.io/xboxgamertag) page.
|
|
1544
|
+
|
|
1351
1545
|
### YouTube
|
|
1352
1546
|
|
|
1353
1547
|
Get any YouTube channel's thumbnail by their handle, legacy username, or channel ID.
|
|
@@ -1361,12 +1555,16 @@ Available inputs:
|
|
|
1361
1555
|
- `username`: [unavatar.io/youtube/casey](https://unavatar.io/youtube/casey)
|
|
1362
1556
|
- `channel`: [unavatar.io/youtube/UC_x5XG1OV2P6uZZ5FSM9Ttw](https://unavatar.io/youtube/UC_x5XG1OV2P6uZZ5FSM9Ttw)
|
|
1363
1557
|
|
|
1558
|
+
Try lookups live on the [YouTube channel thumbnail API](https://unavatar.io/youtube) page.
|
|
1559
|
+
|
|
1364
1560
|
### Zhihu
|
|
1365
1561
|
|
|
1366
1562
|
Get any Zhihu user's profile picture by their username.
|
|
1367
1563
|
|
|
1368
1564
|
e.g., [unavatar.io/zhihu/kaifulee](https://unavatar.io/zhihu/kaifulee)
|
|
1369
1565
|
|
|
1566
|
+
Try lookups live on the [Zhihu avatar API](https://unavatar.io/zhihu) page.
|
|
1567
|
+
|
|
1370
1568
|
## Response Format
|
|
1371
1569
|
|
|
1372
1570
|
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.72.
|
|
5
|
+
"version": "3.72.6",
|
|
6
6
|
"main": "src/index.js",
|
|
7
7
|
"exports": {
|
|
8
8
|
".": "./src/index.js",
|
|
@@ -127,7 +127,6 @@
|
|
|
127
127
|
"@keyvhq/offline": "~2.2.0",
|
|
128
128
|
"@keyvhq/redis": "~2.2.3",
|
|
129
129
|
"@metascraper/helpers": "~5.58.4",
|
|
130
|
-
"@microlink/ping-url": "~1.5.0",
|
|
131
130
|
"bimi-url": "~1.0.0",
|
|
132
131
|
"browserless": "~14.1.1",
|
|
133
132
|
"cacheable-lookup": "~6.1.0",
|
|
@@ -145,8 +144,9 @@
|
|
|
145
144
|
"ms": "~2.1.3",
|
|
146
145
|
"p-any": "~3.0.0",
|
|
147
146
|
"p-timeout": "~4.1.0",
|
|
148
|
-
"puppeteer": "~25.
|
|
147
|
+
"puppeteer": "~25.17.0",
|
|
149
148
|
"re2": "~1.27.0",
|
|
149
|
+
"reachable-url": "~2.1.10",
|
|
150
150
|
"srcset": "~4.0.0",
|
|
151
151
|
"stable-regex": "~1.0.1",
|
|
152
152
|
"tangerine": "~2.1.3",
|
|
@@ -1,17 +1,78 @@
|
|
|
1
1
|
'use strict'
|
|
2
2
|
|
|
3
|
-
const
|
|
3
|
+
const memoize = require('@keyvhq/memoize')
|
|
4
|
+
const reachableUrl = require('reachable-url')
|
|
5
|
+
const ms = require('ms')
|
|
6
|
+
|
|
7
|
+
const RATE_LIMITED = 429
|
|
8
|
+
const UNCACHED_STATUS_CODES = new Set([403, 408])
|
|
9
|
+
const RATE_LIMIT_TTL_DEFAULT = ms('1m')
|
|
10
|
+
const RATE_LIMIT_TTL_MIN = ms('1s')
|
|
11
|
+
const RATE_LIMIT_TTL_MAX = ms('10m')
|
|
4
12
|
|
|
5
13
|
const isRedirectStatus = statusCode => statusCode >= 300 && statusCode < 400
|
|
6
14
|
|
|
15
|
+
const isUncached = statusCode =>
|
|
16
|
+
UNCACHED_STATUS_CODES.has(statusCode) || statusCode >= 500
|
|
17
|
+
|
|
18
|
+
const parseRetryAfter = (value, now = Date.now()) => {
|
|
19
|
+
if (typeof value === 'string') value = value.trim()
|
|
20
|
+
if (!value) return undefined
|
|
21
|
+
const seconds = Number(value)
|
|
22
|
+
if (Number.isFinite(seconds)) return seconds * 1000
|
|
23
|
+
if (typeof value !== 'string') return undefined
|
|
24
|
+
if (/[a-z]/i.test(value)) {
|
|
25
|
+
const date = Date.parse(value)
|
|
26
|
+
if (!Number.isNaN(date)) return date - now
|
|
27
|
+
}
|
|
28
|
+
const first = value.split(',')[0]
|
|
29
|
+
if (!first) return undefined
|
|
30
|
+
const firstSeconds = Number(first)
|
|
31
|
+
return Number.isFinite(firstSeconds) ? firstSeconds * 1000 : undefined
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
const rateLimitTtl = retryAfter => {
|
|
35
|
+
const wait = parseRetryAfter(retryAfter)
|
|
36
|
+
if (wait === undefined) return RATE_LIMIT_TTL_DEFAULT
|
|
37
|
+
return Math.min(Math.max(wait, RATE_LIMIT_TTL_MIN), RATE_LIMIT_TTL_MAX)
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
class UncachedPing extends Error {
|
|
41
|
+
constructor (response) {
|
|
42
|
+
super(`ping not cached for ${response.statusCode}`)
|
|
43
|
+
this.response = response
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const ping = async (url, opts) => {
|
|
48
|
+
const {
|
|
49
|
+
url: resolvedUrl,
|
|
50
|
+
statusCode,
|
|
51
|
+
headers
|
|
52
|
+
} = await reachableUrl(url, opts)
|
|
53
|
+
const response = { url: resolvedUrl, statusCode }
|
|
54
|
+
if (isUncached(statusCode)) throw new UncachedPing(response)
|
|
55
|
+
if (statusCode === RATE_LIMITED) {
|
|
56
|
+
return { ...response, ttl: rateLimitTtl(headers?.['retry-after']) }
|
|
57
|
+
}
|
|
58
|
+
return response
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const unwrapUncached = error => {
|
|
62
|
+
if (error instanceof UncachedPing) return error.response
|
|
63
|
+
throw error
|
|
64
|
+
}
|
|
65
|
+
|
|
7
66
|
module.exports = ({ got, pingCache }) => {
|
|
8
|
-
const
|
|
9
|
-
value: ({ url, statusCode }) => ({ url, statusCode })
|
|
10
|
-
})
|
|
67
|
+
const cachedPing = memoize(ping, pingCache, { ttl: value => value.ttl })
|
|
11
68
|
|
|
12
|
-
const
|
|
69
|
+
const pingUrl = async (url, opts) => {
|
|
13
70
|
const context = {}
|
|
14
|
-
const response = await
|
|
71
|
+
const { ttl, ...response } = await cachedPing(url, {
|
|
72
|
+
...got.gotOpts,
|
|
73
|
+
...opts,
|
|
74
|
+
context
|
|
75
|
+
}).catch(unwrapUncached)
|
|
15
76
|
const { reservedAddress } = context
|
|
16
77
|
|
|
17
78
|
// reachable-url leaves the redirect hop as the status when a beforeRedirect
|
|
@@ -26,7 +87,9 @@ module.exports = ({ got, pingCache }) => {
|
|
|
26
87
|
return { ...response, statusCode }
|
|
27
88
|
}
|
|
28
89
|
|
|
29
|
-
|
|
90
|
+
pingUrl.isReachable = reachableUrl.isReachable
|
|
30
91
|
|
|
31
|
-
return
|
|
92
|
+
return pingUrl
|
|
32
93
|
}
|
|
94
|
+
|
|
95
|
+
module.exports.rateLimitTtl = rateLimitTtl
|