\n\n\n# domain-rank \r\n\r\nLook up top-ranked domains to get their name, human-readable source label, influence rank, and favicon.\r\n\r\nRank data comes from the [Tranco List](https://tranco-list.eu/) (aggregates Cisco Umbrella, Majestic, Farsight, Chrome UX, and Cloudflare Radar) and [CommonCrawl](https://commoncrawl.org) backlink counts. \r\n\r\n**Use cases:** search/URL autocomplete, bookmark launchers, LLM web-app recommendations, domain reputation scoring.\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install domain-rank\r\n# or\r\npnpm add domain-rank\r\n# or\r\nyarn add domain-rank\r\n```\r\n\r\n## Usage\r\n\r\n### Look up a domain\r\n\r\n```js\r\nimport { lookupDomain } from 'domain-rank';\r\n\r\nconst result = lookupDomain('facebook.com');\r\nconsole.log(result);\r\n// {\r\n// domain: 'facebook.com',\r\n// name: 'Facebook',\r\n// rank: 1,\r\n// title: 'Facebook',\r\n// newsRank: undefined,\r\n// newsTitle: undefined,\r\n// langCode: undefined\r\n// }\r\n```\r\n\r\n### Get top domains\r\n\r\n```js\r\nimport { getTopDomains } from 'domain-rank';\r\n\r\n// Get top 10 domains\r\nconst top10 = getTopDomains(10);\r\nconsole.log(top10);\r\n// [\r\n// { domain: 'facebook.com', name: 'Facebook', rank: 1, ... },\r\n// { domain: 'google.com', name: 'Google', rank: 2, ... },\r\n// { domain: 'instagram.com', name: 'Instagram', rank: 3, ... },\r\n// ...\r\n// ]\r\n```\r\n\r\n### Search domains\r\n\r\n```js\r\nimport { searchDomains } from 'domain-rank';\r\n\r\nconst results = searchDomains('social', 5);\r\n// Returns up to 5 domains matching 'social' in name, domain, or title\r\n// sorted by rank\r\n```\r\n\r\n### Get favicon\r\n\r\n```js\r\nimport { getFaviconForDomain } from 'domain-rank';\r\n\r\n// Get as base64\r\nconst base64Favicon = await getFaviconForDomain('google.com');\r\n\r\n// Get as URL\r\nconst faviconURL = await getFaviconForDomain('google.com', false);\r\n// Returns: 'https://www.google.com/s2/favicons?domain=google.com'\r\n```\r\n\r\n### Format domain names\r\n\r\n```js\r\nimport { formatDomainAsTitle } from 'domain-rank';\r\n\r\nconst formatted = formatDomainAsTitle('nytimes.com');\r\n// Returns: \"NY Times\" - human-readable name with proper capitalization\r\n```\r\n\r\n### Utility functions\r\n\r\n```js\r\nimport { convertURLToDomain, isURLValid, getTotalDomains } from 'domain-rank';\r\n\r\n// Extract domain from URL\r\nconst domain = convertURLToDomain('https://en.wikipedia.org/wiki/Main_Page');\r\n// Returns: 'wikipedia'\r\n\r\n// Validate URL\r\nconst isValid = isURLValid('https://example.com');\r\n// Returns: true\r\n\r\n// Get total number of domains in dataset\r\nconst total = getTotalDomains();\r\n// Returns: ~100000\r\n```\r\n\r\n## Dataset Statistics\r\n\r\n- **Total domains**: 10,020 top-ranked domains\r\n- **Data file**: `data/domain-rank-merged.json` (297 KB)\r\n- **Format**: Pre-loaded in memory for instant lookups\r\n- **Bundle size**: \r\n - ESM: 828 KB (231 KB gzipped)\r\n - CJS: 828 KB (231 KB gzipped)\r\n\r\n### Top 5 Domains\r\n\r\n| Rank | Domain | Name |\r\n|------|--------|------|\r\n| 1 | facebook.com | Facebook |\r\n| 2 | google.com | Google |\r\n| 3 | instagram.com | Instagram |\r\n| 4 | youtube.com | YouTube |\r\n| 5 | linkedin.com | LinkedIn |\r\n\r\n## Data Format\r\n\r\n### Source Data\r\n\r\nThe raw data is stored in `data/domain-rank-merged.json` as a compact object format:\r\n\r\n```json\r\n{\r\n \"facebook.com\": [\"Facebook\", 1],\r\n \"google.com\": [\"Google\", 2],\r\n \"nytimes.com\": [197, 38, \"NY Times\"]\r\n}\r\n```\r\n\r\nFormat: `[name, rank]` or `[newsRank, rank, title]` for news domains.\r\n\r\n### Library API\r\n\r\nThe library includes 10,020 top-ranked domains with the following information:\r\n\r\n- **domain**: The domain name (e.g., \"facebook.com\")\r\n- **name**: Human-readable name (e.g., \"Facebook\")\r\n- **rank**: Overall influence rank (lower is better, 1 is top)\r\n- **title**: Full title/description\r\n- **newsRank**: Rank for news/media domains (if applicable)\r\n- **newsTitle**: Media-specific title (if applicable)\r\n- **langCode**: Primary language code (if applicable)\r\n\r\n### Data Sources\r\n\r\nThe ranking combines multiple authoritative sources:\r\n\r\n1. **[Tranco List](https://tranco-list.eu/)** - Aggregates:\r\n - Cisco Umbrella (DNS resolver data)\r\n - Majestic Million (backlink analysis)\r\n - Farsight (passive DNS data)\r\n - Chrome UX Report (real user metrics)\r\n - Cloudflare Radar (global network data)\r\n\r\n2. **[CommonCrawl](https://commoncrawl.org)** - Web-wide backlink counts from petabytes of crawled data\r\n\r\nThis multi-source approach provides a more stable and manipulation-resistant ranking than single-source lists.\r\n\r\n## API Reference\r\n\r\n### `lookupDomain(domain: string): DomainLookupResult | null`\r\nLook up information for a specific domain.\r\n\r\n### `getTopDomains(n?: number): DomainLookupResult[]`\r\nGet top N domains by rank. Default: 100.\r\n\r\n### `searchDomains(query: string, limit?: number): DomainLookupResult[]`\r\nSearch domains by name/domain/title. Default limit: 10.\r\n\r\n### `getAllDomains(): DomainLookupResult[]`\r\nGet all domains sorted by rank.\r\n\r\n### `getTotalDomains(): number`\r\nGet total number of domains in the dataset.\r\n\r\n### `getFaviconForDomain(urlOrDomain: string, formatBase64?: boolean): Promise`\r\nFetch favicon for a domain. Returns base64 by default, or URL if `formatBase64` is false.\r\n\r\n### `formatDomainAsTitle(domain: string): string`\r\nFormat domain into human-readable name with proper capitalization.\r\n\r\n### `cleanSourceTitle(title: string): string | null`\r\nClean and normalize a page title (removes common suffixes, HTML, etc.).\r\n\r\n### `shouldRemoveDomain(domain: string): boolean`\r\nCheck if a domain should be removed from rankings.\r\n\r\n### `findMainDomain(domain: string): string | null`\r\nFind the main domain for a given alternate domain.\r\n\r\n### `getTitleOverride(domain: string): string | null`\r\nGet a custom title override for a domain.\r\n\r\n### `getSourceTitle(domain: string): Promise`\r\nFetch the page title from a domain's website.\r\n\r\n### `convertURLToDomain(url: string): string`\r\nExtract domain from URL.\r\n\r\n### `isURLValid(url: string): boolean`\r\nValidate URL format.\r\n\r\n## Development\r\n\r\n```bash\r\n# Install dependencies\r\npnpm install\r\n\r\n# Type check\r\npnpm run type-check\r\n\r\n# Build library\r\npnpm run build\r\n\r\n# Run tests\r\npnpm test\r\n```\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"readme.md"}
![](\"https://i.imgur.com/1MRYUqC.png\")
\n![\"Documentation\"](\"https://img.shields.io/badge/Docs-blue?logo=ReadTheDocs&logoColor=white\"){kind=icon}
![\"GitHub](\"https://img.shields.io/github/stars/OpenSourceAGI/qwksearch-research-agent\")
![\"NPM](\"https://img.shields.io/npm/dm/domain-rank.svg\"){kind=icon}
\n ![\"npm](\"https://img.shields.io/npm/v/domain-rank.svg\"){kind=icon}
\n ![\"NPM](\"https://img.shields.io/npm/dt/domain-rank.svg\"){kind=icon}
\n ![\"TypeScript](\"https://img.shields.io/npm/types/domain-rank\")
![\"GitHub](\"https://img.shields.io/github/issues/OpenSourceAGI/qwksearch-research-agent?logo=github\")
![\"Open](\"https://img.shields.io/github/issues-pr/OpenSourceAGI/qwksearch-research-agent?logo=github&label=PRs\")
![\"Merged](\"https://img.shields.io/github/issues-pr-closed/OpenSourceAGI/qwksearch-research-agent?logo=github&label=PRs%20merged&color=8957e5\")
![\"GitHub](\"https://img.shields.io/github/discussions/OpenSourceAGI/qwksearch-research-agent\")
![\"GitHub](\"https://img.shields.io/github/last-commit/OpenSourceAGI/qwksearch-research-agent.svg\")
\n ![\"Open](\"https://developer.stackblitz.com/img/open_in_stackblitz.svg\")
\n ![\"Bun\"](\"https://img.shields.io/badge/Bun-14151A?logo=bun&logoColor=white\"){kind=icon}
![\"TypeScript\"](\"https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white\"){kind=icon}
![\"Vite\"](\"https://img.shields.io/badge/Vite-646CFF?logo=vite&logoColor=white\"){kind=icon}
![\"Vitest\"](\"https://img.shields.io/badge/Vitest-6E9F18?logo=vitest&logoColor=white\"){kind=icon}