{"id":51126532,"url":"https://github.com/apiverve/whois-lookup-python-tutorial","last_synced_at":"2026-06-25T08:01:58.121Z","repository":{"id":338744459,"uuid":"1158968749","full_name":"apiverve/whois-lookup-python-tutorial","owner":"apiverve","description":"WHOIS lookup tool for domain registration information using Python","archived":false,"fork":false,"pushed_at":"2026-02-16T07:41:24.000Z","size":14,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-16T14:19:42.539Z","etag":null,"topics":["apiverve","cli","domain-lookup","domain-research","networking","python","tutorial","whois"],"latest_commit_sha":null,"homepage":"https://apiverve.com/marketplace/whoislookup","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apiverve.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-16T06:26:50.000Z","updated_at":"2026-02-16T07:41:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/apiverve/whois-lookup-python-tutorial","commit_stats":null,"previous_names":["apiverve/whois-lookup-python-tutorial"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/apiverve/whois-lookup-python-tutorial","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apiverve%2Fwhois-lookup-python-tutorial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apiverve%2Fwhois-lookup-python-tutorial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apiverve%2Fwhois-lookup-python-tutorial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apiverve%2Fwhois-lookup-python-tutorial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apiverve","download_url":"https://codeload.github.com/apiverve/whois-lookup-python-tutorial/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apiverve%2Fwhois-lookup-python-tutorial/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34765322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-25T02:00:05.521Z","response_time":101,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apiverve","cli","domain-lookup","domain-research","networking","python","tutorial","whois"],"created_at":"2026-06-25T08:01:58.013Z","updated_at":"2026-06-25T08:01:58.116Z","avatar_url":"https://github.com/apiverve.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WHOIS Lookup Tool | APIVerve API Tutorial\r\n\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\r\n[![Build](https://img.shields.io/badge/Build-Passing-brightgreen.svg)]()\r\n[![Python](https://img.shields.io/badge/Python-3.7+-3776ab)](https://python.org)\r\n[![APIVerve | WHOIS Lookup](https://img.shields.io/badge/APIVerve-WHOIS_Lookup-purple)](https://apiverve.com/marketplace/whoislookup?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial)\r\n\r\nA Python CLI tool that looks up domain registration information. View registrar, dates, nameservers, and contact details.\r\n\r\n![Screenshot](https://raw.githubusercontent.com/apiverve/whois-lookup-python-tutorial/main/screenshot.jpg)\r\n\r\n---\r\n\r\n### Get Your Free API Key\r\n\r\nThis tutorial requires an APIVerve API key. **[Sign up free](https://dashboard.apiverve.com?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial)** - no credit card required.\r\n\r\n---\r\n\r\n## Features\r\n\r\n- Look up WHOIS data for any domain\r\n- View registrar information\r\n- See creation and expiry dates\r\n- View nameservers\r\n- See domain status codes\r\n- Contact information (when available)\r\n- Interactive mode or command-line arguments\r\n\r\n## Quick Start\r\n\r\n1. **Clone this repository**\r\n   ```bash\r\n   git clone https://github.com/apiverve/whois-lookup-python-tutorial.git\r\n   cd whois-lookup-python-tutorial\r\n   ```\r\n\r\n2. **Install dependencies**\r\n   ```bash\r\n   pip install -r requirements.txt\r\n   ```\r\n\r\n3. **Add your API key**\r\n\r\n   Open `lookup.py` and replace the API key:\r\n   ```python\r\n   API_KEY = 'your-api-key-here'\r\n   ```\r\n\r\n4. **Run the tool**\r\n\r\n   Interactive mode:\r\n   ```bash\r\n   python lookup.py\r\n   ```\r\n\r\n   Command line mode:\r\n   ```bash\r\n   python lookup.py github.com\r\n   ```\r\n\r\n## Usage Examples\r\n\r\n### Look up a domain\r\n```bash\r\n$ python lookup.py github.com\r\n\r\n=======================================================\r\n  WHOIS Lookup: github.com\r\n=======================================================\r\n\r\n  Registrar Information\r\n  ---------------------------------------------------\r\n  Registrar:      MarkMonitor Inc.\r\n  Created:        2007-10-09\r\n  Expires:        2026-10-09\r\n  Updated:        2024-09-08\r\n\r\n  Domain Status\r\n  ---------------------------------------------------\r\n    clientDeleteProhibited\r\n    clientTransferProhibited\r\n    clientUpdateProhibited\r\n\r\n  Nameservers\r\n  ---------------------------------------------------\r\n    dns1.p08.nsone.net\r\n    dns2.p08.nsone.net\r\n    dns3.p08.nsone.net\r\n    dns4.p08.nsone.net\r\n    ns-1283.awsdns-32.org\r\n    ns-1707.awsdns-21.co.uk\r\n    ns-421.awsdns-52.com\r\n    ns-520.awsdns-01.net\r\n\r\n=======================================================\r\n```\r\n\r\n## Project Structure\r\n\r\n```\r\nwhois-lookup-python-tutorial/\r\n├── lookup.py           # Main Python script\r\n├── requirements.txt    # Dependencies (requests)\r\n├── screenshot.jpg      # Preview image\r\n├── LICENSE             # MIT license\r\n├── .gitignore          # Git ignore rules\r\n└── README.md           # This file\r\n```\r\n\r\n## How It Works\r\n\r\n1. User provides a domain name\r\n2. Script cleans and validates the input\r\n3. API queries WHOIS database\r\n4. Script formats and displays results\r\n\r\n### The API Call\r\n\r\n```python\r\nresponse = requests.get(\r\n    'https://api.apiverve.com/v1/whoislookup',\r\n    params={'domain': domain},\r\n    headers={'x-api-key': API_KEY}\r\n)\r\n```\r\n\r\n## API Reference\r\n\r\n**Endpoint:** `GET https://api.apiverve.com/v1/whoislookup`\r\n\r\n**Query Parameters:**\r\n\r\n| Parameter | Type | Required | Description |\r\n|-----------|------|----------|-------------|\r\n| `domain` | string | Yes | Domain to look up (e.g., \"google.com\") |\r\n\r\n**Example Response:**\r\n\r\n```json\r\n{\r\n  \"status\": \"ok\",\r\n  \"error\": null,\r\n  \"data\": {\r\n    \"domainName\": \"MYSPACE.COM\",\r\n    \"registrar\": \"GoDaddy.com, LLC\",\r\n    \"createdDate\": \"1996-02-22T05:00:00Z\",\r\n    \"expiryDate\": \"2029-02-23T05:00:00Z\",\r\n    \"updatedDate\": \"2023-01-17T00:16:21Z\",\r\n    \"domainStatus\": [\r\n      \"client delete prohibited\",\r\n      \"client transfer prohibited\"\r\n    ],\r\n    \"nameServers\": [\r\n      \"ns-cloud-a1.googledomains.com\",\r\n      \"ns-cloud-a2.googledomains.com\"\r\n    ],\r\n    \"registrarURL\": \"http://www.godaddy.com\"\r\n  }\r\n}\r\n```\r\n\r\n## Use Cases\r\n\r\n- **Domain research** - Check who owns a domain\r\n- **Due diligence** - Verify domain ownership\r\n- **Expiry tracking** - Monitor domain expiration\r\n- **Brand protection** - Find infringing domains\r\n- **Security investigation** - Research suspicious domains\r\n- **Sales prospecting** - Find domain contact info\r\n\r\n## Customization Ideas\r\n\r\n- Add domain expiry alerts\r\n- Monitor multiple domains from a list\r\n- Save results to CSV/JSON\r\n- Build a web interface\r\n- Compare WHOIS history over time\r\n- Integrate with CRM systems\r\n\r\n## Related APIs\r\n\r\nExplore more APIs at [APIVerve](https://apiverve.com/marketplace?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial):\r\n\r\n- [Domain Availability](https://apiverve.com/marketplace/domainavailability?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial) - Check if a domain is available\r\n- [DNS Lookup](https://apiverve.com/marketplace/dnslookup?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial) - Check DNS records\r\n- [SSL Checker](https://apiverve.com/marketplace/sslchecker?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial) - Check SSL certificates\r\n\r\n## Free Plan Note\r\n\r\nThis tutorial works with the free APIVerve plan. Some APIs may have:\r\n- **Locked fields**: Premium response fields return `null` on free plans\r\n- **Ignored parameters**: Some optional parameters require a paid plan\r\n\r\nThe API response includes a `premium` object when limitations apply. [Upgrade anytime](https://dashboard.apiverve.com/plans) to unlock all features.\r\n\r\n## License\r\n\r\nMIT - see [LICENSE](LICENSE)\r\n\r\n## Links\r\n\r\n- [Get API Key](https://dashboard.apiverve.com?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial) - Sign up free\r\n- [APIVerve Marketplace](https://apiverve.com/marketplace?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial) - Browse 300+ APIs\r\n- [WHOIS Lookup API](https://apiverve.com/marketplace/whoislookup?utm_source=github\u0026utm_medium=tutorial\u0026utm_campaign=whois-lookup-python-tutorial) - API details\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapiverve%2Fwhois-lookup-python-tutorial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapiverve%2Fwhois-lookup-python-tutorial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapiverve%2Fwhois-lookup-python-tutorial/lists"}