Kimlik ve Doğrulama

Marka verisi API'si

Bir şirketin markasını tek istekle tamamlayın. Bir alan adı, borsa kodu, ISIN veya şirket adı gönderin; ad, açıklama, bildirilen sosyal profiller, görsel URL'leri olarak bir kare ve bir geniş logo ile logonun kendisinden okunan marka renklerini, her biri kaynağı ve kontrol edildiği zamanla birlikte alın.

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

Uç Noktalar Aktif

GET /v1/brand

Örnek istek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

Örnek yanıt 200 OK

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "
...

Örnek istek GET /v1/brand

Temel Özellikler 4

Sık sorulan sorular 4

HTTP durum kodları 200 / 304 / 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 krediler

Her ay 1.000 ücretsiz krediyle başlayın. Daha fazlası mı lazım? Aylık bir plan seçin veya 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

domaintickerexchangeisinname

Yanıt alanları

Örnek yanıt

queryquery.typequery.valuequery.exchangestatusdomainnamename.statusname.valuename.provenancename.provenance.sourcename.provenance.method

Durum kapsamı

HTTP durum kodları

200304400401402429

Uç Noktalar

GET /v1/brand

Kredi: 3Kimlik 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 krediler

Her ay 1.000 ücretsiz krediyle başlayın. Daha fazlası mı lazım? Aylık bir plan seçin veya tek seferlik bir paket satın alın.

Temel Özellikler

Logodan okunan renkler

Palet, şeffaf alanlar ve düz arka planlar hariç tutularak çözülmüş logonun piksellerinden elde edilir ve hex, RGB ve OKLCH olarak sunulur. Web sitesinin bildirdiği theme_color ayrıca raporlanır.

Kare ve geniş logolar

Markanın kare simgesini ve web sitesi yayımlıyorsa geniş başlık veya yazı logosunu alın. İkisi de döndürülmeden önce indirilir ve çözülür.

Bilinmiyor asla yok demek değildir

Her alan mevcut, yok veya bilinmiyor değerini belirtir. İsteği engelleyen veya zaman aşımına uğrayan bir web sitesi boş değil, bilinmeyen alanlar üretir; birden fazla şirketle eşleşen bir ticker ise tahmin yürütmek yerine adayları döndürür.

Bir marka değiştiğinde uyarılar

Marka uyarı aboneliğiyle bir marka alan adını izleyin; logoları, renkleri, adı veya sosyal profilleri değiştiğinde webhook'unuza brand.updated gelsin.

Örnek istek

GET /v1/brand?domain=stripe.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

Örnek yanıt

200 OK json

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "source": "touch_icon", "verification": "decoded", "native_width": 180, "native_height": 180 }
  },
  "wide_logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com?variant=wide", "source": "logo_image", "aspect_ratio": 2.4 }
  },
  "colors": {
    "status": "present",
    "value": {
      "from": "logo",
      "dominant": { "hex": "#635bff", "rgb": { "r": 99, "g": 91, "b": 255 }, "oklch": { "css": "oklch(57.84% 0.2346 278.29)" }, "share": 0.8712 },
      "background": null
    },
    "provenance": { "source": "logo_pixels", "method": "quantized_palette" }
  },
  "theme_color": { "status": "present", "value": { "declared": "#635BFF" }, "provenance": { "source": "website", "method": "meta_theme_color" } },
  "socials": { "status": "present", "value": [{ "platform": "x", "url": "https://x.com/stripe", "declared_by": "same_as" }] },
  "checked_at": "2026-11-02T10:00:00.000Z"
}

Sık sorulan sorular

Bir marka sorgusu kaç kredi tutar?

İstek başına üç kredi; yok ve bilinmiyor yanıtları da dahildir. Geçersiz istekler ve DomScan'in kendi şirket verileri kullanılamadığı için başarısız olan sorgular iade edilir. Yanıttaki her logo görseli URL'si, istediğinizde bir kredi tutar.

Marka verilerini saklayabilir miyim?

Evet. Sonuçları ve logoları kendi sistemlerinizde önbelleğe alıp saklayabilirsiniz. Yanıtlar, saklanan kopyaları yeniden doğrulamanız için ETag ve önbellek başlıkları içerir. Logolar ve adlar sahiplerinin ticari markası olmaya devam eder.

Marka renkleri nereden geliyor?

Çözülmüş logonun piksellerinden. Benzer renkler gruplanır, şeffaflık ve düz arka plan hariç tutulur ve aynı logo her zaman aynı paleti verir. Web sitesinin bildirdiği theme_color ayrı bir alandır.

Bir markayı borsa koduyla sorgulayabilir miyim?

Evet. domain yerine ticker, isteğe bağlı olarak exchange ile birlikte, ya da isin veya name gönderin. Alan adı yalnızca tam olarak bir şirket eşleştiğinde kullanılır; aksi halde yanıt, nedeni ve adaylarla birlikte bilinmiyor olur.

İ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ı

HTTP 304 304

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ı

Marka sorgula

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