PHPackages                             srapsware/domaindumper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. srapsware/domaindumper

ActiveLibrary[Utility & Helpers](/categories/utility)

srapsware/domaindumper
======================

Domain's state API and root database

2.3.1(1y ago)22151MITTypeScriptPHP >=7.0

Since Jan 6Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/domaindumper/domain-statistics)[ Packagist](https://packagist.org/packages/srapsware/domaindumper)[ Docs](https://www.domaindumper.com/)[ GitHub Sponsors](https://github.com/NomadProgrammer)[ Fund](https://opencollective.com/NomadProgrammer)[ RSS](/packages/srapsware-domaindumper/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (1)Versions (11)Used By (0)

DomainDumper
============

[](#domaindumper)

[![npm version](https://camo.githubusercontent.com/8eb4e3eb1a31df81431f259d45df897637c6488d4a55a6db77ec4567a94167dc/68747470733a2f2f62616467652e667572792e696f2f6a732f646f6d61696e64756d7065722e737667)](https://www.npmjs.com/package/domaindumper)[![GitHub license](https://camo.githubusercontent.com/3b93f9c26bf2aa3dd6e2378803b34012cd76378799539b9a7e55d547fb626426/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f646f6d61696e64756d7065722f646f6d61696e2d73746174697374696373)](https://github.com/domaindumper/domain-statistics/blob/main/LICENSE)

A JavaScript library for accessing domain registration statistics via the DomainDumper API.

Installation
------------

[](#installation)

```
npm install domaindumper
```

Features
--------

[](#features)

- Fetch registrar information and details
- Get TLD (Top Level Domain) details and lists
- Access domain registration statistics
- Country-based domain statistics
- Root zone database access
- Comprehensive error handling

Quick Start
-----------

[](#quick-start)

```
import {
  getRegistrarsList,
  getRegistrarsDetails,
  getTldDetails,
  getTldsList,
  getDomainStats,
  getRootDatabase
} from 'domaindumper';

// Basic usage example
const registrars = await getRegistrarsList();
console.log(registrars);
```

API Reference
-------------

[](#api-reference)

### Registrar Operations

[](#registrar-operations)

```
// Get basic registrar list
const registrars = await getRegistrarsList();
/* Response:
{
  "registrars": [
    {
      "id": 1,
      "name": "Example Registrar",
      "url": "https://example.com"
    }
  ]
}
*/

// Get detailed registrar information
const details = await getRegistrarsDetails();
/* Response:
{
  "registrars": [
    {
      "id": 1,
      "name": "Example Registrar",
      "url": "https://example.com",
      "details": {
        // Additional registrar details
      }
    }
  ]
}
*/
```

### TLD Operations

[](#tld-operations)

```
// Get list of all TLDs
const tldsList = await getTldsList();
/* Response:
[
  "com",
  "net",
  "org"
]
*/

// Get specific TLD details
const tldInfo = await getTldDetails('com');
/* Response:
{
  "name": "com",
  "type": "generic",
  "manager": "VeriSign Global Registry Services",
  "rootServers": [
    "a.gtld-servers.net",
    "b.gtld-servers.net"
  ]
}
*/

// Get root zone database
const rootDb = await getRootDatabase();
/* Response:
[
  {
    "name": "com",
    "type": "generic",
    "manager": "VeriSign Global Registry Services"
  }
]
*/
```

### Statistics Operations

[](#statistics-operations)

```
// Get domain statistics for specific date
const stats = await getDomainStats('2024', '02', '19');
/* Response:
{
  "countryStats": {
    "US": 1000000,
    "GB": 500000
  },
  "registrarStats": {
    "1": 100000,
    "2": 50000
  },
  "tldStats": {
    "com": 2000000,
    "net": 1000000
  }
}
*/
```

### Error Handling

[](#error-handling)

```
try {
  const stats = await getDomainStats('2024', '02', '19');
} catch (error) {
  if (error.response) {
    console.error('API Error:', error.response.data.message);
  } else {
    console.error('Network Error:', error.message);
  }
}
```

Testing
-------

[](#testing)

```
# Run all tests
npm test

# Run tests with coverage
npm test -- --coverage
```

Development
-----------

[](#development)

```
# Install dependencies
npm install

# Build the package
npm run build

# Run tests
npm test
```

API Documentation
-----------------

[](#api-documentation)

Full API documentation is available at:

- [API Documentation](https://statistics.domaindumper.com/api/v1)
- [Swagger UI](https://statistics.domaindumper.com/api-docs)

Support
-------

[](#support)

- Documentation:
- Email:
- Issues: [GitHub Issues](https://github.com/domaindumper/domain-statistics/issues)

License
-------

[](#license)

MIT License - see the [LICENSE](https://github.com/domaindumper/domain-statistics/blob/main/LICENSE) file for details.

Links
-----

[](#links)

- [NPM Package](https://www.npmjs.com/package/domaindumper)
- [GitHub Repository](https://github.com/domaindumper/domain-statistics)
- [Official Website](https://www.domaindumper.com)

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance65

Regular maintenance activity

Popularity15

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~128 days

Recently: every ~313 days

Total

11

Last Release

725d ago

Major Versions

1.8 → 2.22022-02-19

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/10991610?v=4)[NomadDeveloper](/maintainers/NomadProgrammer)[@nomadprogrammer](https://github.com/nomadprogrammer)

![](https://avatars.githubusercontent.com/u/604708?v=4)[shazz](/maintainers/shazz)[@shazz](https://github.com/shazz)

---

Top Contributors

[![ProgrammerNomad](https://avatars.githubusercontent.com/u/3428506?v=4)](https://github.com/ProgrammerNomad "ProgrammerNomad (61385 commits)")

---

Tags

domains-registeredpremium-servicesstatsdnsstatedomainnsroot

### Embed Badge

![Health badge](/badges/srapsware-domaindumper/health.svg)

```
[![Health](https://phpackages.com/badges/srapsware-domaindumper/health.svg)](https://phpackages.com/packages/srapsware-domaindumper)
```

###  Alternatives

[symfony/workflow

Provides tools for managing a workflow or finite state machine

63045.8M264](/packages/symfony-workflow)[yohang/finite

A simple PHP Finite State Machine

1.4k3.7M10](/packages/yohang-finite)[winzou/state-machine

A very lightweight yet powerful PHP state machine

52414.0M19](/packages/winzou-state-machine)[daverandom/libdns

DNS protocol implementation written in pure PHP

16446.7M15](/packages/daverandom-libdns)[spatie/dns

Retrieve DNS records

6092.7M22](/packages/spatie-dns)[sebdesign/laravel-state-machine

Winzou State Machine service provider for Laravel

3431.4M1](/packages/sebdesign-laravel-state-machine)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)