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
| Action | What it does |
|---|---|
| Check for a Gravatar | Check whether an email address has a Gravatar picture, and when it last changed. |
| 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. |
| 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. |
| 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). |
| 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. |
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 address
emailtextRequired - The person's email address. Their Gravatar username (the matt in gravatar.com/matt) or profile link works too.
- Most mature picture to show
ratingtext - 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
- Username
usernametextRequired - Their username on the other service, such as photomatt. A leading @ or a link to their page there is fine.
- Service
servicetext - Optional. Only look for the username on this service. Leave blank to match it on any service.
- Results per page
limitnumber - Optional. From 5 to 50; 20 by default.From 5 to 50. Default:
20. - Page
pagenumber - 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 address
emailtextRequired - The person's email address. Their Gravatar username (the matt in gravatar.com/matt) or profile link works too.
- Size
sizetext - 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, show
default_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 initials
initials_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 show
ratingtext - 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 file
save_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&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 address
emailtextRequired - 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 address
emailtextRequired - 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. - Style
styletext - Optional. Classic squares by default.One of:
squares(Classic squares),dots(Rounded dots (300 pixels or larger)). Default:squares. - In the middle
centertext - 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 file
save_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&version=1&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"
}