Kimlik ve Doğrulama

Avatar ve logo sorgulama API'si

Her kullanıcının, potansiyel müşterinin ve şirketin yanında gerçek bir yüz veya logo gösterin. Bir e-posta adresi, kullanıcı adı veya alan adı gönderin; en iyi doğrulanmış görseli, nereden geldiğini ve görsel yoksa dürüst bir yanıt alın.

Dokümantasyonu görüntüle Tüm API'leri keşfedin

Uç Noktalar Aktif

GET /v1/avatar

Örnek istek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Örnek yanıt 200 OK

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates"
...

Örnek istek GET /v1/avatar

Temel Özellikler 4

Sık sorulan sorular 4

HTTP durum kodları 200 / 400 / 401 / 402 / 429

Kategori Kimlik ve Doğrulama

Uç Noktalar 1

Temel Özellikler 4

Sık sorulan sorular 4

Bu şirketlerdeki kişiler tarafından kullanılıyor

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

1.000 Ücretsiz hak

Her UTC takvim ayı için 1.000 ücretsiz krediyle başlayın. İsterseniz aylık bir plan seçin veya daha fazlasına ihtiyacınız varsa tek seferlik bir paket satın alın.

Bu API neyi yayına almanıza yardımcı olur

Bu sayfayı üretim özeti olarak kullanın: endpointler, örnekler, yanıt yapısı ve DomScan’i ürününüze bağlamak için gereken workflow parçaları.

Ürün workflow’ları

Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.

Analist otomasyonu

Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.

Temiz JSON verisi

Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.

AI ve ops araçları

OpenAPI, SDK, Postman veya MCP üzerinden agent’ları, panoları, SOAR playbook’larını ve CRM’leri besleyin.

Entegrasyon workflow’u

İlk istekten tekrarlanabilir üretim kullanımına giden basit yol.

Bir kez doğrulayın

API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.

Örneklerle sorgulayın

curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.

İşletin ve izleyin

Retry, log ve uyarılar için durum kodlarını, kredi maliyetlerini ve yanıt alanlarını kullanın.

Geliştirici kiti

Bu sayfadan makine tarafından okunabilir dokümanlara, istek koleksiyonlarına, SDK’lere veya agent araçlarına geçin.

OpenAPI şeması

Client üretin veya her istek ve yanıt şeklini inceleyin.

Postman koleksiyonu

Manuel test ve ekip devri için hazır istekleri içe aktarın.

SDK’ler ve CLI

Boilerplate yazmak yerine bakımı yapılan paketleri ve komut satırı workflow’larını kullanın.

MCP entegrasyonu

Domain intelligence’ı AI agent’larına ve dahili asistan workflow’larına açın.

Parametre ve yanıt haritası

Endpoint’i client’ınıza bağlamadan önce girdileri, çıktı alanlarını ve durum kodlarını tarayın.

İstek parametreleri

Parametre

emailusernameplatformdomain

Yanıt alanları

Örnek yanıt

inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates

Durum kapsamı

HTTP durum kodları

200400401402429

Uç Noktalar

GET /v1/avatar

Kredi: 2Kimlik Doğrulama: Kimlik dogrulama gerekli

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

1.000 Ücretsiz hak

Her UTC takvim ayı için 1.000 ücretsiz krediyle başlayın. İsterseniz aylık bir plan seçin veya daha fazlasına ihtiyacınız varsa tek seferlik bir paket satın alın.

Temel Özellikler

E-posta, kullanıcı adı veya alan adı

E-posta adresleri, herkese açık avatar hizmetleri ve posta alan adının şirket logosuyla eşleştirilir. Kullanıcı adları GitHub, Bluesky, Mastodon ve Keybase üzerinde kontrol edilir. Alan adları web sitesinin logosunu döndürür.

Yalnızca doğrulanmış görseller

Döndürülen her görsel indirilir ve gerçekten bir görsel olduğu doğrulanır. Hata sayfaları, bozuk bağlantılar ve varsayılan yer tutucular asla döndürülmez.

Her kaynak için kanıt

Her kaynak, nedeniyle birlikte present, absent veya unknown bildirir; böylece eksik bir görsel, yanıt vermeyen bir kaynakla asla karıştırılmaz.

İhtiyaç duyduğunuzda güncel

Sonuçlar birkaç saat boyunca yeniden kullanılır. Saklanan bir yanıtın en fazla ne kadar eski olabileceğini belirlemek için max_age, yeni bir kontrol için max_age=0 gönderin.

Örnek istek

GET /v1/avatar?username=octocat bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Örnek yanıt

200 OK json

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates": [
    {
      "source": "github",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://avatars.githubusercontent.com/u/583231?v=4",
      "verified": true,
      "content_type": "image/png",
      "profile_url": "https://github.com/octocat",
      "may_be_generated": true
    },
    {
      "source": "bluesky",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
      "verified": true,
      "content_type": "image/jpeg",
      "profile_url": "https://bsky.app/profile/octocat.bsky.social"
    },
    { "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
  ],
  "status": "present",
  "checked_at": "2026-11-02T10:00:00.000Z"
}

Sık sorulan sorular

Hangi kaynaklar kontrol edilir?

E-posta için: Gravatar, Libravatar ve bir şirketin posta alan adının BIMI logosu. Kullanıcı adı için: GitHub, Bluesky, Mastodon ve Keybase veya yalnızca seçtiğiniz platform. Alan adı için: web sitesinin yayımladığı logo ya da simge ve BIMI logosu.

absent ne anlama gelir?

Her kaynak, görseli olmadığını açıkça yanıtlamıştır: hesap yok, fotoğrafsız hesap veya yayımlanmış logo yok. Herhangi bir kaynak engellenmişse, yavaşsa ya da belirsizse sonuç bunun yerine unknown olur.

Bir GitHub fotoğrafı neden olası oluşturulmuş olarak işaretlenebilir?

GitHub, fotoğraf yüklememiş hesaplara otomatik oluşturulmuş bir desen verir ve bir hesabın hangi türde olduğunu belirtmez. Böyle bir görsel asla avatar olarak döndürülmez. Diğer kaynaklarla birlikte listelenir ve işaretlenir; bulunan tek görsel buysa sonuç unknown olur.

Kaç kredi tutar?

Kontrol edilen kaynak sayısından bağımsız olarak sorgu başına iki kredi. unknown sonuçların ücreti iade edilir.

İlgili araçlar ve kaynaklar

HTTP durum kodları

İstemcinizin işlemesi gereken HTTP durum kodları şunlardır; böylece başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve üst kaynak hatalarını birbirinden ayırabilirsiniz.

OK 200

İstek başarılı

Hatalı İstek 400

Geçersiz parametreler

Yetkisiz 401

API anahtarı veya oturum eksik ya da geçersiz.

Ödeme Gerekli 402

Bu isteği çalıştırmak için yeterli krediniz yok.

Çok Fazla İstek 429

Hız sınırı aşıldı

Avatar bul

Ücretsiz başlayın Dokümantasyonu görüntüle