DomainCatcher API: domeinnamen zoeken, bestellen en automatiseren

Auteur: Leo Kobes Gepubliceerd: 22 juli 2026 Bijgewerkt: 3 augustus 2026 Stand van de productinformatie: 3 augustus 2026

Nieuw · REST API · Automatisering

De nieuwe DomainCatcher API maakt het mogelijk om backorders op te halen en aan te maken, RGP- en ReCatch-domeinnamen te doorzoeken, ReCatch-domeinnamen over te nemen, vrije .de-domeinnamen te registreren en domeinnamen uit de Domex te kopen. De interface richt zich op domeininvesteerders, publishers, SEO-teams en developers die terugkerende domeinprocessen willen automatiseren.

De API wordt technisch en contractueel geleverd door DomainCatcher.com. deinrecatch.de legt de beschikbare endpoints, voorwaarden, antwoorden en veiligheidsregels uit. API-key, tegoed, aankopen en domeinbeheer blijven volledig binnen het DomainCatcher-account.

API-key aanmaken bij DomainCatcher Endpoints bekijken Over DomainCatcher

Na het inloggen: Account → API. Externe link naar DomainCatcher.com – daar gelden de actuele prijzen en voorwaarden.

De API in het kort

Voor wie is de API bedoeld?

De API biedt geen volledig domeinbeheer en geen DNS-beheer – ze dekt gericht backorder-, RGP-, ReCatch-, Free- en Domex-processen af.

Voorwaarden voor API-toegang

• Een actief DomainCatcher-account.
• Een Tier-niveau dat API-toegang toestaat.
• API-key uit: Account → API
• Voldoende DC-prepaid-tegoed voor betaalde acties.
• Endpoint-specifieke autorisatie.
• Bij Domex-aankopen een volledig geverifieerd standaardcontact.
• Veilige serverside opslag van de API-key.

Authenticatie met API-key

Voorkeursheader:

apiKey: DEIN_API_KEY

Overige, volgens de documentatie geaccepteerde vormen:

X-Api-Key: DEIN_API_KEY
Authorization: Bearer DEIN_API_KEY

Daarnaast technisch geaccepteerd: auth_key in de body of query.

• Bewaar de API-key nooit in de frontend.
• Publiceer de API-key nooit in lokale browser-JavaScript.
• Commit de API-key nooit naar Git.
• Toon de API-key nooit in screenshots.
• Verstuur de API-key nooit via Google Analytics.
• Gebruik de API-key nooit als URL-parameter in publiek zichtbare voorbeelden.
• Gebruik productiesleutels niet in demo-code.
• Beheer de sleutel serverside als omgevingsvariabele.
• Vernieuw de sleutel bij vermoede offenlegging direct in het DomainCatcher-account.

Uniform JSON-formaat

Alle antwoorden volgen in principe dit patroon:

{
  "success": true,
  "msg": "…",
  "data": {}
}

• success toont het algemene succes.
• msg bevat een begrijpelijke melding.
• data is afhankelijk van het endpoint.
• Bij fouten kan data.error een specifieke foutcode bevatten.
• Een HTTP-201-antwoord kan een asynchroon vervolgproces starten.

HTTP-statuscodes

Voor deze endpoints zijn geen verdere statuscodes gedocumenteerd.

Waarom data.restricted gecontroleerd moet worden

De volgende list-endpoints kunnen bij een beperkt Tier of onvoldoende tegoed slechts een teaser- resp. eerste pagina leveren: RGP, ReCatch, Free, Domex.

{
  "restricted": true,
  "total": 245,
  "count": 10,
  "domains": []
}

Een succesvol HTTP-antwoord betekent niet automatisch dat de volledige lijst is geleverd. Toepassingen moeten data.restricted controleren en mogen een teaser-lijst niet als volledig bestand presenteren.

Alle actueel gedocumenteerde endpoints

GET /api3/backorder

Doel: Backorders van de geauthenticeerde gebruiker ophalen.

Minstens één parameter vereist: domain, status

Toegestane statuswaarden: pending, pending extended, successful, unsuccessful, user storno

curl -X GET \
  "https://api.domaincatcher.com/api3/backorder" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"pending"}'

Antwoordgegevens:

[
  {
    "domain": "dein-recatch.de",
    "order_date": "DATUM",
    "status": "pending",
    "drop_date": "DATUM"
  }
]

De voorbeeldgegevens zijn placeholders; er worden geen echte klant- of ordergegevens getoond.

POST /api3/backorder

Doel: Nieuwe backorder aanmaken.

Verplichte parameter: domain

• alleen .de
• domeinnaam moet in de RGP zitten
• voldoende tegoed
• Tier moet backorders toestaan
• parallelle backorder-limiet mag niet overschreden worden

