API de Métadonnées URL pour Aperçus de Liens et Intelligence Web

API d’Intelligence URL Unifiée

Envoyez une URL publique et recevez dans une seule réponse les métadonnées normalisées de la page, les ressources d’aperçu, les preuves de redirection, les types de données structurées, les en-têtes de sécurité et les signaux d’identité publics.

{ "requested_url": "https://example.com/", "final_url": "https://example.com/", "status": 200, "title": "Example Domain", "canonical_url": "https://example.com/", "open_graph": {}, "structured_data": { "types": [], "items": 0, "parse_errors": 0 }, "meta": { "cached": false, "fetch_transport": "worker" } }

Catégorie Intelligence web

Points de terminaison 2

Fonctionnalités clés 6

Foire aux questions 5

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.

10,000 Quota gratuit

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

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

url

Champs de réponse

Exemple de Réponse

requested_urlfinal_urlstatustitlecanonical_urlopen_graphstructured_datastructured_data.typesstructured_data.itemsstructured_data.parse_errorsmetameta.cached

Couverture des statuts

Codes de Statut HTTP

200400401402429500502503504

Points de terminaison

GET /v1/url-intelligence

Crédits: 2Authentification: Authentification requise

POST /v1/url-intelligence/bulk

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.

État du service 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.

Quota gratuit Inscrivez-vous Gratuitement

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

Actif Exemple de Requête

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

Fonctionnalités clés

Métadonnées de Page Normalisées

Extrayez le titre, la description, la langue, le type de contenu, l’URL finale et l’URL canonique.

Champs d’Aperçu des Liens

Créez des cartes d’aperçu à partir d’images normalisées, de favicons, de balises Open Graph et de Twitter Cards.

Résumé des Données Structurées

Identifiez les types JSON-LD et signalez les blocs mal formés sans renvoyer un volume illimité de données de page.

Signaux Robots et de Sécurité

Lisez les directives d’indexation et un ensemble autorisé d’en-têtes de sécurité publics.

Coordonnées et Profils Publics

Extrayez les liens déclarés d’e-mail, de téléphone, de réseaux sociaux, de développeurs et de créateurs.

Métadonnées URL en Masse

Inspectez jusqu’à 10 URL par requête, avec une concurrence limitée et des erreurs par élément.

Exemple de Requête

GET /v1/url-intelligence?url=https://example.com bash

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/url-intelligence

POST /v1/url-intelligence/bulk bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com","https://github.com/about"]}' https://domscan.net/v1/url-intelligence/bulk

Exemple de Réponse

200 OK json

{
  "requested_url": "https://example.com/",
  "final_url": "https://example.com/",
  "status": 200,
  "title": "Example Domain",
  "canonical_url": "https://example.com/",
  "open_graph": {},
  "structured_data": { "types": [], "items": 0, "parse_errors": 0 },
  "meta": { "cached": false, "fetch_transport": "worker" }
}

Foire aux questions

Quelle est la différence entre une API de métadonnées URL et une API Open Graph ?

Une API Open Graph se concentre sur les balises sociales. DomScan renvoie aussi des signaux concernant l’URL canonique, les redirections, les directives robots, les données structurées, la sécurité, les contacts et les identités.

Que se passe-t-il lorsque les balises Open Graph sont absentes ?

Les champs Open Graph restent vides, tandis que le titre standard, la description, les icônes, les données structurées et les autres signaux disponibles sont toujours renvoyés.

L’API exécute-t-elle JavaScript ?

Non. La version initiale inspecte des réponses HTML publiques de taille limitée et ne prétend pas fournir les métadonnées qui apparaissent uniquement après l’exécution de JavaScript côté client.

L’API suit-elle les redirections de manière sûre ?

Oui. Le nombre de redirections est limité et chaque destination est vérifiée afin d’empêcher l’accès à des cibles de réseaux privés ou internes.

Puis-je inspecter plusieurs URL à la fois ?

Oui. Le point de terminaison groupé accepte jusqu’à 10 URL publiques et conserve leur ordre d’entrée.

Outils et Ressources Connexes

Codes de Statut HTTP

Nous documentons les codes d'état HTTP que votre client doit 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

Erreur serveur 500

Erreur interne

Mauvaise passerelle 502

Erreur RDAP en amont

Service indisponible 503

Le service amont est indisponible ou limite temporairement les requêtes.

Délai d’attente de la passerelle dépassé 504

La requête amont a expiré.

Créez avec l’Intelligence URL

Voir la documentation complète de l'API APIs