Identité et vérification

API de données de marque

Renseignez la marque d'une entreprise en une seule requête. Envoyez un domaine, un ticker boursier, un ISIN ou un nom d'entreprise et recevez le nom, la description, les profils sociaux déclarés, un logo carré et un logo large sous forme d'URL d'image, ainsi que les couleurs de marque lues dans le logo lui-même, chacun avec son origine et la date de vérification.

Voir la documentation Explorer toutes les API

Points de terminaison Actif

GET /v1/brand

Exemple de requête

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

Exemple de réponse 200 OK

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "
...

Exemple de requête GET /v1/brand

Fonctionnalités clés 4

Questions fréquentes 4

Codes de statut HTTP 200 / 304 / 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 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.

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

domaintickerexchangeisinname

Champs de réponse

Exemple de réponse

queryquery.typequery.valuequery.exchangestatusdomainnamename.statusname.valuename.provenancename.provenance.sourcename.provenance.method

Couverture des statuts

Codes de statut HTTP

200304400401402429

Points de terminaison

GET /v1/brand

Crédits: 3Authentification: 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 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

Couleurs lues dans le logo

La palette provient des pixels du logo décodé, sans les zones transparentes ni les fonds unis, en hex, RGB et OKLCH. La theme_color déclarée par le site web est indiquée séparément.

Logos carré et large

Obtenez le symbole carré de la marque et, lorsque le site web en publie un, son logo large d'en-tête ou son logotype. Les deux sont téléchargés et décodés avant d'être renvoyés.

Inconnu n'est jamais absent

Chaque champ indique présent, absent ou inconnu. Un site web qui bloque la requête ou dépasse le délai produit des champs inconnus, jamais vides, et un ticker qui correspond à plusieurs entreprises renvoie les candidats plutôt qu'une supposition.

Alertes lorsqu'une marque change

Surveillez un domaine de marque avec un abonnement aux alertes de marque et recevez brand.updated sur votre webhook lorsque ses logos, ses couleurs, son nom ou ses profils sociaux changent.

Exemple de requête

GET /v1/brand?domain=stripe.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

Exemple de réponse

200 OK json

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "source": "touch_icon", "verification": "decoded", "native_width": 180, "native_height": 180 }
  },
  "wide_logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com?variant=wide", "source": "logo_image", "aspect_ratio": 2.4 }
  },
  "colors": {
    "status": "present",
    "value": {
      "from": "logo",
      "dominant": { "hex": "#635bff", "rgb": { "r": 99, "g": 91, "b": 255 }, "oklch": { "css": "oklch(57.84% 0.2346 278.29)" }, "share": 0.8712 },
      "background": null
    },
    "provenance": { "source": "logo_pixels", "method": "quantized_palette" }
  },
  "theme_color": { "status": "present", "value": { "declared": "#635BFF" }, "provenance": { "source": "website", "method": "meta_theme_color" } },
  "socials": { "status": "present", "value": [{ "platform": "x", "url": "https://x.com/stripe", "declared_by": "same_as" }] },
  "checked_at": "2026-11-02T10:00:00.000Z"
}

Questions fréquentes

Combien de crédits coûte une recherche de marque ?

Trois crédits par requête, y compris pour les réponses absent et inconnu. Les requêtes invalides, ainsi que les recherches qui échouent parce que les données d'entreprise propres à DomScan sont indisponibles, sont remboursées. Chaque URL d'image de logo de la réponse coûte un crédit lorsque vous la demandez.

Puis-je stocker les données de marque ?

Oui. Vous pouvez mettre en cache et stocker les résultats et les logos dans vos propres systèmes. Les réponses comportent un ETag et des en-têtes de cache pour revalider les copies stockées. Les logos et les noms restent des marques appartenant à leurs propriétaires.

D'où viennent les couleurs de marque ?

Des pixels du logo décodé. Les couleurs proches sont regroupées, la transparence et un fond uni sont écartés, et un même logo donne toujours la même palette. La theme_color déclarée par le site web est un champ distinct.

Puis-je rechercher une marque par ticker boursier ?

Oui. Envoyez ticker, éventuellement avec exchange, ou isin ou name à la place de domain. Un domaine n'est utilisé que si une seule entreprise correspond ; sinon la réponse est inconnu, avec le motif et les candidats.

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

HTTP 304 304

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

Rechercher une marque

Commencer gratuitement Voir la documentation