API referansı

Web Sitesi Kimlik Varlıkları API ürünü

Herkese açık web sitelerinden kaynağı belirtilen logoları, faviconları, önizleme varlıklarını, tema renklerini ve beyan edilen profilleri çıkarın. Bir işlem seçmek ve belgelenen yanıt sözleşmesini entegre etmek için bu referansı kullanın.

Ürün sayfasını görüntüle

İşlemler

GET /v1/identity-assets API referansını görüntüle

POST /v1/identity-assets/bulk API referansını görüntüle

GET `/v1/identity-assets`

İşlem: getWebsiteIdentityAssets Krediler ve kimlik doğrulama: 2 Kimlik doğrulama gerekli

GET /v1/identity-assets

Sorgu Parametreleri

Parametre	Tür	gerekli
domain	string	gerekli
skip_cache	string İzin verilen değerler `1`	isteğe bağlı

Yanıt Alanları

Alan	Tür
`domain`	string
`website_url`	string
`fetch_state`	string
`organization_name`	string \| null
`assets`	object
`assets.logo_url`	string \| null
`assets.logo_kind`	string \| null
`assets.logo_source`	string \| null
`assets.logo_verification`	string \| null
`assets.favicon_url`	string \| null
`assets.touch_icon_url`	string \| null
`assets.preview_image_url`	string \| null
`assets.manifest_url`	string \| null
`assets.theme_color`	string \| null
`assets.candidates[]`	object[]
`assets.candidates[]`	object
`assets.candidates[].url`	string
`assets.candidates[].kind`	string
`assets.candidates[].source`	string
`assets.candidates[].type`	string \| null
`assets.candidates[].sizes`	string \| null
`assets.candidates[].score`	integer
`assets.candidates[].confidence`	string
`social_profiles[]`	object[]
`social_profiles[]`	object
`social_profiles[].platform`	string
`social_profiles[].type`	string
`social_profiles[].handle`	string \| null
`social_profiles[].url`	string
`social_profiles[].source`	string
`social_profiles[].confidence`	string
`confidence`	number
`evidence[]`	string[]
`meta`	object
`meta.checked_at`	string
`meta.cached`	boolean
`meta.fetch_transport`	string

Örnek İstek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-assets?domain=example.com&skip_cache=example.com"

Örnek Yanıt

{
  "domain": "example.com",
  "website_url": "https://example.com",
  "fetch_state": "ok",
  "organization_name": "string",
  "assets": {
    "logo_url": "https://example.com",
    "logo_kind": "logo",
    "logo_source": "string",
    "logo_verification": "verified",
    "favicon_url": "https://example.com",
    "touch_icon_url": "https://example.com",
    "preview_image_url": "https://example.com",
    "manifest_url": "https://example.com",
    "theme_color": "string",
    "candidates": [
      {
        "url": "https://example.com",
        "kind": "string",
        "source": "string",
        "type": "string",
        "sizes": "string",
        "score": 1,
        "confidence": "high"
      }
    ]
  },
  "social_profiles": [
    {
      "platform": "github",
      "type": "social",
      "handle": "example",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high"
    }
  ],
  "confidence": 1,
  "evidence": [
    "string"
  ],
  "meta": {
    "checked_at": "2026-04-15T12:00:00Z",
    "cached": true,
    "fetch_transport": "worker"
  }
}

POST `/v1/identity-assets/bulk`

İşlem: bulkGetWebsiteIdentityAssets Krediler ve kimlik doğrulama: 2 Kimlik doğrulama gerekli

POST /v1/identity-assets/bulk

Gövde Parametreleri

Parametre	Tür	gerekli
domains	string[]	gerekli

Yanıt Alanları

Alan	Tür
`results[]`	object[]
`results[]`	object
`results[].input`	string
`results[].data`	object
`results[].error`	object
`results[].error.error`	object
`results[].error.error.code`	string
`results[].error.error.message`	string
`results[].error.error.suggestion`	string
`results[].error.error.details`	object
`results[].error.error.retry_after`	integer
`results[].error.error.docs_url`	string
`meta`	object
`meta.total`	integer
`meta.succeeded`	integer
`meta.failed`	integer
`meta.max_items`	integer
`meta.credits_per_item`	integer
`meta.duration_ms`	integer

Örnek İstek

curl -X POST "https://domscan.net/v1/identity-assets/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domains": [
    "stripe.com",
    "github.com"
  ]
}'

Örnek Yanıt

{
  "results": [
    {
      "input": "string",
      "data": {},
      "error": {
        "error": {
          "code": "INVALID_DOMAIN",
          "message": "Invalid domain format",
          "suggestion": "string",
          "details": {},
          "retry_after": 300,
          "docs_url": "/docs#parameters"
        }
      }
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "max_items": 10,
    "credits_per_item": 2,
    "duration_ms": 1
  }
}

Referans kaynakları

OpenAPI 3.0 Postman MCP