Introduction

# 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"

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()