curl -X POST \
  "https://api.domaincatcher.com/api3/backorder" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"dein-recatch.de"}'

Mogelijke resultaten: 201 Created bij succes, 400 Bad Request bij domein-, RGP-, tegoed- of limietproblemen, 403 Forbidden bij ontbrekende Tier-autorisatie.

GET /api3/rgp

Doel: RGP-domeinnamen voor een periode of via een vrije zoekopdracht ophalen.

Verplichte parameter: date

Toegestane waarden: drop_in_30_days, drop_in_29_days, drop_in_2_days, drop_in_1_day, search

Bij search: minstens drie tekens, toegestane tekens volgens documentatie, Duitse umlauten en ß mogelijk.

curl -X GET \
  "https://api.domaincatcher.com/api3/rgp" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"drop_in_1_day"}'

Antwoordstructuur:

{
  "date": "drop_in_1_day",
  "restricted": false,
  "domains": [
    {
      "domain": "dein-recatch.de",
      "tld": "de",
      "drop_at": "DATUM",
      "did": "WERT",
      "blv": "WERT",
      "age": "WERT",
      "tlc": "WERT"
    }
  ]
}

De beoordelingsvelden (did, blv, age, tlc) worden hier niet vrij geïnterpreteerd, omdat hun exacte schaal in de beschikbare documentatie niet is gespecificeerd.

GET /api3/recatch

Doel: Actuele ReCatch-lijst ophalen.

Parameters (alle optioneel): search, limit, offset

Standaardlimiet: 100 · Maximumlimiet: 500. Bij beperkte toegang wordt de lijst ingekort.

curl -X GET \
  "https://api.domaincatcher.com/api3/recatch" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"recatch","limit":100,"offset":0}'

Antwoordstructuur:

{
  "restricted": false,
  "total": 1,
  "offset": 0,
  "limit": 100,
  "count": 1,
  "domains": [
    {
      "domain": "dein-recatch.de",
      "tld": "de",
      "drop_at": "DATUM",
      "did": "WERT",
      "blv": "WERT",
      "age": "WERT",
      "tlc": "WERT",
      "recatchId": "WERT"
    }
  ]
}

total is het totale aantal, count het aantal geleverde items, offset en limit dienen voor paginering, restricted toont een beperkte weergave.

POST /api3/recatch

Doel: Een ReCatch-domeinnaam overnemen.

Verplichte parameter: domain

Voorwaarden: .de-domeinnaam, domeinnaam moet in de juiste ReCatch-/RGP-status zijn, voldoende prepaid-tegoed, bijbehorende Tier-autorisatie, API-toegang.

curl -X POST \
  "https://api.domaincatcher.com/api3/recatch" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"dein-recatch.de"}'

Antwoord:

{
  "success": true,
  "msg": "Meldung",
  "data": {
    "pending": true
  }
}

pending: true betekent dat de reservering resp. technische verwerking nog loopt. Er mag niet voorbarig een definitief succes worden getoond.

GET /api3/free

Doel: Domeinnamen ophalen die al zijn verwijderd en in principe opnieuw geregistreerd kunnen worden.

Optionele parameters: search, date, limit, offset

Datumwaarden: dropToday, drop-1

Wildcardzoeken volgens documentatie: een leidend * zoekt naar uitgangen, een afsluitend * zoekt naar voorvoegsels, een sterretje midden in de zoekterm wordt afgewezen.

curl -X GET \
  "https://api.domaincatcher.com/api3/free" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"dropToday","limit":100,"offset":0}'

Antwoordvelden: date, restricted, total, offset, limit, count, domains, freeId

Een domeinnaam in de Free-lijst is geen blijvende beschikbaarheidsgarantie. Vóór de daadwerkelijke registratie wordt de beschikbaarheid opnieuw gecontroleerd.

POST /api3/free

Doel: Een domeinnaam uit de Free-lijst opnieuw registreren.

Verplichte parameter: domain

Voorwaarden: alleen .de, domeinnaam moet nog op de Free-lijst staan, domeinnaam moet bij de registry nog beschikbaar zijn, voldoende tegoed, geschikt en geverifieerd contact indien voor het proces vereist.

curl -X POST \
  "https://api.domaincatcher.com/api3/free" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"DOMAIN-AUS-DER-FREE-LISTE.de"}'

Succesgegevens:

{
  "domain": "DOMAIN-AUS-DER-FREE-LISTE.de",
  "taskmanager_id": 123,
  "domain_id": 456,
  "netto": "BETRAG",
  "msg": "Meldung"
}

