Cloudinary Blog

Display Instagram and Google+ profile pictures in your website and mobile app

Embed Instagram, Google+ profile pictures in your site
Many modern web and mobile applications include integral social aspects as parts of their online solution. 
 
Users can sign-in to these services and be identified by their chosen social identity. This is made quite straightforward by leveraging single sign-on services such as Facebook Connect, Twitter, Google+ and others. After signing in, activities in the service and user generated content can be accompanied with the real name of the users as well as their profile pictures.
 
In order to display a user's social profile picture in your web site, you'll need to support all the different APIs provided by the relevant social network, each with its own quirks. You'll then probably want to fetch the profile picture to your local server. After that, you'll want to modify the picture to match your graphic design's dimensions and aspect ratio requirements, apply the relevant transformations (applying circular crops, sharpening, etc.), and remember to update the images on your side when users update their profile pictures on the social network.
 
Overall, a lot of small things to take care of.
 
Fortunately, Cloudinary already does all that for you. Simply specify the social profile name or ID using Cloudinary's dynamic image URLs and you're done. Cloudinary contacts the social network and automatically fetches the profile picture that best matches your display requirements. It then transforms the image on-the-fly to match your graphic design, delivers the image optimized and cached through a fast CDN and refreshes the image periodically in case it was changes on the social network.
 
This blog post details how you can embed social pictures from Google+ and Instagram, our latest additions to Cloudinary's list of supported social networks (adding to Facebook, Twitter and Gravatar).
 

Instagram profile pictures

Every Instagram user has a unique public user name and a main profile picture. If you know that a piece of content on your site was contributed by a certain Instagram user, you can use Cloudinary's delivery URLs to fetch and display their main profile picture side-by-side with their added content.
 
The following example fetches the profile picture of 'angelinajolieofficial' while transforming it to fill a 120x120 rectangle, optimizes it and delivers it through a CDN.
 
 
120x120 Instagram profile picture
 
If you use one of our client libraries, all you need to do is to set the image type to 'instagram_name'. Here's a Ruby on Rails example:
<%= cl_image_tag('angelinajolieofficial.jpg',
                 :type => :instagram_name, :width => 120, :height => 120, 
                 :crop => :fill) %>
In the example above, the original Instagram profile picture was displayed while reducing its original dimensions. You can apply any Cloudinary transformation on-the-fly to match the look & feel of your application on any desktop, mobile or retina display. The following example generates a 90x90 circular crop thumbnail of the same photo. Automatic face detection was used to correctly crop the original image. In addition, an automatic image improvement filter was applied on the generated thumbnail.
 
 
Manipulated Instagram profile picture by name
 
 
The following PHP code creates the same URL:
<?php echo cl_image_tag("angelinajolieofficial.jpg",
             array("type": "instagram_name",
                   "width" => 90, "height" => 90, "crop" => "thumb", 
                   "gravity" => "face", "radius" => "max", "effect" => "improve")); ?>
Each Instagram profile has a unique numerical identifier in addition to the public user name. If you are using Instagram's APIs, you may prefer building the Cloudinary image delivery URLs based on Instagram's numeric IDs instead of user names.
 
The following examples fetch, manipulate, optimize and deliver the Instragram profile picture with the numeric ID 187971875. This time also adding a border to the image on the right.
 
 
Instagram profile picture by ID          Manipulated Instagram profile picture by ID
 
               
Below is a Javascript code for Node.js that generates the same circular thumbnail:
cloudinary.image("187971875.jpg", 
                 { type: 'instagram', width: 90, height: 90, crop: 'thumb', 
                   gravity: face, radius: 'max', 'effect': 'improve', 
                   border: '2px_solid_black'  });

Google+ profile pictures

The Google+ social network strives to be the ultimate Facebook alternative. Using Cloudinary, you can easily embed Google+ profile pictures in your website and mobile app. 
 
Do that by simply setting the image type to 'gplus' while building Cloudinary URLs. The images are identified by Google+ unique numeric ID.
 
The following URL delivers a 150x150 version of the Google+ profile of Larry Page that has the numeric ID of 106189723444098348646:
 
 
Google+ profile picture 
The following .Net code generates the same image:
cloudinary.Api.UrlImgUp.Action("gplus").Transform(
  new Transformation().Width(150).Height(150).Crop("scale")).
    BuildImageTag("106189723444098348646.jpg");
