PHPackages messerli90/hunterio - 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. [Mail & Notifications](/categories/mail) 4. / 5. messerli90/hunterio ActiveLibrary[Mail & Notifications](/categories/mail) messerli90/hunterio =================== Laravel wrapper to discover email addresses through the Hunter.io API 2.0.0(5y ago)43006[1 issues](https://github.com/messerli90/hunterio/issues)MITPHPPHP ^7.4|^8.0 Since Jun 24Pushed 2y ago1 watchersCompare [ Source](https://github.com/messerli90/hunterio)[ Packagist](https://packagist.org/packages/messerli90/hunterio)[ Docs](https://github.com/messerli90/hunterio)[ RSS](/packages/messerli90-hunterio/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (4)Versions (7)Used By (0) Hunter.io ========= [](#hunterio) [![Latest Version on Packagist](https://camo.githubusercontent.com/accf29eb7b69df111f130f69499061060c2f47e19099b925a59ffcbf5a4854e8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d65737365726c6939302f68756e746572696f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/messerli90/hunterio)[![Build Status](https://camo.githubusercontent.com/603f93148989fc8177cad5a420f9d0ef6c79b67e96793adb14247c0afb413bb5/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6d65737365726c6939302f68756e746572696f2f6d61696e2e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/messerli90/hunterio)[![Quality Score](https://camo.githubusercontent.com/11a8c56b414c85bc6508d7cadcd0268b9d73872eba9ee3c0e90de66d8e2c5a40/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6d65737365726c6939302f68756e746572696f2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/messerli90/hunterio)[![Total Downloads](https://camo.githubusercontent.com/117659814d71473784be5e24c73c49cd55d2c8210fb4e2f9e40541e8c68294dd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d65737365726c6939302f68756e746572696f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/messerli90/hunterio) Using this package you can easily query the [Hunter.io](https://hunter.io/) API. Here are some examples of the provided methods: ``` use Hunter; // Retrieve email addresses at a given domain Hunter::domainSearch('ghost.org') // Retrieve email addresses of people with a marketing title from ghost.org Hunter::domainSearch()->domain('ghost.org')->department('marketing')->get(); // Find an email address belonging to John Doe working at Ghost Hunter::emailFinder()->company('Ghost')->name('John Doe')->get(); ``` Installation ------------ [](#installation) > Requires Laravel 8+ and PHP 7.4+ > > For Laravel 7 use `messerli90/hunter@1.1.0` You can install the package via composer: ``` composer require messerli90/hunterio ``` You'll need an [API key](https://hunter.io/api) from Hunter.io Optionally, you can publish the config file of this package with this command: ``` php artisan vendor:publish --provider="Messerli90\Hunterio\HunterServiceProvider" ``` or, manually add it to your `config/services.php` file ``` [ ... 'hunter' => [ 'key' => env('HUNTER_API_KEY') ] ] ``` Usage ----- [](#usage) Read the [Hunter.io API Documentation](https://hunter.io/api-documentation/v2) to check how to handle each endpoint's response. ### Domain Search [](#domain-search) Search all the email addresses corresponding to one website. ``` // Shortcut to search by domain Hunter::domainSearch('ghost.org') // Specify searching by company name or domain Hunter::domainSearch()->company('Ghost')->get(); Hunter::domainSearch()->domain('ghost.org')->get(); // Narrow your search by chaining attributes $query = Hunter::domainSearch()->company('Ghost')->domain('ghost.org') ->seniority(['senior', 'executive'])->department('marketing') ->limit(5)->skip(5)->type('personal') ->get(); ``` ### Email Finder [](#email-finder) This API endpoint generates or retrieves the most likely email address from a domain name, a first name and a last name. ``` // Shortcut assumes searching by domain Hunter::emailFinder('ghost.org')->name('John', 'Doe')->get(); // Search by first and last name Hunter::emailFinder()->domain('ghost.org')->name('John', 'Doe')->get(); // or use a single string to search by 'full name' Hunter::emailFinder()->company('Ghost')->name('John Doe')->get(); ``` ### Email Count [](#email-count) This API endpoint allows you to know how many email addresses we have for one domain or for one company. It's free and doesn't require authentication. > This endpoint is public does not require an API key ``` // Passing argument assumes searching by domain Hunter::emailCount('ghost.org'); // Or specify domain or company name Hunter::emailCount()->company('Ghost')->get(); // Narrow search to only 'personal' addresses Hunter::emailCount()->domain('ghost.org')->type('personal')->get(); ``` ### Email Verifier [](#email-verifier) This API endpoint allows you to verify the deliverability of an email address. ``` Hunter::verifyEmail('steli@close.io'); ``` ### Account [](#account) This API endpoint enables you to get information regarding your Hunter account at any time. ``` Hunter::account(); ``` --- ### Testing [](#testing) ``` ./vendor/bin/phpunit ``` ### Roadmap [](#roadmap) - Domain Search - Email Finder - Email Verifier - Email Count - Account Information - Leads - Leads List ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) If you discover any security related issues, please tweet me at @michaelmesserli instead of using the issue tracker. Credits ------- [](#credits) - [Michael Messerli](https://github.com/messerli90) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 30 — LowBetter than 64% of packages Maintenance15 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community10 Small or concentrated contributor base Maturity64 Established project with proven stability 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 ~85 days Total 4 Last Release 1895d ago Major Versions 1.1.0 → 2.0.02021-03-09 PHP version history (2 changes)1.0.0PHP ^7.2 2.0.0PHP ^7.4|^8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/3306651?v=4)[Michael Messerli](/maintainers/messerli90)[@messerli90](https://github.com/messerli90) --- Top Contributors [![messerli90](https://avatars.githubusercontent.com/u/3306651?v=4)](https://github.com/messerli90 "messerli90 (52 commits)") --- Tags apiemailwrappermesserli90hunterio ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/messerli90-hunterio/health.svg) ``` [![Health](https://phpackages.com/badges/messerli90-hunterio/health.svg)](https://phpackages.com/packages/messerli90-hunterio) ``` ### Alternatives [ecomailcz/ecomail Ecomail.cz API Wrapper 17383.8k4](/packages/ecomailcz-ecomail)[pitchero/reseller-club A PHP SDK for the ResellerClub API. 1514.8k1](/packages/pitchero-reseller-club) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)