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.
Identité et vérification
API d'images de logos
Affichez le logo d'une entreprise à côté de chaque domaine de votre produit. Appelez /v1/logo/ suivi d'un domaine et recevez un PNG carré, à la bonne taille et prêt pour une balise img, avec des en-têtes qui indiquent son origine. Vous pouvez mettre les images en cache, les stocker et les servir depuis vos propres serveurs ou votre CDN.
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.
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
Crédits gratuits
Commencez avec 1 000 crédits gratuits chaque mois. Besoin de plus ? Choisissez un plan mensuel ou achetez un pack unique.
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.
Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.
Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.
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.
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 PostmanImportez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.
SDKs et CLIUtilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.
Intégration MCPExposez 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ètre
domain
Exemple de réponse
successdatameta
Codes de statut HTTP
401402
Points de terminaison
GET
/v1/logo/:domain
domain
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
Crédits gratuits
Commencez avec 1 000 crédits gratuits chaque mois. Besoin de plus ? Choisissez un plan mensuel ou achetez un pack unique.
Fonctionnalités clés
Un vrai logo ou une réponse honnête
Les logos proviennent de ce que l'entreprise publie elle-même : son logo de messagerie BIMI, ses icônes d'application, ses touch icons, ses logos en données structurées et ses favicons. Chaque image est téléchargée et décodée avant d'être renvoyée. Sans logo, vous obtenez une erreur 404, ou, avec fallback=monogram, une image de lettre générée, toujours signalée comme générée.
À la taille de votre interface
Choisissez n'importe quelle taille de 16 à 512 pixels, retina pour une double densité, greyscale, et theme=light ou theme=dark pour placer les logos peu contrastés sur une vignette qui reste visible sur votre arrière-plan. Les images sont carrées, avec une marge transparente.
À vous de les mettre en cache et de les conserver
Les réponses portent des en-têtes de cache public de longue durée, un ETag et Last-Modified. Les navigateurs et votre CDN peuvent les conserver, et vous pouvez stocker les fichiers et les servir depuis vos propres serveurs. Ajoutez v= à une URL pour la rendre immuable.
Sûr à utiliser dans une page web
Utilisez une clé publiable dans le paramètre token : elle ne fonctionne que depuis les sites web que vous indiquez, avec des limites par clé et par visiteur. Les clés secrètes restent sur votre serveur, dans l'en-tête X-API-Key.
Exemple de requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
"https://domscan.net/v1/logo/stripe.com?size=128&retina=true"<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">Exemple de réponse
HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999Questions fréquentes
Combien de crédits coûte un logo ?
Un crédit par requête, y compris pour les logos servis depuis le cache, les images de lettre générées, les domaines sans logo et les réponses 304 Not Modified. Les requêtes rejetées avant tout traitement, comme un domaine invalide ou une clé utilisée depuis un site non autorisé, ne sont pas facturées. Mettez l'image en cache plutôt que de la récupérer à chaque affichage de page.
Puis-je stocker les logos sur mes propres serveurs ?
Oui. Vous pouvez mettre en cache les images renvoyées, les stocker et les servir depuis vos propres serveurs ou votre CDN. Les logos restent des marques déposées de leurs propriétaires : utilisez-les pour identifier l'entreprise à laquelle ils appartiennent.
Quelle est la différence entre introuvable et indisponible ?
Introuvable signifie que le site web et ses enregistrements de messagerie ont répondu et ne publient aucun logo exploitable ; cette réponse est réutilisée pendant une heure. Indisponible signifie que le site web a bloqué la requête, a été lent ou n'a pas répondu clairement : aucune conclusion n'a été tirée et vous pouvez réessayer quelques minutes plus tard. X-Logo-Status permet de les distinguer.
Comment savoir d'où vient un logo ?
X-Logo-Source indique la source, par exemple bimi, manifest_icon, touch_icon ou favicon, et X-Logo-Verification précise que l'image a été décodée. Une image de lettre générée porte toujours X-Logo-Source: generated et n'est jamais présentée comme un logo.
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.
Non autorisé
401
Clé API ou session manquante ou invalide.
Paiement requis
402
Crédits insuffisants pour exécuter cette requête.
Obtenir un logo