Identity & Verification · DomScan product

Website Identity Assets API

Extract source-backed logos, favicons, preview assets, theme colors, and declared profiles from public websites.

What you get

Extract source-backed logos, favicons, preview assets, theme colors, and declared profiles from public websites.

SynchronousBulkRESTMCPSDK

Choose this product when

Who it is for

Use the suite to improve form handling, prioritize manual review, enrich organizations, and connect website-declared assets.

Choose this product when

Choose this to collect public identity assets declared by a website, such as icons, profiles, and organization-oriented links.

What you get

Extract source-backed logos, favicons, preview assets, theme colors, and declared profiles from public websites.

Endpoints

Review the supported operations, inputs, outputs, execution modes, and response limits before integrating.

GET /v1/identity-assets View API reference
POST /v1/identity-assets/bulk View API reference

Credits and authentication

2 Authentication required. Check the operation reference for the exact cost and any per-item pricing.

Example operation

Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.

GET /v1/identity-assets

Query Parameters

Parameter Type required
domain string required
skip_cache string
Allowed values 1
optional

Response Fields

Field Type
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
meta.fetch_error string

Example Request

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

Example Response

{
  "domain": "example.com",
  "website_url": "https://example.com",
  "fetch_state": "ok",
  "assets": {
    "logo_url": "https://example.com",
    "logo_kind": "logo",
    "logo_source": "public_data",
    "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": "example",
    "candidates": [
      {
        "url": "https://example.com",
        "kind": "example",
        "source": "public_data",
        "type": "domain",
        "sizes": "example",
        "score": 85,
        "confidence": "high"
      }
    ]
  },
  "social_profiles": [
    {
      "platform": "github",
      "type": "social",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high",
      "handle": "example"
    }
  ],
  "confidence": 0.85,
  "evidence": [
    "example"
  ],
  "meta": {
    "checked_at": "2026-08-27T12:00:00Z",
    "cached": false,
    "fetch_transport": "worker",
    "fetch_error": "timeout"
  },
  "organization_name": "example"
}

Limits and evidence boundaries

Results describe observed public evidence and its provenance.
Bulk operations process multiple supported inputs while preserving documented item-level outcomes.
Coverage is bounded by the documented inputs, budgets, sources, and response limits.
Partial means some requested items or components completed while others did not.
The product evaluates public inputs and publicly observable evidence only.

Reviewed 2026-08-22

Frequently asked questions

Where can I find the Website Identity Assets request and response reference?

Use the API reference for Website Identity Assets to review parameters, response fields, examples, status codes, and supported operation modes.

How should I interpret unknown or incomplete results from Website Identity Assets?

Unknown or partial results mean that the requested evidence could not be fully determined. Keep the result state, confidence, freshness, and limitations in downstream decisions.

How is Website Identity Assets priced?

Pricing depends on the operation and execution mode. Check the endpoint reference for the current credit cost, authentication requirement, and per-item rules.