Introducing the official Akismet PHP SDK – Akismet
Skip to content
Derek Springer
June 15, 2026Updated on June 15, 2026
Filed under:Development
For twenty years, Akismet has kept spam out of WordPress. But spammers don’t care what your site runs on and neither do we.
Last month we launched the official Akismet Drupal module. Today we’re introducing the engine that powers it: the official Akismet PHP SDK, a first-party client that brings Akismet to any PHP application.
What it is, and who it’s for
The Akismet PHP SDK is a first-party PHP client for the Akismet API. It’s built for the platforms the WordPress plugin doesn’t reach: custom apps, SaaS backends, and PHP frameworks like Laravel and Symfony. (The official plugins are still the way to go for WordPress and Drupal.)
Under the hood it’s built to feel at home in a modern PHP codebase:
Covers the full Akismet API, from comment-check and spam/ham submissions to key verification, usage limits, and account stats.
Works with any PSR-18 HTTP client you already have (Guzzle, Symfony HttpClient, and the like) through auto-discovery.
Ships a typed exception hierarchy that redacts your API key, so credentials never leak into your logs.
A two-minute quick start
Install it with Composer:
composer require automattic/akismet-sdk
Then check a submission:
use Automattic\Akismet\Akismet;<br>use Automattic\Akismet\DTO\Content;<br>use Automattic\Akismet\Enum\ContentType;
$akismet = Akismet::create(<br>apiKey: 'your-api-key',<br>site: 'https://your-site.com',<br>);
$content = new Content(<br>userIp: $_SERVER['REMOTE_ADDR'],<br>userAgent: $_SERVER['HTTP_USER_AGENT'],<br>body: $formData['message'],<br>authorEmail: $formData['email'],<br>type: ContentType::ContactForm,<br>);
$result = $akismet->check($content);
if ($result->isSpam()) {<br>// Reject it, flag it, or queue it for review.<br>// $result->shouldDiscard() marks the blatant spam you can drop outright.
That’s the loop: build a Content object, call check(), act on the result.
Already running in production
The official Akismet Drupal module is built on this SDK. The SDK handles the API contract and type safety, while the module handles Drupal’s service wiring, queues, and moderation UI. That’s the pattern for Laravel, Symfony, and anything else you build: the SDK owns the Akismet integration and your framework owns the glue.
What’s new in 1.5.0
We have just released v1.5.0, which is about giving Akismet more to work with, and giving you more back:
Richer content signals: Content now carries the site’s language and character set, plus the surrounding conversation context, so every check has more to go on.
More insight into every verdict: CheckResult now surfaces the error and classification Akismet returns, so you can log and act on why something was flagged, not just whether it was.
Extended multi-site reporting: For keys that span many sites, the new extended key-sites data adds per-site metadata for cleaner reporting and account hygiene.
Get started
The SDK is open source and live on Packagist today.
Install: composer require automattic/akismet-sdk
Packagist: automattic/akismet-sdk
Source and docs: github.com/Automattic/akismet-sdk-php
You’ll need an Akismet API key to make calls. Akismet’s Personal plan is pay-what-you-can and free for personal, non-commercial sites. If you’re running something commercial, pick a paid plan that matches your traffic. Either way your code stays identical, since the plan lives with your API key, not in the SDK.
Related
Leave a reply Cancel reply
This site uses Akismet to reduce spam. Learn how your comment data is processed.
Comment
Subscribe
Subscribed
Akismet
Join 175 other subscribers
Sign me up
Already have a WordPress.com account? Log in now.
Akismet
Subscribe
Subscribed
Sign up
Log in
Copy shortlink
Report this content
View post in Reader
Manage subscriptions
Collapse this bar