A Laravel package for retrieving and parsing data from Cision News. Fetch press releases, financial reports, media posts, and structured article content using a simple and expressive API.

Features

Retrieve Cision RSS feeds by type (Press, News, Financial, Media)
Parse article pages and extract clean structured HTML
Automatically handles encoding, formatting, and clean-up of content
Fully testable and extensible

Installation

composer require mattitjaab/laravel-cision-feed

Set your Cision newsroom slug in your .env:

LARAVEL_CISION_FEED_SLUG=your-cision-slug

Optionally publish the config file:

php artisan vendor:publish --tag="laravel-cision-feed-config"

Feed timestamps (created_at) are converted to Europe/Stockholm by default. Override with LARAVEL_CISION_FEED_TIMEZONE.

Usage

use Mattitja\Cision\Cision;

$cision = new Cision();              // uses config('cision.slug')
$cision = new Cision('other-company'); // or pass a slug explicitly

// Fetch RSS entries
$items = $cision->press(); // or ->news(), ->financial(), ->media()

// Fetch full content for a specific article
$article = $cision->fetchContent('https://news.cision.com/se/example-company/r/your-article-slug,c1234567');

echo $article['header'];       // Article headline
echo $article['published_at']; // ISO timestamp
echo $article['content'];      // Clean HTML

Or use the facade:

use Mattitja\Cision\Facades\Cision;

$items = Cision::press();

All methods return false if the request fails or the response cannot be parsed.

Testing

composer test

Changelog

See CHANGELOG for recent changes.

Contributing

Contributions are welcome! Please open an issue or pull request.

Security

If you discover any security-related issues, please refer to our security policy.

Credits

License

The MIT License (MIT). See LICENSE for details.