Laravel Snov

https://github.com/jeffersongoncalves/laravel-snov
Admin
Laravel Snov is a Laravel package providing a fluent client for the Snov.io API to manage domain...
Tokens:1,708
Snippets:36
Trust Score:9.8
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Import Snov Facade and Exception

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Import the Snov facade and SnovException class for usage examples.

```php
use JeffersonGoncalves\Snov\Facades\Snov;
use JeffersonGoncalves\Snov\Exceptions\SnovException;
```

--------------------------------

### Install Laravel Snov with Composer

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Install the Laravel Snov package via Composer.

```bash
composer require jeffersongoncalves/laravel-snov
```

--------------------------------

### List Operations

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Retrieve all lists and get prospects from a specific list with pagination.

```php
Snov::lists()->all();
Snov::lists()->prospects(12345, page: 1, perPage: 100);
```

--------------------------------

### Drip Campaign Operations

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Manage drip campaigns: list all campaigns, get campaign emails, and add a prospect to a campaign.

```php
Snov::campaigns()->all();
Snov::campaigns()->emails(7);
Snov::campaigns()->addProspect(7, 'ada@example.com', 'Ada', 'Lovelace');
```

--------------------------------

### Run Code Formatting

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Run code formatting with Pint.

```bash
composer format
```

--------------------------------

### Run Tests

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Run the test suite.

```bash
composer test
```

--------------------------------

### Run Static Analysis

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Run static analysis with PHPStan.

```bash
composer analyse
```

--------------------------------

### Configure Snov.io Credentials in .env

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Add your Snov.io API credentials to the .env file. Generate them at https://app.snov.io/api-setting.

```env
SNOV_CLIENT_ID=your-client-id
SNOV_CLIENT_SECRET=your-client-secret
```

--------------------------------

### Publish Snov Config File

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Optionally publish the package configuration file.

```bash
php artisan vendor:publish --tag="snov-config"
```

--------------------------------

### Technology Checker

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Check the technology stack of a domain.

```php
Snov::technology()->check('example.com');
```

--------------------------------

### Prospect Operations

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Find a prospect by email and add a prospect to a list.

```php
Snov::prospects()->find('ada@example.com');
Snov::prospects()->addToList('ada@example.com', 'Ada', 'Lovelace', listId: 12345);
```

--------------------------------

### Domain Search and Count

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Search domains and count results using the Snov facade.

```php
Snov::domains()->search('example.com', type: 'all', limit: 100);
Snov::domains()->count('example.com');
```

--------------------------------

### Email Finder and Verifier

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Find emails for a person and verify single or multiple email addresses.

```php
Snov::emails()->find('Ada', 'Lovelace', 'example.com');
Snov::emails()->verify('ada@example.com');
Snov::emails()->verify(['ada@example.com', 'grace@example.com']);
```

--------------------------------

### Snov Config Options

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Configuration options for the Laravel Snov package. The base_url defaults to https://api.snov.io/v1 and cache_key to snov.access_token.

```php
// config/snov.php
return [
    'client_id' => env('SNOV_CLIENT_ID'),
    'client_secret' => env('SNOV_CLIENT_SECRET'),
    'base_url' => env('SNOV_BASE_URL', 'https://api.snov.io/v1'),
    'cache_key' => env('SNOV_CACHE_KEY', 'snov.access_token'),
];
```

--------------------------------

### Handling SnovException

Source: https://github.com/jeffersongoncalves/laravel-snov/blob/main/README.md

Handle SnovException thrown on non-2xx responses. Access the API error message via getMessage() and the HTTP status code via statusCode.

```php
try {
    $result = Snov::domains()->count('example.com');
} catch (SnovException $e) {
    // $e->getMessage() — the API's message/error_description, or the raw response body
    // $e->statusCode  — the HTTP status code returned by Snov.io
}
```
Tokens:
Raw