Publish articles from your CMS, scripts or AI agents. Included with the Pro and Agent plans.
Create a key under API & webhooks and send it with every request:
Authorization: Bearer b2b_xxxxxxxxxxxxxxxx
Base URL: https://b2b.pr1.cn/api/v1. Requests and responses are JSON. Limit: 120 requests per minute per account.
Each plan gives a number of articles per site in a repeating window that starts with your billing period: Basic one per site per month, Pro one per site per week, Agent one per site per day. Rejected articles do not count. When a site has no allowance left the API answers 429.
Your account and current allowance window.
Every site that accepts articles, with its categories and remaining (articles you can still submit there in the current window).
{
"site": "cnc-machining", // slug from GET /sites
"category": "choosing-a-cnc-supplier", // category slug
"title": "How to compare CNC quotes from three suppliers",
"body_markdown": "## Start with the drawing\n…", // 300–5,000 words
"summary": "optional, 1–2 sentences",
"meta_description": "optional, up to 155 characters"
}
Returns 201 with the article (status: "pending_review"). An editor reviews it, usually within a day; you get a webhook when it is published or returned. A cover photo is chosen for you. Outbound links are published with rel="sponsored".
Let our AI write the article from a brief. Returns 202 with the new draft's id; the draft is usually ready in 2–5 minutes.
{
"site": "cnc-machining",
"category": "choosing-a-cnc-supplier",
"company": "Acme Precision",
"product": "5-axis CNC machining of aluminium housings",
"points": "- How to set tolerances for thin walls\n- First-article CMM inspection\n- Prototype vs batch lead times",
"keyword": "aluminium cnc machining", // optional
"title": "", // optional: the AI proposes one
"links": [{"url": "https://acme.example/cnc", "anchor": "Acme 5-axis machining"}], // up to 2
"words": 1200, // 800, 1200 or 1500
"auto_submit": true // send to review as soon as it is written
}
Follow progress with GET /articles/{id} (draft_status: queued, writing, done, failed) or the article.drafted webhook. Without auto_submit the draft waits in your account for you to edit and submit. Your plan includes a daily number of AI drafts; submitting uses the normal allowance.
Your articles, newest first, with status, URL once published, and the editor's reason if returned.
One article.
Set an https endpoint under API & webhooks. We POST:
{
"id": "evt_123_article.published_1730000000",
"type": "article.published", // or article.rejected, article.drafted
"created": 1730000000,
"data": {"id": 123, "status": "published", "title": "…", "site": "cnc-machining",
"category": "choosing-a-cnc-supplier", "url": "https://cnc-machining.b-2b.com/…/",
"published_at": "2026-10-04T06:12:00Z", "reject_reason": ""}
}
Verify the X-B2B-Signature: t=<unix>,v1=<hex> header: compute HMAC-SHA256 of t + "." + raw_body with your signing secret and compare. Answer with any 2xx status; other answers are retried with back-off. The id is stable, so use it to ignore repeats. A published article appears on the site at its next build (normally within the day).
Errors return {"error": "message"} with status 400 (bad JSON), 401 (key), 403 (plan), 404, 422 (validation) or 429 (allowance or rate limit).