Image

Get Gravatar Avatar

0calls

2 credits / call

Provides stable and easy-to-use avatar retrieval capability, suitable for directly displaying avatars on web pages or in applications.

Query parameters

email

stringoptional

User's Email address. If hash parameter is not provided, this parameter is required.

hash

stringoptional

Lowercase MD5 hash of user's Email address. If this parameter is provided, the email parameter will be ignored.

s

integeroptional

Avatar size, in pixels. Valid range is 1 to 2048.

d

stringoptional

Default avatar type displayed when user does not have their own Gravatar avatar. Optional values include mp, identicon, monsterid, wavatar, retro, robohash, blank, 404.

r

stringoptional

Avatar rating. Optional values: g, pg, r, x.

Name	Type	Attributes	Description
`email`	string	optional	User's Email address. If `hash` parameter is not provided, this parameter is required.
`hash`	string	optional	Lowercase MD5 hash of user's Email address. If this parameter is provided, the `email` parameter will be ignored.
`s`	integer	optional	Avatar size, in pixels. Valid range is 1 to 2048.
`d`	string	optional	Default avatar type displayed when user does not have their own Gravatar avatar. Optional values include `mp`, `identicon`, `monsterid`, `wavatar`, `retro`, `robohash`, `blank`, `404`.
`r`	string	optional	Avatar rating. Optional values: `g`, `pg`, `r`, `x`.

Response

200 / OK

Successful response, returns image binary data.

image/*

400 / Bad Request

When neither email nor hash parameter is provided in the request.

JSON

404 / Not Found

When d=404 and the requested email or hash has no corresponding Gravatar avatar.

JSON

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/avatar/gravatar'

Frequently asked questions

Are there any special restrictions for the Get Gravatar Avatar API?

Get Gravatar Avatar follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

PreviousLossless Image Compression

NextUniversal OCR Text Recognition