{"openapi":"3.1.0","info":{"title":"Gravatar API","version":"1.0.0","description":"Turn an email address into its Gravatar avatar and public profile. Pass an email and the service normalises it, computes the MD5 and SHA-256 hashes Gravatar uses, builds a ready-to-use avatar URL, checks whether a custom Gravatar actually exists, and fetches the public profile when present — display name, username, profile URL, location, about text, linked accounts and photos. A dedicated avatar endpoint builds just the image URL with full options: size (1-2048), a default image (identicon, monsterid, robohash, retro, mp, blank, 404, or your own URL), rating and force-default. Ideal for user-profile enrichment, comment systems, contact cards, team pages and onboarding — showing a real avatar from nothing but an email. A Gravatar lookup — distinct from deterministic avatar/identicon generation (avatar), which renders a brand-new image from a seed rather than fetching the avatar a person actually chose. No upstream key, no cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/gravatar-api","description":"oanor gateway"}],"tags":[{"name":"Gravatar"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/avatar":{"get":{"operationId":"get_v1_avatar","tags":["Gravatar"],"summary":"Build the avatar URL","description":"","parameters":[{"name":"email","in":"query","required":true,"description":"Email address","schema":{"type":"string"},"example":"test@example.com"},{"name":"size","in":"query","required":false,"description":"Avatar size 1-2048","schema":{"type":"string"},"example":"200"},{"name":"default","in":"query","required":false,"description":"identicon, monsterid, robohash, retro, mp, 404, blank","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"email":"test@example.com","hash_md5":"55502f40dc8b7c769880b10874abc9d0","avatar_url":"https://gravatar.com/avatar/55502f40dc8b7c769880b10874abc9d0?s=200","hash_sha256":"973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b"},"meta":{"timestamp":"2026-06-01T23:40:42.451Z","request_id":"fcae90cb-c82c-487a-b875-7cabe4b03f09"},"status":"ok","message":"Avatar URL built","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/lookup":{"get":{"operationId":"get_v1_lookup","tags":["Gravatar"],"summary":"Avatar + existence + profile","description":"","parameters":[{"name":"email","in":"query","required":true,"description":"Email address","schema":{"type":"string"},"example":"beau@dentedreality.com.au"},{"name":"size","in":"query","required":false,"description":"Avatar size 1-2048","schema":{"type":"string"}},{"name":"default","in":"query","required":false,"description":"Default image style","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"email":"beau@dentedreality.com.au","profile":{"about":"Lead of WooCommerce, at Automattic. Previously Jetpack, WordPress.com and more. I've been building the web for over 20 years.","photos":["https://0.gravatar.com/avatar/22bd03ace6f176bfe0c593650bcf45d8"],"accounts":[{"url":"https://x.com/beaulebens","name":"twitter"},{"url":"https://www.linkedin.com/in/beaulebens","name":"linkedin"},{"url":"https://github.com/beaulebens","name":"github"},{"url":"https://instagram.com/beaulebens","name":"instagram"}],"location":"Golden, CO","username":"beau","thumbnail":"https://0.gravatar.com/avatar/22bd03ace6f176bfe0c593650bcf45d8","profile_url":"https://gravatar.com/beau","display_name":"Beau Lebens"},"hash_md5":"205e460b479e2e5b48aec07710c08d50","avatar_url":"https://gravatar.com/avatar/205e460b479e2e5b48aec07710c08d50","has_avatar":true,"has_profile":true,"hash_sha256":"a919f0e9932ec2c866cf67ec327efb57b47ff3085acd375529af076d1ac56f27"},"meta":{"timestamp":"2026-06-01T23:40:43.488Z","request_id":"cd2534d4-b862-4f0f-98c6-1a8886a8dd90"},"status":"ok","message":"Gravatar looked up","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Defaults & size range","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Turn an email address into its Gravatar avatar and public profile. /v1/lookup?email=user@example.com normalises the address, computes the MD5 and SHA-256 hashes Gravatar uses, builds the avatar URL, checks whether a custom Gravatar actually exists (has_avatar), and fetches the public profile when present — display name, username, profile URL, location, about, linked accounts and photos. /v1/avatar builds just the avatar URL with options: size (1-2048), a default image (identicon, monsterid, robohash, retro, mp, 404, blank or your own https URL), forcedefault and rating. Computation is local; the lookup makes live calls to gravatar.com. Ideal for user-profile enrichment, comment systems, contact cards and onboarding — showing a real avatar from an email. A Gravatar lookup — distinct from deterministic avatar/identicon generation (avatar), which makes a new image from a seed rather than fetching a person's chosen Gravatar. No key, no cache.","endpoints":["/v1/lookup","/v1/avatar","/v1/meta"],"size_range":[1,2048],"default_images":["404","mp","identicon","monsterid","wavatar","retro","robohash","blank"]},"meta":{"timestamp":"2026-06-01T23:40:43.567Z","request_id":"f322b5c4-c322-417d-a957-54c420422a53"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2120,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":625,"monthly_call_quota":41000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2040,"monthly_call_quota":216000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5310,"monthly_call_quota":820000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/gravatar-api"}