Gravatar

App · 5 actions

Turn an email address into a person: their name, photo, location, job, company and verified social accounts from their public Gravatar profile. Check whether someone has a Gravatar, get their picture as a link or a file at the size you need, with a stand-in for people without one, find profiles from a GitHub or X username, and make a QR code that opens a profile. No account or API key required.

Actions

ActionWhat it does
Check for a GravatarCheck whether an email address has a Gravatar picture, and when it last changed.
Find profiles by social accountFind the Gravatar profiles that have verified an account with a given username on another service, such as GitHub, LinkedIn or X: a way from someone's GitHub username to their name, photo and other accounts.
Get avatarGet a link to someone's Gravatar picture at the size you choose, ready for a CRM photo field, a chat message or an email, and optionally save the picture as a file to attach or upload.
Get profileLook up the public Gravatar profile behind an email address: the person's name, photo, About text, location, job title, company, pronouns and the social accounts Gravatar has verified for them (up to four).
Get profile QR codeGet a QR code that opens someone's Gravatar profile when scanned, for a name badge, a business card or an email signature.

Check for a Gravatar

Check whether an email address has a Gravatar picture, and when it last changed. Gravatar doesn't count these checks against its hourly allowance, so this suits going through a whole contact list before deciding whose photo to use. No API key required.

Inputs

Email addressemailtextRequired
The person's email address. Their Gravatar username (the matt in gravatar.com/matt) or profile link works too.
Most mature picture to showratingtext
Optional. People rate their own pictures; anyone whose picture is rated higher than this counts as having none. G, suitable for everyone, by default.One of: g (G: suitable for everyone), pg (PG: may show rude gestures, revealing clothing or mild violence), r (R: may show harsh language, violence or nudity), x (X: may show explicit sexual images or disturbing violence). Default: g.

Outputs

avatar_urltext
A link to their picture at Gravatar's default 80 pixels, or null when they have none.
has_avatartrue/false
True when the person has uploaded a Gravatar picture rated at or below the rating asked for.
hashtext
Gravatar's anonymous id for the email address (its SHA-256 hash). Every Gravatar step accepts it in place of the address.
looked_uptext
The email address (lower-cased) or username the step looked up, so a result can be matched back to its row.
ratingtext
The most mature rating allowed: 'g', 'pg', 'r' or 'x'.
summarytext
One line saying whether they have a picture, e.g. 'm@mullenweg.com has a Gravatar picture, last changed 2014-11-16'.
updated_attext
When they last changed their picture, as an ISO 8601 time in UTC, e.g. '2014-11-16T16:29:04Z'. Null when they have no picture.
Example output
{
  "avatar_url": "https://gravatar.com/avatar/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
  "has_avatar": true,
  "hash": "33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
  "looked_up": "m@mullenweg.com",
  "rating": "g",
  "summary": "m@mullenweg.com has a Gravatar picture, last changed 2014-11-16",
  "updated_at": "2014-11-16T16:29:04Z"
}

Find profiles by social account

Find the Gravatar profiles that have verified an account with a given username on another service, such as GitHub, LinkedIn or X: a way from someone's GitHub username to their name, photo and other accounts. Results come a page at a time. No API key required.

Inputs

UsernameusernametextRequired
Their username on the other service, such as photomatt. A leading @ or a link to their page there is fine.
Serviceservicetext
Optional. Only look for the username on this service. Leave blank to match it on any service.
Results per pagelimitnumber
Optional. From 5 to 50; 20 by default.From 5 to 50. Default: 20.
Pagepagenumber
Optional. Which page of results to get; 1 by default. Use Next page from the previous result to go on.At least 1. Default: 1.

Outputs

countnumber
How many profiles are on this page.
has_moretrue/false
True when there are more pages after this one.
next_pagenumber
The Page to ask for next, or null on the last page.
pagenumber
Which page of results this is.
profileslist
The matching profiles on this page.
servicetext
The service the search was limited to, or null for any.
total_pagesnumber
How many pages of results there are. 0 when nothing matched.
usernametext
The username that was searched for, without any leading @.
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 1,
  "profiles": [
    {
      "about": "In 2002 I started contributing to Open Source software, and life has just gotten better from there. Co-founder of WordPress, founder Automattic.",
      "avatar_alt_text": null,
      "avatar_url": "https://0.gravatar.com/avatar/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
      "company": null,
      "display_name": "Matt",
      "hash": "33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
      "job_title": null,
      "location": null,
      "profile_url": "https://gravatar.com/matt",
      "pronouns": null,
      "pronunciation": null,
      "username": "matt",
      "verified_accounts": [
        {
          "service": "WordPress",
          "service_id": "wordpress",
          "url": "https://matt.wordpress.com"
        },
        {
          "service": "X",
          "service_id": "twitter",
          "url": "https://x.com/photomatt"
        },
        {
          "service": "LinkedIn",
          "service_id": "linkedin",
          "url": "https://www.linkedin.com/in/mattm"
        },
        {
          "service": "Flickr",
          "service_id": "flickr",
          "url": "https://flickr.com/photos/photomatt"
        }
      ]
    }
  ],
  "service": "twitter",
  "total_pages": 1,
  "username": "photomatt"
}

