@unavatar/core 3.46.17 → 3.48.0

package/README.md

@@ -49,6 +49,7 @@
   - [Hugging Face](#hugging-face)
   - [Instagram](#instagram)
   - [Juejin](#juejin)
+  - [Kick](#kick)
   - [Ko-fi](#ko-fi)
   - [LinkedIn](#linkedin)
   - [Mastodon](#mastodon)
@@ -106,13 +107,13 @@ Last updated on August 18, 2026
 
 ## Introduction
 
-**unavatar.io** retrieves anyone's avatar from a single URL — by username, email, or domain — across 72 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.
+**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.
 
 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)
 
 Everything you need to serve avatars at scale:
 
-- **Versatile**: One endpoint rules 72 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.
+- **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.
 
 - **Battle-tested**: Already serving 2.77 TB of avatars across 189.4M requests, with a 70% cache hit rate.
 
@@ -811,6 +812,12 @@ Get any Juejin user's profile picture by their numeric user ID.
 
 e.g., [unavatar.io/juejin/1556564194374926](https://unavatar.io/juejin/1556564194374926)
 
+### Kick
+
+Get any Kick streamer's profile picture by their username.
+
+e.g., [unavatar.io/kick/xqc](https://unavatar.io/kick/xqc)
+
 ### Ko-fi
 
 Get any Ko-fi page's profile picture by the creator username.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@unavatar/core",
   "description": "Get unified user avatar from social networks, including Instagram, SoundCloud, Telegram, Twitter, YouTube & more.",
   "homepage": "https://unavatar.io",
-  "version": "3.46.17",
+  "version": "3.48.0",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js",

package/src/providers/bluesky.js

@@ -1,10 +1,25 @@
 'use strict'
 
-const { $jsonld } = require('@metascraper/helpers')
-
-module.exports = ({ createHtmlProvider }) =>
-  createHtmlProvider({
-    name: 'bluesky',
-    url: input => `https://bsky.app/profile/${input}`,
-    getter: $ => $jsonld('mainEntity.image')($)
-  })
+const API_URL = 'https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile'
+
+const getAvatarUrl = input => `${API_URL}?actor=${encodeURIComponent(input)}`
+
+const getAvatar = body => {
+  const pic = body?.avatar
+  return typeof pic === 'string' && pic ? pic : undefined
+}
+
+module.exports = ({ got }) =>
+  async function bluesky (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/deezer.js

@@ -1,32 +1,44 @@
 'use strict'
 
+const API_URL = 'https://api.deezer.com'
+
 // Entities without artwork keep an empty image hash
 // (cdn-images.dzcdn.net/images/artist//500x500.jpg), which resolves to a
 // generic placeholder, so any empty hash segment is treated as a miss.
 const isArtwork = url => !/\/images\/[^/]+\/\/\d/.test(url)
 
-const getAvatarUrl = input => {
+const parseInput = input => {
   const [first, second] = input.split(':')
-  const type = second ? first : 'artist'
-  const id = second ?? first
-  return `https://www.deezer.com/en/${type}/${id}`
+  return {
+    type: second ? first : 'artist',
+    id: second ?? first
+  }
 }
 
-// Deezer server-renders og:image for missing entities as well, so the empty
-// placeholder is filtered out and everything else is returned as-is.
-const getAvatar = ({ $, getOgImage, NOT_FOUND }) => {
-  const image = getOgImage($)
-  return image && isArtwork(image) ? image : NOT_FOUND
+const getAvatarUrl = input => {
+  const { type, id } = parseInput(input)
+  return `${API_URL}/${encodeURIComponent(type)}/${encodeURIComponent(id)}`
 }
 
-const factory = ({ createHtmlProvider, getOgImage, NOT_FOUND }) =>
-  createHtmlProvider({
-    name: 'deezer',
-    url: getAvatarUrl,
-    getter: $ => getAvatar({ $, getOgImage, NOT_FOUND })
-  })
+const getAvatar = body => {
+  if (body?.error) return
+
+  const pic = body?.picture_xl || body?.cover_xl || body?.album?.cover_xl
+  return typeof pic === 'string' && pic && isArtwork(pic) ? pic : undefined
+}
+
+module.exports = ({ got }) =>
+  async function deezer (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
 
-factory.getAvatarUrl = getAvatarUrl
-factory.getAvatar = getAvatar
+    return getAvatar(body)
+  }
 
-module.exports = factory
+module.exports.parseInput = parseInput
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/gitlab.js

@@ -1,8 +1,43 @@
 'use strict'
 
-module.exports = ({ createHtmlProvider, getOgImage }) =>
-  createHtmlProvider({
-    name: 'gitlab',
-    url: input => `https://gitlab.com/${input}`,
-    getter: getOgImage
+const GITLAB_API_URL = 'https://gitlab.com/api/v4'
+
+const getUserAvatarUrl = input =>
+  `${GITLAB_API_URL}/users?username=${encodeURIComponent(input)}`
+
+const getGroupAvatarUrl = input =>
+  `${GITLAB_API_URL}/groups/${encodeURIComponent(input)}`
+
+const getAvatar = body => {
+  const pic = Array.isArray(body) ? body[0]?.avatar_url : body?.avatar_url
+  return typeof pic === 'string' && pic ? pic : undefined
+}
+
+const fetchAvatarUrl = async ({ got, url }) => {
+  const { statusCode, body } = await got(url, {
+    responseType: 'json',
+    throwHttpErrors: false
   })
+
+  if (statusCode >= 400) return
+
+  return getAvatar(body)
+}
+
+module.exports = ({ got }) =>
+  async function gitlab (input) {
+    const userAvatarUrl = await fetchAvatarUrl({
+      got,
+      url: getUserAvatarUrl(input)
+    })
+    if (userAvatarUrl) return userAvatarUrl
+
+    return fetchAvatarUrl({
+      got,
+      url: getGroupAvatarUrl(input)
+    })
+  }
+
+module.exports.getUserAvatarUrl = getUserAvatarUrl
+module.exports.getGroupAvatarUrl = getGroupAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/index.js

@@ -30,6 +30,7 @@ const providerTiers = {
       'hevy',
       'instagram',
       'juejin',
+      'kick',
       'ko-fi',
       'linkedin',
       'mastodon',
@@ -118,6 +119,7 @@ module.exports = ctx => {
     hevy: require('./hevy')(ctx),
     instagram: require('./instagram')(ctx),
     juejin: require('./juejin')(ctx),
+    kick: require('./kick')(ctx),
     'ko-fi': require('./ko-fi')(ctx),
     linkedin: require('./linkedin')(ctx),
     mastodon: require('./mastodon')(ctx),

package/src/providers/kick.js

@@ -0,0 +1,25 @@
+'use strict'
+
+const API_URL = 'https://kick.com/api/v2/channels'
+
+const getAvatarUrl = input => `${API_URL}/${encodeURIComponent(input)}`
+
+const getAvatar = body => {
+  const pic = body?.user?.profile_pic
+  return typeof pic === 'string' && pic ? pic : undefined
+}
+
+module.exports = ({ got }) =>
+  async function kick (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar