@robtex/sdk

Lightweight SDK for the Robtex API. DNS, IP, AS, Bitcoin, and Lightning Network intelligence.

• Zero dependencies
• Plain ESM JavaScript with JSDoc types — no build step, no tsx, runs on plain node (>=20)
• Editor IntelliSense via JSDoc (works in VS Code, WebStorm, Cursor, etc.)
• Works everywhere: Node, Deno, Bun, Cloudflare Workers, browsers
• 55 endpoints covering DNS, passive DNS, IP reputation, geolocation, BGP, domain analysis, Bitcoin, and Lightning Network

Install

npm install @robtex/sdk

Quick Start

import { Robtex } from '@robtex/sdk';

const api = new Robtex();

// DNS lookup
const dns = await api.lookupDns({ hostname: 'google.com' });

// IP reputation — check against 100+ blocklists
const rep = await api.ipReputation({ ip: '8.8.8.8' });

// Passive DNS — find all records for a domain
const pdns = await api.pdnsForward({ domain: 'example.com' });

// Bitcoin address lookup
const addr = await api.lookupBitcoinAddress({ address: '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa' });

Authentication (Optional)

Works without any key (rate-limited to 10 req/hr). Three options for higher limits:

// Free — no key, 10 req/hr
const api = new Robtex();

// Pro API key — higher limits
const api = new Robtex({ apiKey: 'your-key' });

// RapidAPI key — managed billing, plans from $19/mo
const api = new Robtex({ rapidApiKey: 'your-rapidapi-key' });

Get a RapidAPI key at https://rapidapi.com/robtex/api/robtex

Multi-step Investigation Example

import { Robtex } from '@robtex/sdk';

const api = new Robtex();

// Investigate a domain: DNS + IP reputation + shared hosting
const dns = await api.lookupDns({ hostname: 'suspicious-site.com' });
const ip = dns.records.find(r => r.type === 'A')?.value;

if (ip) {
  const [reputation, shared, geo] = await Promise.all([
    api.ipReputation({ ip }),
    api.domainSharedIp({ hostname: 'suspicious-site.com' }),
    api.ipGeolocation({ ip }),
  ]);
  console.log({ dns, ip, reputation, shared, geo });
}

All Methods

DNS

Method	Description
lookupDns({ hostname })	All DNS records for a hostname
dnsA({ hostname })	A records
dnsAAAA({ hostname })	AAAA records
dnsMx({ hostname })	MX records
dnsNs({ hostname })	NS records
dnsTxt({ hostname })	TXT records
dnsCname({ hostname })	CNAME records
dnsSoa({ hostname })	SOA record
dnsPtr({ ip })	PTR record for an IP

Reverse DNS

Method	Description
reverseLookupDnsRecords({ value, type?, limit?, offset? })	Hostnames using a DNS value
reverseLookupIp({ ip, limit?, offset? })	Hostnames pointing to an IP
reverseLookupMx({ mx, limit?, offset? })	Hostnames using a mail server
reverseLookupNs({ nameserver, limit?, offset? })	Hostnames using a nameserver
reverseLookupCname({ target, limit?, offset? })	Hostnames CNAMEd to a target

Historic Reverse DNS

Method	Description
historicReverseLookupIp({ ip, limit?, offset? })	Previously pointed to an IP
historicReverseLookupNs({ nameserver, limit?, offset? })	Previously used a nameserver
historicReverseLookupMx({ mx, limit?, offset? })	Previously used a mail server
historicReverseLookupCname({ target, limit?, offset? })	Previously CNAMEd to a target

Passive DNS

Method	Description
pdnsForward({ domain })	Domain to DNS records (returns array)
pdnsReverse({ value, type? })	Value to domains (returns array)
pdnsReverseHistoric({ value, type? })	Historic reverse pDNS (returns array)

IP Intelligence

Method	Description
ipReputation({ ip })	Check against 100+ blocklists
ipGeolocation({ ip })	Country, city, coordinates
ipNetwork({ ip })	BGP route, ASN
ipToAsn({ ip })	Map IP to AS number
ipBlocklistCheck({ ip })	Threat intel blocklists (FireHOL, IPsum)
ipThreatIntel({ ip })	AbuseIPDB, CIRCL BGP ranking

Legacy IP/AS

Method	Description
ipquery({ ip })	Classic IP query (DNS + geo + network)
asquery({ asn })	Networks for an AS number

AS / Routing

Method	Description
asInfo({ asn })	AS name and organization
asPrefixes({ asn })	Announced BGP prefixes
lookupAsWhois({ asn })	AS WHOIS information

Domain Analysis

Method	Description
domainReputation({ hostname })	Reputation and threat data
domainRanking({ hostname })	Popularity (Tranco, Majestic, Umbrella, CrUX)
domainBlocklistCheck({ hostname })	DNS blocklist check
domainSharedIp({ hostname, limit? })	Domains on same IP
domainSharedNs({ hostname, limit? })	Domains with same nameservers
domainSharedMx({ hostname, limit? })	Domains with same mail server

Hostname Utilities

Method	Description
parseHostname({ hostname })	Parse into eTLD, domain, subdomain
isSubdomain({ hostname })	Check if subdomain
registeredDomain({ hostname })	Extract registered domain
tldInfo({ tld })	TLD information

Lightning Network

Method	Description
lookupLightningNode({ pubkey })	Node info by public key
lookupLightningChannel({ short_channel_id })	Channel info
lookupLightningChannelsPerNode({ pubkey, limit?, offset? })	Channels for a node
getRecommendedLightningPeers({ pubkey, count? })	Peer recommendations
searchLightningNodesByAlias({ alias, limit? })	Search nodes by name
latestLightningChannels({ count? })	Recently opened channels

Bitcoin

Method	Description
lookupBitcoinTransaction({ txid })	Transaction details
lookupBitcoinAddress({ address })	Address info and balance
lookupBitcoinBlock({ height })	Block details
bitcoinAddressTransactions({ address, limit?, offset? })	Transaction history
bitcoinTransactionSpends({ txid })	Spending transactions
bitcoinBlockchainStats({ start_height, end_height })	Block range statistics

Utility

Method	Description
lookupMac({ mac })	MAC address vendor (IEEE OUI)
checkEmail({ email })	Email verification via SMTP
ping()	API health check

Generic Call

For any endpoint, including future ones:

const result = await api.call('some_endpoint', { param1: 'value' });

Error Handling

import { Robtex, RobtexError } from '@robtex/sdk';

const api = new Robtex();
try {
  await api.ipReputation({ ip: '8.8.8.8' });
} catch (e) {
  if (e instanceof RobtexError && e.status === 429) {
    console.log(`Rate limited. Retry after ${e.retryAfter}s`);
  }
}

Custom Fetch

Pass your own fetch for proxies, logging, or testing:

const api = new Robtex({
  fetch: (url, init) => {
    console.log('Fetching:', url);
    return globalThis.fetch(url, init);
  },
});

Links

• Robtex — Web interface
• API Docs — OpenAPI spec
• MCP Server — Model Context Protocol
• RapidAPI — Managed API marketplace

License

MIT