Note: You can play with our free public API data via our Developer Console.
Profile
A user’s profile information.
Properties:
hash:
SHA256 hash of the user’s primary email addressdisplay_name:
The user’s display nameprofile_url:
Full URL for the user’s profileavatar_url:
URL for the user’s avatar imageavatar_alt_text:
Alt text for the user’s avatar imagelocation:
User’s locationdescription:
About section on user’s profilejob_title:
User’s job titlecompany:
User’s current company nameverified_accounts:
List of verified accountspronunciation:
Phonetic pronunciation of user’s namepronouns:
User’s pronounstimezone:
User’s timezonelanguages:
Languages the user knowsfirst_name:
User’s first namelast_name:
User’s last nameis_organization:
Whether user is an organizationheader_image:
Header image used in profile cardbackground_color:
Profile background colorlinks:
List of links added to profileinterests:
List of interests added to profilepayments:
User’s public payment informationcontact_info:
User’s contact informationgallery:
Additional images uploaded by usernumber_verified_accounts:
Count of verified accountslast_profile_edit:
When user last edited profileregistration_date:
When user registered account
Avatar
An avatar that a user has uploaded to their Gravatar account.
Properties:
image_id:
Unique identifier for the imageimage_url:
Image URLrating:
Rating associated with image (G, PG, R, X)alt_text:
Alternative text description of imageselected:
Whether image is currently selectedupdated_date:
Date and time when image was last updated
VerifiedAccount
A verified account on a user’s profile.
Properties:
service_type:
Type of serviceservice_label:
Name of serviceservice_icon:
URL to service’s iconurl:
URL to user’s profile on serviceis_hidden:
Whether account is hidden from profile
Link
A link added to a user’s profile.
Properties:
- label: Label for the link
- url: URL to the link
Interest
An interest added to a user’s profile.
Properties:
- id: Unique identifier for interest
- name: Name of interest
Get Inferred Interests by Identifier *Experimental
Returns a list of inferred interests based on known and public information about the profile.
Endpoint: GET /profiles/{profileIdentifier}/inferred-interests
CryptoWalletAddress
A cryptocurrency wallet address the user accepts.
Properties:
- label: Label for the cryptocurrency
- address: Wallet address for the cryptocurrency
GalleryImage
A gallery image a user has uploaded.
Properties:
- url: The URL to the image
- alt_text: The image alt text
Language
The languages the user knows.
Properties:
- code: The language code
- name: The language name
- is_primary: Whether the language is the user’s primary language
order: The order of the language in the user’s profile
OpenAPI Specifications (formerly Swagger)
Gravatar offers a machine-readable OpenAPI Specification (OAS) for API version 3.0.0
This specification provides a complete and standardized description of the Gravatar API, making it easy to explore, understand, and integrate with your own applications.
The complete API specification is available at: