Identité et vérification

API de recherche d'avatars et de logos

Affichez un vrai visage ou un vrai logo à côté de chaque utilisateur, lead et entreprise. Envoyez une adresse e-mail, un nom d'utilisateur ou un domaine et obtenez la meilleure image vérifiée, son origine et une réponse honnête lorsqu'il n'y en a pas.

Voir la documentation Explorer toutes les API

Points de terminaison Actif

GET /v1/avatar

Exemple de requête

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

Exemple de réponse 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"
...

Exemple de requête GET /v1/avatar

Fonctionnalités clés 4

Questions fréquentes 4

Codes de statut HTTP 200 / 400 / 401 / 402 / 429

Catégorie Identité et vérification

Points de terminaison 1

Fonctionnalités clés 4

Questions fréquentes 4

Utilisé par des équipes de ces entreprises

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

En direct État du service

Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.

OpenAPI Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

1 000 Quota gratuit

Commencez avec 1 000 crédits gratuits par mois civil en UTC. Choisissez une offre mensuelle facultative ou achetez un pack en une seule fois si vous avez besoin de plus de crédits.

Ce que cette API vous aide à livrer

Utilisez cette page comme brief de production : endpoints, exemples, structure de réponse et éléments de workflow pour intégrer DomScan à votre produit.

Workflows produit

Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.

Automatisation analyste

Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.

Données JSON propres

Utilisez des champs prévisibles, des codes d’état documentés et des coûts en crédits au lieu de scraper des pages fournisseur.

IA et opérations

Alimentez agents, tableaux de bord, playbooks SOAR et CRMs via OpenAPI, SDK, Postman ou MCP.

Flux d’intégration

Un parcours simple de la première requête à un usage répétable en production.

Authentifier une fois

Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.

Interroger avec les exemples

Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.

Exploiter et surveiller

Utilisez codes d’état, coûts en crédits et champs de réponse pour construire retries, logs et alertes.

Kit développeur

Passez de cette page aux docs lisibles par machine, collections de requêtes, SDKs ou outils d’agents.

Schéma OpenAPI

Générez des clients ou inspectez chaque forme de requête et de réponse.

Collection Postman

Importez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.

SDKs et CLI

Utilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.

Intégration MCP

Exposez l’intelligence de domaines aux agents IA et aux assistants internes.

Carte des paramètres et réponses

Parcourez les entrées, champs de sortie et codes d’état avant de connecter l’endpoint à votre client.

Paramètres de requête

Paramètre

emailusernameplatformdomain

Champs de réponse

Exemple de réponse

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

Couverture des statuts

Codes de statut HTTP

200400401402429

Points de terminaison

GET /v1/avatar

Crédits: 2Authentification: Authentification requise

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

En direct État du service

Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.

OpenAPI Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

1 000 Quota gratuit

Commencez avec 1 000 crédits gratuits par mois civil en UTC. Choisissez une offre mensuelle facultative ou achetez un pack en une seule fois si vous avez besoin de plus de crédits.

Fonctionnalités clés

E-mail, nom d'utilisateur ou domaine

Les adresses e-mail sont comparées aux services d'avatars publics et au logo de l'entreprise de leur domaine de messagerie. Les noms d'utilisateur sont vérifiés sur GitHub, Bluesky, Mastodon et Keybase. Les domaines renvoient le logo du site web.

Uniquement des images vérifiées

Chaque image renvoyée est téléchargée et contrôlée pour s'assurer qu'il s'agit bien d'une image. Les pages d'erreur, les liens rompus et les images par défaut ne sont jamais renvoyés.

Des preuves pour chaque source

Chaque source indique present, absent ou unknown avec la raison, afin qu'une image manquante ne soit jamais confondue avec une source qui n'a pas répondu.

Des données fraîches quand il le faut

Les résultats sont réutilisés pendant quelques heures. Envoyez max_age pour définir l'ancienneté maximale d'une réponse stockée, ou max_age=0 pour une nouvelle vérification.

Exemple de requête

GET /v1/avatar?username=octocat bash

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

Exemple de réponse

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

Questions fréquentes

Quelles sources sont consultées ?

Pour un e-mail : Gravatar, Libravatar et le logo BIMI du domaine de messagerie d'une entreprise. Pour un nom d'utilisateur : GitHub, Bluesky, Mastodon et Keybase, ou uniquement la plateforme que vous choisissez. Pour un domaine : le logo ou l'icône publiés par le site web, ainsi que son logo BIMI.

Que signifie absent ?

Chaque source a répondu clairement qu'elle n'a pas d'image : pas de compte, un compte sans photo ou aucun logo publié. Si une source était bloquée, lente ou peu claire, le résultat est unknown à la place.

Pourquoi une photo GitHub peut-elle être signalée comme éventuellement générée ?

GitHub attribue un motif généré aux comptes sans image importée et n'indique pas de quel type est celle d'un compte. Une telle image n'est jamais renvoyée comme avatar. Elle est listée avec les autres sources et signalée, et si c'est la seule image trouvée, le résultat est unknown.

Combien de crédits cela coûte-t-il ?

Deux crédits par recherche, quel que soit le nombre de sources vérifiées. Les résultats unknown sont remboursés.

Outils et ressources associés

Codes de statut HTTP

Voici les codes d'état HTTP à gérer, afin de distinguer les réponses réussies, les problèmes d'authentification, les crédits, les limites de débit, les données introuvables et les erreurs en amont.

OK 200

Requête réussie

Requête incorrecte 400

Paramètres invalides

Non autorisé 401

Clé API ou session manquante ou invalide.

Paiement requis 402

Crédits insuffisants pour exécuter cette requête.

Trop de requêtes 429

Limite de débit dépassée

Trouver un avatar

Commencer gratuitement Voir la documentation