Introduction

Authentification

Toutes les requêtes API nécessitent un token Bearer dans le header Authorization.

Pour obtenir votre clé API :

1. Inscrivez-vous ou connectez-vous sur catchdoms.com
2. Allez sur la page Accès API
3. Créez un nouveau token API

L'accès API nécessite un abonnement Pro (468 EUR/an).

Exemple de header de requête

Limites de requêtes

L'API est limitée à 15 requêtes par minute par token.

Les informations de limite sont incluses dans les headers de réponse :

Si vous dépassez la limite, vous recevrez une réponse 429 Too Many Requests. Attendez 60 secondes avant de réessayer.

Endpoints

Paramètres de requête

Tous les paramètres sont optionnels. Ajoutez-les au query string de GET /api/domains.

Champs de réponse

Chaque domaine dans le tableau data contient ces champs.

API Inventaire Pending-Delete

Inventaire hebdomadaire des domaines sur le point de tomber sur 125+ ccTLDs et gTLDs, classifiés par statut WHOIS avec date de drop estimée. Rafraîchi chaque lundi (ccTLDs) et quotidiennement (gTLDs).

Abonnement Authority+ requis. Les autres tiers reçoivent un 403 avec une upgrade_url. Même authentification Bearer et mêmes limites que le reste de l'API.

Paramètres de requête

Exemple

# Upcoming .fr drops, soonest first
curl "https://catchdoms.com/api/pending-delete?tld=fr&drops_within=7&per_page=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Note performance : la première requête d'une nouvelle combinaison de filtres calcule son total une fois (quelques secondes sur les périmètres très larges) ; les requêtes suivantes le servent depuis le cache et répondent en bien moins d'une seconde.

Pagination

Tous les endpoints de liste retournent des résultats paginés au format standard Laravel.

L'objet meta contient :

L'objet links contient :

{
  "data": [ ... ],
  "links": {
    "first": "https://catchdoms.com/api/domains?page=1",
    "last": "https://catchdoms.com/api/domains?page=68",
    "prev": null,
    "next": "https://catchdoms.com/api/domains?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 68,
    "per_page": 50,
    "to": 50,
    "total": 3400
  }
}

Exemples de code

Remplacez YOUR_API_KEY par votre token.

# List domains with score >= 50 and backlinks
curl "https://catchdoms.com/api/domains?score_min=50&has_backlinks=1&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

# Get a single domain by ID
curl "https://catchdoms.com/api/domains/12345" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

# Filter by TLD and language
curl "https://catchdoms.com/api/domains?tld=.fr&language=FR&age_min=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

# Filter by multiple TLDs
curl "https://catchdoms.com/api/domains?tld=.fr,.de,.it&score_min=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

# Filter by source platform (e.g. Rakko Japanese marketplace)
curl "https://catchdoms.com/api/domains?source=rakkodomain&tf_min=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://catchdoms.com/api';

// List domains with filters
const params = new URLSearchParams({
  score_min: 50,
  has_backlinks: 1,
  per_page: 10
});

const response = await fetch(`${BASE_URL}/domains?${params}`, {
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Accept': 'application/json'
  }
});

const { data, meta } = await response.json();
console.log(`Found ${meta.total} domains`);

// Get a single domain
const domain = await fetch(`${BASE_URL}/domains/12345`, {
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Accept': 'application/json'
  }
}).then(r => r.json());

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://catchdoms.com/api'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Accept': 'application/json'
}

# List domains with filters
response = requests.get(f'{BASE_URL}/domains', headers=headers, params={
    'score_min': 50,
    'has_backlinks': 1,
    'language': 'FR',
    'per_page': 25
})
data = response.json()
print(f"Found {data['meta']['total']} domains")

for domain in data['data']:
    print(f"{domain['name']} - Score: {domain['score']} - Price: {domain['effective_price']}")

# Get a single domain
domain = requests.get(f'{BASE_URL}/domains/12345', headers=headers).json()

Erreurs

L'API utilise les codes HTTP standards. Les réponses d'erreur incluent un corps JSON avec un champ message.

Exemple de réponse d'erreur

// 401 Unauthorized
{
  "message": "Unauthenticated."
}

// 429 Too Many Requests
{
  "message": "Too Many Attempts."
}

Serveur MCP

CatchDoms inclut un serveur MCP (Model Context Protocol) pour les assistants IA comme Claude Code, Cursor et Windsurf.

Au lieu d'écrire des appels API, vous pouvez poser des questions en langage naturel :

Configuration

Ajoutez ceci à la config de votre client MCP :

Claude Code / Cursor

{
  "mcpServers": {
    "catchdoms": {
      "type": "http",
      "url": "https://catchdoms.com/mcp/catchdoms",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "catchdoms": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://catchdoms.com/mcp/catchdoms",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code : ~/.claude.json | Cursor : paramètres MCP Claude Desktop requires Node.js.

Troubleshooting