Skip to main content

Command-line tool for domain intelligence and authority lookups

Project description

webl - Domain Intelligence CLI

Command-line tool for domain intelligence lookups. Get WebL Site Authority, age, launch detection, and industry data directly from your terminal.

Installation

Quick Install (recommended)

curl -fsSL https://websitelaunches.com/install.php | bash

This installer will automatically:

  • Detect your OS and Python version
  • Choose the best installation method (Homebrew, pipx, or pip)
  • Verify the installation
  • Show you quick start examples

macOS (Homebrew)

brew tap websitelaunches/tap
brew install webl

pip (all platforms)

pip install webl

pipx (recommended for CLI tools)

pipx install webl

Quick Start

# Look up a domain (no API key needed for 3k/month)
webl github.com

# Include historical data (requires Growth+ tier)
webl github.com --history

# Output as JSON
webl github.com --json

# Output as CSV
webl github.com --csv

# For higher limits, set your API key
webl config set-key YOUR_API_KEY

# Batch lookup (requires API key)
webl batch domains.txt

Free Tier (No API Key Required!)

You can use webl immediately without any signup:

  • 3,000 requests per month based on your IP address
  • Perfect for personal use and testing
  • No registration required

Upgrade for More

Sign up for an API key to get higher limits:

  • Starter: 50,000 requests/month + AI descriptions
  • Growth: 250,000 requests/month + historical data + batch lookups
  • Pro: 1,000,000 requests/month
  • Business: 5,000,000 requests/month + custom rate limits

Get your API key at: https://websitelaunches.com/api/

Usage

Single Domain Lookup

webl github.com
webl stripe.com --history
webl shopify.com --json

Output includes:

  • WebL Site Authority score (0-100)
  • Domain age and registration date
  • Launch detection and date
  • Industry category classification
  • AI-generated description

Batch Lookup

Create a text file with one domain per line:

# domains.txt
github.com
stripe.com
shopify.com

Then run:

webl batch domains.txt
webl batch domains.txt --csv > results.csv

Configuration

# Set API key
webl config set-key YOUR_API_KEY

# Show current config
webl config show

# Show config file path
webl config path

Output Formats

  • Pretty (default): Beautiful terminal output with tables
  • JSON: Machine-readable JSON (--json)
  • CSV: CSV format for spreadsheets (--csv)

Environment Variables

You can also set your API key via environment variable:

export WEBL_API_KEY=your_api_key
webl github.com

Examples

Basic lookup

$ webl github.com

╭─────────────── Domain Intelligence ───────────────╮
│ Domain         github.com                         │
│ Authority      85/100                             │
│ Age            17.2 years (2007-10-01)            │
│ Launch Date    2008-04-10                         │
│ Category       Developer Tools > Code Hosting     │
│ Description    GitHub is a development platform...│
╰────────────────────────────────────────────────────╯

API Usage: 1,247/250,000 requests this month (growth tier)

Historical data

$ webl github.com --history

╭─────────────── Domain Intelligence ───────────────╮
│ Domain         github.com                         │
│ Authority      85/100                             │
│ ...                                                │
╰────────────────────────────────────────────────────╯

Historical Authority:
Date      Authority  Release ID
2018-01   75         CC-MAIN-2018-05
2019-01   78         CC-MAIN-2019-04
2025-10   85         CC-MAIN-2025-40

Authority Change: +10 (+13.3%)

JSON output

$ webl github.com --json | jq
{
  "ok": true,
  "data": {
    "domain": "github.com",
    "site_authority": 85,
    "domain_age": 17.2,
    ...
  }
}

CSV output

$ webl github.com --csv
domain,authority,age_years,age_date,launch_detected,launch_date,category...
github.com,85,17.2,2007-10-01,true,2008-04-10,Developer Tools,...

Batch processing

$ webl batch domains.txt --csv > results.csv

API Tiers

  • Free: 3,000 requests/month (no API key needed!)
  • Starter: 50,000 requests/month + AI descriptions
  • Growth: 250,000 requests/month + historical data + batch lookups
  • Pro: 1,000,000 requests/month
  • Business: 5,000,000 requests/month + custom rate limits

Historical data (--history flag) requires Growth tier or higher. Batch lookups (webl batch) require an API key (any paid tier).

Support

License

MIT License - See LICENSE file for details

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

webl-0.2.0.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

webl-0.2.0-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

Details for the file webl-0.2.0.tar.gz.

File metadata

  • Download URL: webl-0.2.0.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for webl-0.2.0.tar.gz
Algorithm Hash digest
SHA256 bcce95ae2e43ffb918e8580fcd3c133f144b92e2196bb75611cbb4048a89de98
MD5 c27b77d855b029948ded69595fb00282
BLAKE2b-256 84e3d9683dd0f5ee6075390a19c6bd9c93c33249e6aad84bebf512f604cde068

See more details on using hashes here.

File details

Details for the file webl-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: webl-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 10.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for webl-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 25027e29ff411b321945280080c884381e8fba5b8bb6304df812a7228eae3cc6
MD5 ae19411473c26d091c99a9eac6c35768
BLAKE2b-256 73541b1c85cf3407d4483ed5c18dfa2b9ee4b123ed0ae7ae5f07bf8e6aecaa50

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page