You can apply any Cloudinary image manipulation on the image. The following example generate a 150x150 face-detection based circular thumbnail while increasing the fill light of the resulting image and changing its colors to be more blueish.  
 
When generating rounded corners or circular images, you might want the background of the image to be transparent. This will allow you to place the image over a background image or pattern. To do that, just tell Cloudinary to convert the image format on-the-fly to the PNG format that supports transparent background (alpha channel).
 
 
Google+ manipulated profile picture as PNG         
 
The following Django code generates the same result:
cloudinary.CloudinaryImage("106189723444098348646.png").image(
             transformation = [
               { "width": 150, "height": 150, "crop": "fill", 
                  "gravity": "face", "radius": "max", "effect": "fill_light:30" },
               { "effect": "blue:50" }
             ]
            )
In addition to user profile pictures, Google+ (as well as Facebook) also maintains profile pictures of companies, products and figures. You can use the same 'gplus' image type to transform and deliver pictures of these additional Google+ pages as well. The following example delivers the picture of Google's Google+ page while scaling it to 100 pixels width, rotating by 30 degrees and applying a grayscale effect. This time, using the name of this page '+google'.
 
 
Google+ profile picture based on page name
 
 
While all code samples above rendered an HTML image tag on the server-side, you can use Cloudinary's jQuery plugin to dynamically embed social profile pictures from your client-side code on the browser side. Here's a jQuery example:
$.cloudinary.image("+google.jpg", 
  { transformation: { width: 100, crop: 'scale', effect: 'grayscale' }, angle: 30 })

Summary

Many of Cloudinary's customers already use Cloudinary to fetch, manipulate and deliver Facebook and Twitter profile pictures in their web and mobile sites and apps. Now you have the same simple integration available for both Google+ and Instagram. We hope you enjoy using these new features as well.
 
Profile picture delivery of all supported social networks is included in any of our plans. Try it out now.

Recent Blog Posts

CoreMedia Adds Cloudinary to its CoreMedia Studio Platform

Today we’re pleased to announce a new technology partnership with CoreMedia, a leading Content Experience Platform provider. CoreMedia users can now leverage Cloudinary’s web-based digital asset management (DAM) solution to organize, search, manage and optimize their media assets, including images and videos, and to orchestrate, preview and deliver digital experiences consistently and optimized across all channels and browsers. The official press release is available here.

Read more
Facial-Surveillance System for Restricted Zones

In Africa, where Internet access and bandwidth are limited, it’s not cost-effective or feasible to establish and maintain a connectivity for security and surveillance applications. That challenge makes it almost impossible to build a service that detects, with facial-recognition technology, if someone entering a building is authorized to do so. To meet the final-year research requirement for my undergraduate studies, I developed a facial-surveillance system. Armed with a background in computer vision, I decided to push the limits and see if I could build a surveillance system that does not require recording long video footage.

Read more
Complex Networks Case Study

Complex Networks has been using Cloudinary since 2014 to manage and optimize images across seven websites and two mobile apps, making editorial workflow more efficient, improving page performance and load time, and increasing user engagement. Cloudinary was instrumental in enabling Complex Networks to redesign its web properties. Without the flexibility that Cloudinary offers to both creative and development teams, it would not have been possible for Complex Networks to achieve such a fast time to market.

Read more
Automate Placeholder Generation and Accelerate Page Loads

If you run a Google search on LQIP you’ll see very few relevant articles, very little guidance, and definitely no Wikipedia articles. In this post, we’ll discuss some of the feedback on LQIP we have gathered from the community and suggest and open for conversation a few approaches based on the built-in capabilities of the Cloudinary service. Specifically, we’ll explain what LQIP are, where they are best used, and how you can leverage them to accelerate page loads and optimize user experience.

Read more
Best Practices for Optimizing Web Page Speed

If you're like most consumers today, you engage more with pictures or videos on a website than text. The stats don't lie - four times as many visitors would rather watch a video about a product than read about it, and sites with compelling images average twice as many views as text-heavy ones.

Read more
A day of fun with Girls Who Code and Cloudinary

During both my computer science studies and work in the tech field, there have not been a lot of women present. While our ranks have grown, women still make up only a small percentage. In many ways, I think the traditionally male-dominated world can be intimidating to women and girls who may be interested in pursuing these types of tech careers.

Read more