Laravel G2

A Laravel client for the G2 API. A fluent G2 facade groups the reviews, products, reports, competitors, categories, and tracking endpoints behind resource accessors, authenticates every request with a token header, and throws a G2Exception on a non-2xx response instead of returning a silent error array.

Features

• Reviews — reviews()->list(), get()
• Products — products()->list(), get()
• Reports — reports()->list(), get()
• Competitors — competitors()->list()
• Categories — categories()->list(), get()
• Tracking — tracking()->visitors()
• Thin by design — every method returns the raw decoded JSON:API response as an array, no DTOs
• Fails loud — a non-2xx response throws G2Exception carrying the API's error message and HTTP status code

Installation

composer require jeffersongoncalves/laravel-g2

Optionally publish the config file:

php artisan vendor:publish --tag="g2-config"

Configuration

Add to your .env:

G2_API_TOKEN=your-api-token

Request API access at https://data.g2.com/api/v1 to get your token.

Config Options

// config/g2.php
return [
    'token' => env('G2_API_TOKEN'),
    'base_url' => env('G2_BASE_URL', 'https://data.g2.com/api/v1'),
];

Usage

use JeffersonGoncalves\G2\Facades\G2;
use JeffersonGoncalves\G2\Exceptions\G2Exception;

Reviews

G2::reviews()->list(productId: '123', state: 'published', page: 1, perPage: 25);
G2::reviews()->get('456');

Products

G2::products()->list(name: 'laravel', page: 1, perPage: 25);
G2::products()->get('123');

Reports

G2::reports()->list(page: 1, perPage: 25);
G2::reports()->get('789');

Competitors

G2::competitors()->list(productId: '123', page: 1, perPage: 25);

Categories

G2::categories()->list(name: 'crm', page: 1, perPage: 25);
G2::categories()->get('321');

Tracking

G2::tracking()->visitors(startDate: '2026-01-01', endDate: '2026-01-31', page: 1, perPage: 25);

Handling errors

try {
    $result = G2::products()->get('123');
} catch (G2Exception $e) {
    // $e->getMessage() — the API's errors[0].detail/title, or the raw response body
    // $e->statusCode  — the HTTP status code returned by G2
}

Testing

composer test

Static Analysis

composer analyse

Code Formatting

composer format

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

Please review our security policy on how to report security vulnerabilities.

Credits

• Jefferson Gonçalves
• All Contributors

License

The MIT License (MIT). Please see License File for more information.