v1

latestOpenAPI 3.1.02026-07-17131141.1 KB

experimental

Search for profiles by verified account username

Searches Gravatar profiles that have a verified account with the given username. Optionally filter by the service (e.g., 'github', 'twitter'). See /verified-accounts/services for supported ID values. Results are paginated.

get/profiles/search/by-verified-account

Query parameters

usernamestring required

The username used on the verified third-party service.

servicestring

The service to limit search to (e.g., 'github', 'twitter'). See /verified-accounts/services for supported IDs.

pageinteger

Page number of results to retrieve.

per_pageinteger

Number of results per page. Defaults to 20, maximum 50.

Response

List of matching profiles

total_pagesinteger required

Total number of pages available.

Example response

{
  "profiles": [
    {
      "user_id": 1234567890,
      "user_login": "alex",
      "hash": "31c5543c1734d25c7206f5fd591525d0295bec6fe84ff82f946a34fe970a1e66",
      "display_name": "Alex Morgan",
      "profile_url": "https://gravatar.com/example",
      "avatar_url": "https://0.gravatar.com/avatar/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5",
      "avatar_alt_text": "Alex Morgan's avatar image. Alex is smiling and standing in beside a large dog who is looking up at Alex.",
      "location": "New York, USA",
      "description": "I like playing hide and seek.",
      "job_title": "Landscape Architect",
      "company": "ACME Corp",
      "verified_accounts": [
        {
          "service_type": "tumblr",
          "service_label": "Tumblr",
          "service_icon": "https://gravatar.com/icons/tumblr-alt.svg",
          "url": "https://example.tumblr.com/"
        }
      ],
      "pronunciation": "Al-ex Mor-gan",
      "pronouns": "She/They",
      "timezone": "Europe/Bratislava",
      "languages": [
        {
          "code": "en",
          "name": "English",
          "is_primary": true,
          "order": 1
        }
      ],
      "first_name": "Alex",
      "last_name": "Morgan",
      "header_image": "url('https://gravatar.com/userimage/209234789/cdebd0ed415kfa2g562ba5c34b1570c2') no-repeat 50% 1% / 100%",
      "background_color": "rgb(33, 0, 166)",
      "links": [
        {
          "label": "Personal Website",
          "url": "https://example.com"
        }
      ],
      "interests": [
        {
          "id": 1,
          "name": "photography"
        }
      ],
      "payments": {
        "links": [
          {
            "label": "Personal Website",
            "url": "https://example.com"
          }
        ],
        "crypto_wallets": [
          {
            "label": "ETH",
            "address": "0xABC123..."
          }
        ]
      },
      "contact_info": {
        "home_phone": "+1-555-555-0100",
        "work_phone": "+1-555-555-0101",
        "cell_phone": "+1-555-555-0102",
        "email": "alex@example.com",
        "contact_form": "https://example.com/contact-me",
        "calendar": "https://example.com/calendar"
      },
      "gallery": [
        {
          "url": "https://0.gravatar.com/userimage/5/04bbd674f72c703f6335e2e7a00acc9a",
          "alt_text": "A beautiful sunset"
        }
      ],
      "number_verified_accounts": 3,
      "last_profile_edit": "2021-10-01T12:00:00Z",
      "registration_date": "2021-10-01T12:00:00Z"
    }
  ],
  "total_pages": 5
}