Gravatar

Gravatar (Globally Recognized Avatar) is a service that provides universally recognized avatars and rich identity profiles tied to email addresses via SHA256 hash. Developers can fetch user avatars, profile information, verified social accounts, and identity data using a REST API with API key or OAuth authentication. The service offers both a public avatar CDN (no auth required) and a REST API (v3) for profiles, avatar management, QR codes, and verified account lookups.

2 APIs 0 Features

AvatarsIdentityProfilesSocialImagesGraphQLREST

APIs

Gravatar Avatar API

Public CDN-based API for fetching user avatars by SHA256 email hash. Supports image size customization, default image fallbacks, and content rating filters. Avatar requests do n...

Gravatar REST API

REST API (v3) for retrieving and managing Gravatar user profiles, avatars, QR codes, and verified account lookups by SHA256 email hash or profile slug. Supports API key (Bearer ...

GraphQL

Gravatar GraphQL

Gravatar does not expose a native GraphQL endpoint. This schema is a conceptual GraphQL representation of the Gravatar REST API v3, derived from the public REST types documented...

GRAPHQL

Pricing Plans

Plans

2 plans

PLANS

Rate Limits

Rate Limits

0 limits

RATE LIMITS

FinOps

Finops

FINOPS

Semantic Vocabularies

context Context

0 classes · 40 properties

JSON-LD

Example Payloads

Associatedemail

7 fields

EXAMPLE

Deleteavatar

7 fields

EXAMPLE

Getavatars

7 fields

EXAMPLE

Getprofile

8 fields

EXAMPLE

Getprofilebyid

7 fields

EXAMPLE

Getqrcodebysha256Hash

7 fields

EXAMPLE

Getverifiedaccountservices

7 fields

EXAMPLE

Searchprofilesbyverifiedaccount

7 fields

EXAMPLE

Setemailavatar

7 fields

EXAMPLE

Updateavatar

7 fields

EXAMPLE

Updateprofile

8 fields

EXAMPLE

Uploadavatar

8 fields

EXAMPLE

Resources

Documentation

GettingStarted

Authentication

GitHubOrganization

GitHubOrganization

APIExplorer

TermsOfService

PrivacyPolicy

Sources

aid: gravatar
name: Gravatar
description: Gravatar (Globally Recognized Avatar) is a service that provides universally recognized avatars and rich identity
  profiles tied to email addresses via SHA256 hash. Developers can fetch user avatars, profile information, verified social
  accounts, and identity data using a REST API with API key or OAuth authentication. The service offers both a public avatar
  CDN (no auth required) and a REST API (v3) for profiles, avatar management, QR codes, and verified account lookups.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/gravatar/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
type: Index
tags:
- Avatars
- Identity
- Profiles
- Social
- Images
- GraphQL
- REST
apis:
- aid: gravatar:avatar-api
  name: Gravatar Avatar API
  description: Public CDN-based API for fetching user avatars by SHA256 email hash. Supports image size customization, default
    image fallbacks, and content rating filters. Avatar requests do not count against rate limits.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.gravatar.com/api/avatars/
  baseURL: https://0.gravatar.com
  tags:
  - Avatars
  - Images
  - CDN
  properties:
  - type: Documentation
    url: https://docs.gravatar.com/api/avatars/
  - type: OpenAPI
    url: https://api.gravatar.com/v3/openapi
- aid: gravatar:rest-api
  name: Gravatar REST API
  description: REST API (v3) for retrieving and managing Gravatar user profiles, avatars, QR codes, and verified account lookups
    by SHA256 email hash or profile slug. Supports API key (Bearer token) and WordPress OAuth2 authentication. Unauthenticated
    requests are limited to 100/hour; authenticated requests receive 1,000/hour.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.gravatar.com/rest-api/
  baseURL: https://api.gravatar.com/v3
  tags:
  - Profiles
  - Avatars
  - Identity
  - Verified Accounts
  - QR Codes
  properties:
  - type: Documentation
    url: https://docs.gravatar.com/rest-api/
  - type: OpenAPI
    url: https://api.gravatar.com/v3/openapi
  - type: GettingStarted
    url: https://docs.gravatar.com/rest/getting-started/
  - type: Authentication
    url: https://docs.gravatar.com/rest/getting-started/#authentication
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/gravatar/refs/heads/main/rate-limits/rate-limits.yml
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/gravatar/refs/heads/main/plans/plans.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/gravatar/refs/heads/main/finops/finops.yml
  - url: graphql/gravatar-graphql.md
    type: GraphQL
common:
- type: Portal
  url: https://docs.gravatar.com/
- type: Documentation
  url: https://docs.gravatar.com/api/
- type: OpenAPI
  url: https://api.gravatar.com/v3/openapi
- type: GettingStarted
  url: https://docs.gravatar.com/rest/getting-started/
- type: Authentication
  url: https://docs.gravatar.com/rest/getting-started/#authentication
- type: Pricing
  url: https://docs.gravatar.com/general/pricing/
- type: Status
  url: http://status.automattic.com/9931/136545/Gravatar
- type: GitHubOrganization
  url: https://github.com/Automattic/gravatar
- type: AndroidSDK
  url: https://docs.gravatar.com/sdk/android/
- type: iOSSDK
  url: https://docs.gravatar.com/sdk/ios/
- type: APIExplorer
  url: https://docs.gravatar.com/api/explorer/
- type: TermsOfService
  url: https://gravatar.com/tos
- type: PrivacyPolicy
  url: https://gravatar.com/privacy-policy
maintainers:
- FN: Kin Lane
  X-twitter: kinlane
  email: kin@apievangelist.com