Get avatar

Get a link to someone's Gravatar picture at the size you choose, ready for a CRM photo field, a chat message or an email, and optionally save the picture as a file to attach or upload. People without a Gravatar get the stand-in you pick (a silhouette, their initials, a pattern...), and Has avatar says which the link shows. No API key required.

Inputs

Email addressemailtextRequired
The person's email address. Their Gravatar username (the matt in gravatar.com/matt) or profile link works too.
Sizesizetext
Optional. How wide and tall the picture is; 256 pixels by default. Gravatar enlarges small originals, so the largest sizes can look soft.One of: 64 (64 × 64 pixels (an email signature)), 128 (128 × 128 pixels), 256 (256 × 256 pixels (a profile photo)), 512 (512 × 512 pixels), 1024 (1024 × 1024 pixels), 2048 (2048 × 2048 pixels (the largest)). Default: 256.
For people without a Gravatar, showdefault_imagetext
Optional. What the link shows for an address with no picture. A grey silhouette by default.One of: mp (A grey silhouette of a person), initials (Their initials on a coloured background), identicon (A geometric pattern, different for every email), monsterid (A cartoon monster, different for every email), wavatar (A cartoon face, different for every email), retro (An 8-bit pixel face, different for every email), robohash (A robot, different for every email), color (A plain colour, different for every email), blank (Nothing (a transparent image)), gravatar_logo (The Gravatar logo). Default: mp.
Name for the initialsinitials_nametext
Optional. The person's name, such as Ada Lovelace, shown as AL. Leave blank to use the name on their Gravatar profile; with no name at all, Gravatar shows a cat.Only when For people without a Gravatar, show is Their initials on a coloured background.
Most mature picture to showratingtext
Optional. People rate their own pictures; anyone whose picture is rated higher than this counts as having none. G, suitable for everyone, by default.One of: g (G: suitable for everyone), pg (PG: may show rude gestures, revealing clothing or mild violence), r (R: may show harsh language, violence or nudity), x (X: may show explicit sexual images or disturbing violence). Default: g.
Also save as a filesave_as_filetrue/false
Off by default, because the link is all a CRM field, a chat message or an email needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage or adding it to a document.Default: false.

Outputs

content_typetext
The saved file's type, or '' when not saved.
default_imagetext
The stand-in shown to people without a picture, e.g. 'mp'.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
has_avatartrue/false
True when the link shows their own picture; false when it shows the stand-in.
hashtext
Gravatar's anonymous id for the email address (its SHA-256 hash). Every Gravatar step accepts it in place of the address.
image_tagtext
The same link as an HTML <img> tag with its size, for a step that writes an email or a page.
looked_uptext
The email address (lower-cased) or username the step looked up, so a result can be matched back to its row.
ratingtext
The most mature rating allowed: 'g', 'pg', 'r' or 'x'.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save as a file). The file fields are empty otherwise.
sizenumber
The picture's width and height in pixels.
summarytext
One line saying whether they have a picture of their own.
updated_attext
When they last changed their picture, as an ISO 8601 time in UTC, e.g. '2014-11-16T16:29:04Z'. Null when they have no picture.
urltext
A link to the picture, ready for a CRM photo field, a chat message or an email. It always shows something: their own picture, or the stand-in chosen for people without one. It stays current when they change their picture.
Example output
{
  "content_type": "",
  "default_image": "mp",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "has_avatar": true,
  "hash": "33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
  "image_tag": "<img src=\"https://gravatar.com/avatar/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5?s=256&amp;d=mp\" alt=\"Profile picture\" width=\"256\" height=\"256\">",
  "looked_up": "m@mullenweg.com",
  "rating": "g",
  "saved_as_file": false,
  "size": 256,
  "summary": "m@mullenweg.com has a Gravatar picture, last changed 2014-11-16",
  "updated_at": "2014-11-16T16:29:04Z",
  "url": "https://gravatar.com/avatar/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5?s=256&d=mp"
}

Get profile

Look up the public Gravatar profile behind an email address: the person's name, photo, About text, location, job title, company, pronouns and the social accounts Gravatar has verified for them (up to four). Useful for filling in a new contact or lead from nothing but their email. An address with no public profile comes back with Found set to false instead of failing the step. No API key required.

Inputs

Email addressemailtextRequired
The person's email address. Their Gravatar username (the matt in gravatar.com/matt) or profile link works too.

Outputs

