Gravatar Lookup
Gravatar Lookup is a simple tool for looking up Gravatar profiles. It returns the Gravatar profile information of the email address provided.
This API provides reliable and fast access to gravatar lookup data through a simple REST interface. Built for developers who need consistent, high-quality results with minimal setup time.
To use this API, you need an API key. You can get one by creating a free account and visiting your dashboard.
View API in DirectoryEndpoint
GET https://api.apiverve.com/v1/gravatarlookup
Code Examples
Here are examples of how to call this API in different programming languages:
curl -X GET \
"https://api.apiverve.com/v1/[email protected]" \
-H "X-API-Key: your_api_key_here"
const response = await fetch('https://api.apiverve.com/v1/gravatarlookup', {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);
import requests
headers = {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
response = requests.get('https://api.apiverve.com/v1/gravatarlookup', headers=headers)
data = response.json()
print(data)
const https = require('https');
const url = require('url');
const options = {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
};
const req = https.request('https://api.apiverve.com/v1/gravatarlookup', options, (res) => {
let data = '';
res.on('data', (chunk) => data += chunk);
res.on('end', () => console.log(JSON.parse(data)));
});
req.end();
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.apiverve.com/v1/gravatarlookup');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-Key: your_api_key_here',
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
?>
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/gravatarlookup", nil)
req.Header.Set("X-API-Key", "your_api_key_here")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
require 'net/http'
require 'json'
uri = URI('https://api.apiverve.com/v1/gravatarlookup')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'your_api_key_here'
request['Content-Type'] = 'application/json'
response = http.request(request)
puts JSON.pretty_generate(JSON.parse(response.body))
Authentication
This API requires authentication via API key. Include your API key in the request header:
X-API-Key: your_api_key_here
Parameters
The following parameters are available for this API endpoint:
Parameter | Type | Required | Location | Description | Example |
---|---|---|---|---|---|
string | Yes | query | The email address to lookup the Gravatar profile of | [email protected] |
Response
The API returns responses in JSON, XML, and YAML formats:
Example Responses
{
"status": "ok",
"error": null,
"data": {
"profileUrl": "https://gravatar.com/apiverve",
"thumbnailUrl": "https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db",
"photos": [
{
"value": "https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db",
"type": "thumbnail"
}
],
"displayName": "APIVerve",
"aboutMe": "APIVerve stands out as a premier source for cloud-based API and Software-as-a-Service (SaaS) solutions catering to developers, startups and products.\n\nAt APIVerve, we take pride in being a leading provider of cutting-edge cloud-based API and Software-as-a-Service (SaaS) solutions tailored to meet the diverse needs and unlock new possibilities across various industries.",
"currentLocation": "United States",
"company": "APIVerve",
"contactInfo": [
{
"type": "contactform",
"value": "apiverve.com/contact"
}
],
"accounts": [
{
"domain": "twitter.com",
"display": "@apivervehq",
"url": "https://twitter.com/apivervehq",
"iconUrl": "https://gravatar.com/icons/twitter-alt.svg",
"is_hidden": false,
"username": "apivervehq",
"verified": true,
"name": "Twitter",
"shortname": "twitter"
},
{
"domain": "github.com",
"display": "apivervehq",
"url": "https://github.com/apivervehq",
"iconUrl": "https://gravatar.com/icons/github.svg",
"is_hidden": true,
"username": "apivervehq",
"verified": true,
"name": "GitHub",
"shortname": "github"
},
{
"domain": "calendly.com",
"display": "apiverve",
"url": "https://calendly.com/apiverve",
"iconUrl": "https://gravatar.com/icons/calendly.svg",
"is_hidden": false,
"username": "calendly.com",
"verified": true,
"name": "Calendly",
"shortname": "calendly"
}
],
"username": "apiverve"
}
}
<Root>
<status>ok</status>
<error />
<data>
<profileUrl>https://gravatar.com/apiverve</profileUrl>
<thumbnailUrl>https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db</thumbnailUrl>
<photos>
<value>https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db</value>
<type>thumbnail</type>
</photos>
<displayName>APIVerve</displayName>
<aboutMe>APIVerve stands out as a premier source for cloud-based API and Software-as-a-Service (SaaS) solutions catering to developers, startups and products.
At APIVerve, we take pride in being a leading provider of cutting-edge cloud-based API and Software-as-a-Service (SaaS) solutions tailored to meet the diverse needs and unlock new possibilities across various industries.</aboutMe>
<currentLocation>United States</currentLocation>
<company>APIVerve</company>
<contactInfo>
<type>contactform</type>
<value>apiverve.com/contact</value>
</contactInfo>
<accounts>
<domain>twitter.com</domain>
<display>@apivervehq</display>
<url>https://twitter.com/apivervehq</url>
<iconUrl>https://gravatar.com/icons/twitter-alt.svg</iconUrl>
<is_hidden>false</is_hidden>
<username>apivervehq</username>
<verified>true</verified>
<name>Twitter</name>
<shortname>twitter</shortname>
</accounts>
<accounts>
<domain>github.com</domain>
<display>apivervehq</display>
<url>https://github.com/apivervehq</url>
<iconUrl>https://gravatar.com/icons/github.svg</iconUrl>
<is_hidden>true</is_hidden>
<username>apivervehq</username>
<verified>true</verified>
<name>GitHub</name>
<shortname>github</shortname>
</accounts>
<accounts>
<domain>calendly.com</domain>
<display>apiverve</display>
<url>https://calendly.com/apiverve</url>
<iconUrl>https://gravatar.com/icons/calendly.svg</iconUrl>
<is_hidden>false</is_hidden>
<username>calendly.com</username>
<verified>true</verified>
<name>Calendly</name>
<shortname>calendly</shortname>
</accounts>
<username>apiverve</username>
</data>
</Root>
status: ok
error:
data:
profileUrl: https://gravatar.com/apiverve
thumbnailUrl: https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db
photos:
- value: https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db
type: thumbnail
displayName: APIVerve
aboutMe: >-
APIVerve stands out as a premier source for cloud-based API and Software-as-a-Service (SaaS) solutions catering to developers, startups and products.
At APIVerve, we take pride in being a leading provider of cutting-edge cloud-based API and Software-as-a-Service (SaaS) solutions tailored to meet the diverse needs and unlock new possibilities across various industries.
currentLocation: United States
company: APIVerve
contactInfo:
- type: contactform
value: apiverve.com/contact
accounts:
- domain: twitter.com
display: '@apivervehq'
url: https://twitter.com/apivervehq
iconUrl: https://gravatar.com/icons/twitter-alt.svg
is_hidden: false
username: apivervehq
verified: true
name: Twitter
shortname: twitter
- domain: github.com
display: apivervehq
url: https://github.com/apivervehq
iconUrl: https://gravatar.com/icons/github.svg
is_hidden: true
username: apivervehq
verified: true
name: GitHub
shortname: github
- domain: calendly.com
display: apiverve
url: https://calendly.com/apiverve
iconUrl: https://gravatar.com/icons/calendly.svg
is_hidden: false
username: calendly.com
verified: true
name: Calendly
shortname: calendly
username: apiverve
Response Structure
All API responses follow a consistent structure with the following fields:
Field | Type | Description | Example |
---|---|---|---|
status | string | Indicates whether the request was successful ("ok") or failed ("error") | ok |
error | string | null | Contains error message if status is "error", otherwise null | null |
data | object | null | Contains the API response data if successful, otherwise null | {...} |
Response Data Fields
When the request is successful, the data
object contains the following fields:
Field | Type | Sample Value |
---|---|---|
profileUrl | string | "https://gravatar.com/apiverve" |
thumbnailUrl | string | "https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db" |
photos | array | [{"value":"https://0.gravatar.com/avatar/08ccd5c0bdd88b0ac13f776a4f7914db","type":"thumbnail"}] |
displayName | string | "APIVerve" |
aboutMe | string | "APIVerve stands out as a premier source for cloud-based API and Software-as-a-Service (SaaS) solutions catering to developers, startups and products. At APIVerve, we take pride in being a leading provider of cutting-edge cloud-based API and Software-as-a-Service (SaaS) solutions tailored to meet the diverse needs and unlock new possibilities across various industries." |
currentLocation | string | "United States" |
company | string | "APIVerve" |
contactInfo | array | [{"type":"contactform","value":"apiverve.com/contact"}] |
accounts | array | [{"domain":"twitter.com","display":"@apivervehq","url":"https://twitter.com/apivervehq","iconUrl":"https://gravatar.com/icons/twitter-alt.svg","is_hidden":false,"username":"apivervehq","verified":true,"name":"Twitter","shortname":"twitter"}, ...] |
username | string | "apiverve" |
Headers
Required and optional headers for API requests:
Header Name | Required | Example Value | Description |
---|---|---|---|
X-API-Key | Yes | your_api_key_here | Your APIVerve API key. Found in your dashboard under API Keys. |
Accept | No | application/json | Specify response format: application/json (default), application/xml, or application/yaml |
User-Agent | No | MyApp/1.0 | Identifies your application for analytics and debugging purposes |
X-Request-ID | No | req_123456789 | Custom request identifier for tracking and debugging requests |
Cache-Control | No | no-cache | Control caching behavior for the request and response |
Client Libraries
To get started with minimal code, most of our APIs are available through client libraries and clients:
Error Codes
The API uses standard HTTP status codes to indicate success or failure:
Status Code | Message | Description |
---|---|---|
200 | OK | Request successful, data returned |
400 | Bad Request | Invalid request parameters or malformed request |
401 | Unauthorized | Missing or invalid API key |
403 | Forbidden | API key does not have permission for this endpoint |
429 | Too Many Requests | Rate limit exceeded, please slow down requests |
500 | Internal Server Error | Server error, please try again later |
Was this page helpful?
Help us improve our documentation