Web service for easily requesting profile photos from several sources
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Web service for easily use profile photos on your web page.

You don't need to maintain same implementations for getting user pictures in your projects, just generate URL and you will get a CDN-powered credential management free user profile picture.

Use in HTML:

<img src="https://socatar.com/twitter/yegor256/50-50" />

or via API:

// cURL save image to your current folder
curl https://socatar.com/github/terales/50-50 -o terales.jpg

// Windows via PowerShell, save image to your Desktop
Invoke-WebRequest https://socatar.com/github/terales/50-50 -OutFile "$([Environment]::GetFolderPath("Desktop"))\terales.jpg"


Uptime: Uptime Build Status Coverage Status Greenkeeper badge

Codacy Badge JavaScript Style Guide

Currently supported sources

  • Facebook with id, like 100001584476227 OR profile slug, like yegor256
  • GitHub with login, like terales
  • Google with Google+ id, like +SriramSaroop OR gmail address
  • Gravatar with email
  • Twitter with username, like robwormald

Resize images with Cloudinary

Thanks to the Cloudinary generous limits we are able to resize images from any source. Just prepend required width and height to the image url:

                             width - ^^ ^^ - height

If you omit size (ex. https://socatar.com/twitter/yegor256) than 100×100 image would be served. For you custom deployment you can modify it via environment variables, see .env-template.

When Cloudinary integration is enabled Socatar.com will get the url of required image and redirect it to Cloudinary fetch with transformations applied.

Get an original image with a special original size:


Getting help

Please, report anything via the GitHub issues: https://github.com/terales/socatar/issues.

Business opportunities, security issues and any violations should be emailed to socatar.com@gmail.com.

Technical questions about service usage or configuration should be asked on StackOverflow and link to the question should be sent to socatar.com@gmail.com.

How you can help

This project runs on Node.js and has a good support for newcomers thanks to (JavaScript Standard Style)[https://standardjs.com/] automatic code style fixes and a decent test coverage.

Please, refer to contributing guideline for environment setup and recommended workflow.

Project details

This project is licensed under the MIT License — see the license file for details

Created by Oleksandr Terekhov. The original idea belongs to Yegor Bugayenko.