Référence API

API Ressources d'identité d'un site web

Extrayez les logos, favicons, ressources d’aperçu, couleurs de thème et profils déclarés de sites web publics, avec leurs sources. Utilisez cette référence pour choisir une opération et intégrer son contrat de réponse documenté.

Voir la page du produit

Opérations

GET /v1/identity-assets Voir la référence API

POST /v1/identity-assets/bulk Voir la référence API

GET `/v1/identity-assets`

Opération: getWebsiteIdentityAssets Crédits et authentification: 2 Authentification requise

GET /v1/identity-assets

Paramètres de Requête

Paramètre	Type	requis
domain	string	requis
skip_cache	string Valeurs autorisées `1`	optionnel

Champs de Réponse

Champ	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

Exemple de Requête

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

Exemple de Réponse

{
  "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`

Opération: bulkGetWebsiteIdentityAssets Crédits et authentification: 2 Authentification requise

POST /v1/identity-assets/bulk

Paramètres du Corps

Paramètre	Type	requis
domains	string[]	requis

Champs de Réponse

Champ	Type
`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

Exemple de Requête

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"
  ]
}'

Exemple de Réponse

{
  "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
  }
}

Ressources de référence

OpenAPI 3.0 Postman MCP