De registratie wordt asynchroon via de taskmanager verwerkt. 201 Created betekent dat het proces is aangemaakt; de definitieve domeinstatus moet daarna worden gecontroleerd. Geen enkele domeinnaam wordt hier als daadwerkelijk vrij voorgesteld.

GET /api3/domex

Doel: Actuele Domex-aanbiedingen ophalen.

Optionele parameters: search, tld, provider, minPrice, maxPrice, limit, offset

Provider-waarden: all, domex, user

Prijslogica: price is de voor de gebruiker geldende prijs, is_netto toont of deze prijs netto wordt weergegeven, price_netto is altijd de nettoprijs. Er wordt geen algemene netto- of brutoprijsaanname gedaan.

curl -X GET \
  "https://api.domaincatcher.com/api3/domex" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"burger","provider":"domex","limit":100,"offset":0}'

Relevante antwoordvelden: domain, tld, type, price, price_netto, is_netto, provider, did, blv, age, tlc, domainId, is_own_domain

domainId is de unieke en voorkeurs-ID voor de daaropvolgende Domex-aankoop.

POST /api3/domex

Doel: Een domeinnaam uit de Domex kopen.

Verplichte parameter: een van beide – domain of domain_id (bij voorkeur domain_id).

curl -X POST \
  "https://api.domaincatcher.com/api3/domex" \
  -H "apiKey: DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain_id":12345}'

Voorwaarden: domeinnaam moet nog actief aangeboden worden, domeinnaam mag niet van de koper zelf zijn, voldoende tegoed, volledig geverifieerd standaardcontact, domeinnaam mag niet al verkocht zijn of in verwerking zijn.

Gedocumenteerde foutcodes: not_found, own_domain, no_money, not_available, selling, billing_failed, nis2

nis2 wordt met 403 Forbidden geretourneerd; andere gedocumenteerde fouten kunnen in data.error verschijnen. Er worden hier geen eigen foutcodes toegevoegd.

Technische bijzonderheid van GET-verzoeken

De beschikbare documentatie toont meerdere GET-verzoeken met een JSON-body. Sommige HTTP-clients, browserbibliotheken, proxy's of caches behandelen GET-verzoeken met body verschillend. Gebruik daarom de door DomainCatcher gedocumenteerde requestvorm en test de gekozen serverside HTTP-bibliotheek. Er wordt hier geen alternatieve parameteroverdracht verzonnen die niet officieel is gedocumenteerd.

Om deze reden ziet deze pagina bewust af van browser-fetch()-voorbeelden met een GET-body, aangezien dit afhankelijk van de implementatie niet toegestaan resp. niet betrouwbaar is. De voorkeur gaat uit naar cURL en serverside PHP cURL.

Wat kun je met de API automatiseren?

Verdieping: Domeinnaam beoordelen · Backlinks controleren · Domeinhistorie controleren · Merkencheck · ReCatch-checklist

Foutafhandeling voor integraties

• HTTP-statuscode controleren.
• success controleren.
• msg loggen.
• data.error controleren.
• restricted bij lijsten controleren.
• Bij asynchrone processen pending resp. ID's opslaan.
• Geen aankoopverzoek blind herhalen.
• Bij netwerkfouten met backoff werken.
• Bij 401 de API-key niet in logs schrijven.
• Bij 400 niet automatisch eindeloos opnieuw versturen.
• Bij 403 Tier- of contactstatus controleren.
• Bij 500 geen meervoudige aankopen riskeren door agressief herhalen.

Een concrete retry-frequentie wordt hier niet als officiële API-vereiste opgegeven, zolang er geen rate limit is gedocumenteerd.

API-key en aankoopacties beveiligen

• Gebruik de API-key alleen serverside.
• Bewaar secrets als omgevingsvariabelen.
• Scheid productie- en testsystemen.
• Reinig logs van authenticatieheaders.
• Automatiseer aankoopacties niet zonder plausibiliteitscontrole.
• Normaliseer de domeinnaam vóór POST-aanroepen.
• Sta alleen .de toe waar het endpoint dit vereist.
• Controleer prijs en domeinnaam direct vóór aankoop opnieuw.
• Ga niet uit van idempotentie als deze niet is gedocumenteerd.
• Herhaal mislukte verzoeken niet blind.
• Bewaak tegoed en Tier-autorisatie.
• Voer Domex-aankopen bij voorkeur uit met domain_id.
• Vervang de API-key direct bij vermoede offenlegging.
• Schrijf een API-antwoord nooit ongefilterd in publieke HTML.

Veelgestelde vragen over de DomainCatcher API

Verder lezen

Over DomainCatcher · Wat is ReCatch? · Backorder · RGP & vrije domeinnamen · Domex · Economische band · Redactionele richtlijnen · Privacyverklaring