abouttext
The About section of their profile.
avatar_alt_texttext
The description they wrote of their picture, if any.
avatar_urltext
A link to their profile picture at Gravatar's default 80 pixels. Use Get avatar for another size or a saved file.
companytext
The company they work for.
display_nametext
The name the person shows on their profile.
foundtrue/false
True when the person has a public Gravatar profile. False means they have none (or have hidden it), and every other detail is empty. Gravatar only finds a profile by its main email address, so an address someone added as a second one can have a picture (see Check for a Gravatar) but no profile.
hashtext
Gravatar's anonymous id for the email address (its SHA-256 hash). Every Gravatar step accepts it in place of the address.
job_titletext
Their job title.
locationtext
Where they say they are, as they wrote it, e.g. 'New York, USA'.
looked_uptext
The email address (lower-cased) or username the step looked up, so a result can be matched back to its row.
profile_urltext
Their public profile page, e.g. https://gravatar.com/matt.
pronounstext
Their pronouns, e.g. 'She/They'.
pronunciationtext
How to say their name, e.g. 'Al-ex Mor-gan'.
summarytext
One line about them, e.g. 'Alex Morgan, Landscape Architect at ACME Corp, New York, USA', or saying no profile was found.
usernametext
Their Gravatar username: the matt in gravatar.com/matt. Every Gravatar step accepts it in place of the email address.
verified_accountslist
Accounts on other services (GitHub, LinkedIn, X...) that Gravatar has confirmed belong to them. Gravatar shows at most four without an API key.
Example output
{
  "about": "Sorry, this is not my name. Just an example, you know.",
  "avatar_alt_text": "User's avatar",
  "avatar_url": "https://0.gravatar.com/avatar/99511d6010af8c574c31f94e1b327bba5e25086dd7b92a4b6f3e132b579cc8d1",
  "company": "EG Inc",
  "display_name": "Example",
  "found": true,
  "hash": "99511d6010af8c574c31f94e1b327bba5e25086dd7b92a4b6f3e132b579cc8d1",
  "job_title": "Chief",
  "location": "E.G.",
  "looked_up": "examplefork",
  "profile_url": "https://gravatar.com/examplefork",
  "pronouns": "He/Him",
  "pronunciation": null,
  "summary": "Example, Chief at EG Inc, E.G.",
  "username": "examplefork",
  "verified_accounts": []
}

Get profile QR code

Get a QR code that opens someone's Gravatar profile when scanned, for a name badge, a business card or an email signature. Choose its size, its style and what sits in the middle, and optionally save it as a PNG file. People without a public profile are refused, since their code would open an empty page. No API key required.

Inputs

Email addressemailtextRequired
The person's email address. Their Gravatar username (the matt in gravatar.com/matt) or profile link works too.
Size (pixels)sizenumber
Optional. How wide and tall the code is, from 80 to 1024 pixels; 512 by default.From 80 to 1024. Default: 512.
Stylestyletext
Optional. Classic squares by default.One of: squares (Classic squares), dots (Rounded dots (300 pixels or larger)). Default: squares.
In the middlecentertext
Optional. Their profile picture by default.One of: avatar (Their profile picture), gravatar_logo (The Gravatar logo), none (Nothing). Default: avatar.
Also save as a filesave_as_filetrue/false
Off by default, because the link is all a CRM field, a chat message or an email needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage or adding it to a document.Default: false.

Outputs

centertext
What sits in the middle: 'avatar' (their picture), 'gravatar_logo' or 'none'.
content_typetext
The saved file's type, or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
hashtext
Gravatar's anonymous id for the email address (its SHA-256 hash). Every Gravatar step accepts it in place of the address.
image_tagtext
The same link as an HTML <img> tag with its size.
looked_uptext
The email address (lower-cased) or username the step looked up, so a result can be matched back to its row.
openstext
The profile page a phone opens when it scans the code.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save as a file). The file fields are empty otherwise.
sizenumber
The code's width and height in pixels.
styletext
'squares' (classic) or 'dots' (rounded dots).
urltext
A link to the QR code as a PNG, ready for an email or a page. Each time it is opened counts against Gravatar's allowance of 60 QR codes an hour for whoever opens it, so save it as a file for anything printed or sent widely.
Example output
{
  "center": "avatar",
  "content_type": "image/png",
  "document_ref": "doc_gravatar_qr",
  "documents": [
    {
      "content_type": "image/png",
      "document_ref": "doc_gravatar_qr",
      "filename": "gravatar-m-mullenweg-com-qr-code.png",
      "size_bytes": 25731,
      "url": "/actions/core/serve-document/doc_gravatar_qr"
    }
  ],
  "file_size_bytes": 25731,
  "file_url": "/actions/core/serve-document/doc_gravatar_qr",
  "hash": "33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
  "image_tag": "<img src=\"https://api.gravatar.com/v3/qr-code/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5?size=512&amp;version=1&amp;type=user\" alt=\"QR code for a Gravatar profile\" width=\"512\" height=\"512\">",
  "looked_up": "m@mullenweg.com",
  "opens": "https://gravatar.com/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
  "saved_as_file": true,
  "size": 512,
  "style": "squares",
  "url": "https://api.gravatar.com/v3/qr-code/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5?size=512&version=1&type=user"
}

On this page