Skip to content
For developers

Your articles, on any site.

Probeli AI writes your articles and publishes them on their dates. A native integration posts them to your platform. Or Probeli AI sends each one to your endpoint, signed. Then you show them on any site you built, in your own design.

  • Nativewe post to your platform
  • Pushwe send to your endpoint
  • No blogwe set one up on your domain

Overview

Each article has a title, a body in HTML and Markdown, a cover image, SEO fields and tags. Once your site is connected, every new article arrives by itself. Nobody on your team writes or pastes anything.

Which way fits your site

  • Native

    Integrations

    WordPress, WordPress.com, Shopify, Webflow and Wix. Probeli AI posts each article as a normal post, at a normal address. There is nothing to build.

  • Push

    Webhook

    Probeli AI sends each article to an https endpoint you own, signed with your secret. Your side never has to ask. The article reaches your database when it publishes.

  • No blog

    Blog set up for you

    No blog yet? We set one up for you on your own domain. Then Probeli AI publishes there like any connected site.

Webhook / push

Get each article at an endpoint you own, instead of asking for it. Add your https address in Settings › Publishing. Probeli AI sends a signed ping first, and saves the webhook once your endpoint accepts it. You get a signing secret to check every request.

POST https://example.com/hooks/probeli
Request headers
Probeli-Signature: t=1760605200,v1=6b1f0c9e2a…
Probeli-Event: article.published
Probeli-Delivery: 5d0c2f7e-3b8a-4f4e-9a51-2c6f0e8d7b13
Probeli-Timestamp: 1760605200
Content-Type: application/json; charset=utf-8

The body is JSON: the event, its time and the article in data.article. Every field is in the webhook reference.

Fields

The fields of one article in the webhook's data.article. The full payload is in the webhook reference.

Field Type Notes
title string Show it as your page's only h1.
slug string Stable for each article. Store your pages by it.
html string (HTML) The body, ready to show. It has no h1.
markdown string The same body in Markdown.
metaTitle, metaDescription string or null For your title tag and meta description.
coverImage object or null The cover's url and alt.
excerpt string or null A short summary for cards and lists.
tags array Your tags for the article.
publishedAt, modifiedAt ISO 8601 Save the article again on article.updated.

Check a delivery

v1 in Probeli-Signature is the hex HMAC-SHA256 of t, a dot and the raw body, keyed with your secret. Compute it over the raw body, before any JSON parser runs (in Express, express.raw()). Compare it in constant time. Refuse a t older than 5 minutes, so an old request can't be sent again.

verify.jsNode.js
import { createHmac, timingSafeEqual } from "node:crypto";

export function isFromProbeli(rawBody, header, secret) {
	const parts = Object.fromEntries(header.split(",").map((part) => part.split("=")));
	const age = Math.abs(Date.now() / 1000 - Number(parts.t));
	if (!parts.t || !parts.v1 || age > 300) return false;
	const expected = createHmac("sha256", secret)
		.update(parts.t + "." + rawBody)
		.digest("hex");
	const given = Buffer.from(parts.v1, "hex");
	const wanted = Buffer.from(expected, "hex");
	return given.length === wanted.length && timingSafeEqual(given, wanted);
}
verify.pyPython
import hashlib, hmac, time

def is_from_probeli(raw_body: bytes, header: str, secret: str) -> bool:
    parts = dict(part.split("=", 1) for part in header.split(","))
    if "t" not in parts or "v1" not in parts or abs(time.time() - int(parts["t"])) > 300:
        return False
    signed = parts["t"].encode() + b"." + raw_body
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts["v1"])
verify.phpPHP
<?php
function is_from_probeli(string $rawBody, string $header, string $secret): bool {
	parse_str(str_replace(',', '&', $header), $parts);
	if (!isset($parts['t'], $parts['v1']) || abs(time() - (int) $parts['t']) > 300) {
		return false;
	}
	$expected = hash_hmac('sha256', $parts['t'] . '.' . $rawBody, $secret);
	return hash_equals($expected, $parts['v1']);
}

Delivery and retries

  • Sent on every publish. article.published the first time an article goes live, article.updated after that.
  • Tried again on failure. A network error, 408, 429 or 5xx gets up to 3 tries in all.
  • Answer with any 2xx. We wait 10 seconds. Store by data.article.id, so a repeat makes one page.
  • Any public https address. It must use port 443, and Probeli AI never follows a redirect.

No blog yet?

Don't want to build anything? We set up a blog for you on your own domain. Then Probeli AI publishes your articles there, like on any other connected site. Talk to us.

Notes

  • Published articles only. The webhook carries articles that are being published. No drafts and no account data.
  • Your articles are yours. Keep them, export them and host them where you like.
  • Your answer sets the address. Return url and id with your 2xx, and Probeli AI links to your page.
  • Questions? Write to us, and we'll help you connect your site.