API Scrape : récupérer des pages Web avec tarification en crédits fixes

Catégorie Intelligence des domaines et du web

Points de terminaison 4

Fonctionnalités clés 6

Foire aux questions 8

Utilisé par les gens des meilleures 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.

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

urlmodeoutputurlsjob_idlimitoffset

Champs de réponse

Exemple de Réponse

datadata.urldata.final_urldata.statusdata.outcomedata.content_typedata.contentdata.bytesdata.truncateddata.redirect_countdata.attempt_countdata.duration_ms

Couverture des statuts

Codes de Statut HTTP

200202400401402403409429503

Points de terminaison

POST /v1/scrape

Crédits: 1-20/itemAuthentification: Authentification requise

urlmodeoutput

POST /v1/scrape/jobs

Crédits: 1-20/itemAuthentification: Authentification requise

modeoutputurls

GET /v1/scrape/jobs/:job_id

Crédits: 0Authentification: Authentification requise

job_id

GET /v1/scrape/jobs/:job_id/results

Crédits: 0Authentification: Authentification requise

job_idlimitoffset

Choisir le niveau d'effort de récupération pour chaque URL

Les crédits sont basés sur le mode que vous demandez, pas sur le statut HTTP ou le contenu retourné par le site Web cible.

Standard

1 crédit par URL

Une tentative de récupération standard pour les pages simples.

Résilient

2 crédits par URL

Une tentative standard avec une tentative lorsque le résultat répond aux conditions de tentative documentées.

Rendu

10 crédits par URL

Une tentative rendue par navigateur pour les pages qui nécessitent l'exécution de JavaScript.

Rendu résilient

20 crédits par URL

Une tentative rendue par navigateur avec une tentative lorsque le résultat répond aux conditions de tentative documentées.

Les modes résilients coûtent le montant indiqué même quand la première tentative réussit. Ils incluent une tentative éligible, pas des tentatives illimitées ou une garantie que le site Web cible renverra le contenu que vous attendez.

La facturation reflète le travail demandé

Une opération API réussie signifie que DomScan a effectué le mode de récupération sélectionné et renvoyé la réponse cible résultante.

Le résultat peut toujours être une redirection, une erreur HTTP, une réponse bloquée, une page de défi, une page vide ou un contenu qui ne répond pas à vos besoins. Ces résultats de site cible sont facturables et ne sont pas éligibles à un remboursement de crédit.

Un remboursement est disponible uniquement quand DomScan vérifie que sa propre plateforme n'a pas pu effectuer le mode de récupération sélectionné.

Le rendu du navigateur ne garantit pas qu'une page se chargera avec succès, et les modes résilients ne garantissent pas que la tentative produira un résultat différent.

Limites d'utilisation spécifiques à Scrape

Ces limites s'appliquent spécifiquement à l'API Scrape. D'autres garde-fous de compte et de plateforme peuvent également s'appliquer.

Capacité	Comptes gratuits	Comptes payants
Modes disponibles	Standard uniquement	Tous les quatre modes
Taux de demande	5 demandes par minute	60 demandes par minute
Demandes standard ou résilientes concurrentes	1 demande standard	5 demandes
Demandes rendues concurrentes	Non disponible	2 demandes
Allocation quotidienne	100 demandes	Basé sur les crédits disponibles et les limites de taux
Allocation mensuelle	500 demandes	Basé sur les crédits disponibles et les limites de taux
Contenu retourné maximum	256 KiB par demande	512 KiB par demande
Lots asynchrones	Non disponible	Disponible

Quand une réponse dépasse la limite de contenu applicable, l'API retourne la portion autorisée et marque la réponse comme tronquée.

Traiter jusqu'à 100 URLs de manière asynchrone

Les comptes payants peuvent soumettre une tâche asynchrone contenant jusqu'à 100 URLs.

Jusqu'à 5 nouvelles tâches par minute

Jusqu'à 3 tâches actives par compte

Jusqu'à 300 éléments URL en file d'attente par compte

Jusqu'à 100 URLs dans une tâche

Résultats complétés disponibles pendant 24 heures

Métadonnées de tâche conservées pendant 7 jours

Chaque URL est facturée indépendamment en utilisant son mode sélectionné.

Téléchargez ou copiez les résultats complétés dans les 24 heures. Après cette période, le contenu de la réponse est supprimé bien que les métadonnées de tâche limitées restent disponibles pendant 7 jours.

Portée claire, sans options de mise à niveau cachées

Pas de résolution de CAPTCHA

Le rendu du navigateur peut exécuter le JavaScript de la page, mais l'API Scrape ne résout pas les CAPTCHAs ou contourne les conditions de connexion, les murs de paiement, les contrôles d'accès ou autres restrictions. Un CAPTCHA ou une page de défi retourné par la cible est un résultat de site cible et n'est pas remboursable.

Aucune sélection de proxy premium

Vous choisissez le mode de récupération et le niveau d'effort. Il n'y a pas de proxy premium, fournisseur, pool ou paramètre de sélection de pays.

Utilisation acceptable

Utilisez l'API Scrape uniquement pour le contenu auquel vous êtes légalement autorisé à accéder et traiter. Vous êtes responsable de la conformité aux lois applicables, aux conditions du site cible, aux obligations de confidentialité et aux autorisations requises.

N'utilisez pas l'API pour contourner l'authentification, les murs de paiement, les CAPTCHAs ou les contrôles d'accès, ou pour les attaques par identifiants, les abus de compte, le harcèlement, la surveillance illégale ou la collecte illégale de données personnelles. DomScan peut rejeter les demandes ou suspendre l'accès quand l'utilisation menace les personnes, les services ou la plateforme.

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

Choisir le niveau d'effort de récupération pour chaque URL

Les crédits sont basés sur le mode que vous demandez, pas sur le statut HTTP ou le contenu retourné par le site Web cible.

La facturation reflète le travail demandé

Une opération API réussie signifie que DomScan a effectué le mode de récupération sélectionné et renvoyé la réponse cible résultante.

Traiter jusqu'à 100 URLs de manière asynchrone

Les comptes payants peuvent soumettre une tâche asynchrone contenant jusqu'à 100 URLs.

Limites d'utilisation spécifiques à Scrape

Ces limites s'appliquent spécifiquement à l'API Scrape. D'autres garde-fous de compte et de plateforme peuvent également s'appliquer.

Pas de résolution de CAPTCHA

Utilisation acceptable

Exemple de Requête

Demande standard bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'

Demande rendue par navigateur bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'

Demande de lot asynchrone bash

curl -X POST "https://domscan.net/v1/scrape/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Idempotency-Key: docs-batch-1" \
  -H "Content-Type: application/json" \
  -d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'

Exemple de Réponse

Réponse standard réussie json

{
  "data": {
    "url": "https://example.com/",
    "final_url": "https://example.com/",
    "status": 200,
    "outcome": "success",
    "content_type": "text/html",
    "content": "<!doctype html>...",
    "bytes": 1256,
    "truncated": false,
    "redirect_count": 0,
    "attempt_count": 1,
    "duration_ms": 428,
    "fetched_at": "2026-08-20T10:30:00.000Z",
    "headers": { "cache-control": "max-age=604800" },
    "rendered": false
  },
  "billing": {
    "credits_charged": 1,
    "credits_refunded": 0,
    "policy": "effort_based"
  }
}

Foire aux questions

Combien de crédits coûte une URL ?

Une URL coûte 1, 2, 10 ou 20 crédits selon le mode sélectionné. Les éléments de lot utilisent la même tarification par URL.

Suis-je facturé si la cible retourne une erreur ou une page de blocage ?

Oui. Les réponses des cibles telles que les redirections, les erreurs HTTP, les blocages, les pages de défi, les pages vides ou le contenu inattendu sont facturables car DomScan a toujours effectué le travail de récupération demandé.

Quand une demande est-elle remboursée ?

Un remboursement est disponible uniquement quand DomScan vérifie que sa propre plateforme n'a pas pu effectuer le mode de récupération sélectionné. Le comportement du site cible n'est pas une défaillance de plateforme.

Le mode résilient continue-t-il à réessayer jusqu'à ce que la page fonctionne ?

Non. Le mode résilient inclut une tentative quand le premier résultat répond aux conditions de tentative documentées.

Le rendu du navigateur résout-il les CAPTCHAs ?

Non. Il exécute le JavaScript de la page mais ne résout pas les CAPTCHAs ou ne contourne pas les restrictions d'accès.

Puis-je sélectionner un proxy premium ou un pays ?

Non. L'API n'expose pas les niveaux de proxy, les fournisseurs, les pools ou le ciblage géographique. Vous sélectionnez uniquement le mode de récupération.

Les comptes gratuits peuvent-ils soumettre des tâches par lot ?

Non. Les lots asynchrones sont disponibles uniquement pour les comptes payants. Les comptes gratuits peuvent utiliser le mode standard dans les limites gratuites publiées.

Combien de temps les résultats des lots sont-ils stockés ?

Le contenu de réponse complété est disponible pendant 24 heures. Les métadonnées limitées de tâche restent disponibles pendant 7 jours.

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

Accepté 202

Absence de cache de sous-domaines en mode cache uniquement acceptée pour une actualisation en arrière-plan. Aucun crédit n’est facturé; réessayez après le délai Retry-After.

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.

Interdit 403

Authentifié, mais non autorisé à utiliser cette opération ou ce mode.

HTTP 409 409

Trop de requêtes 429

Limite de débit dépassée

Service indisponible 503

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

Obtenir une clé API

Commencer gratuitement Voir la documentation

Assistance

API de Récupérer des pages web avec tarification prévisible par URL

Signaux de confiance avant intégration

Ce que cette API vous aide à livrer

Flux d’intégration

Kit développeur

Carte des paramètres et réponses

Points de terminaison

Choisir le niveau d'effort de récupération pour chaque URL

Standard

Résilient

Rendu

Rendu résilient

La facturation reflète le travail demandé

Limites d'utilisation spécifiques à Scrape

Traiter jusqu'à 100 URLs de manière asynchrone

Portée claire, sans options de mise à niveau cachées

Pas de résolution de CAPTCHA

Aucune sélection de proxy premium

Utilisation acceptable

Signaux de confiance avant intégration

Fonctionnalités clés

Exemple de Requête

Exemple de Réponse

Foire aux questions

Outils et Ressources Connexes

Codes de Statut HTTP