B2B Network

API reference

Publish articles from your CMS, scripts or AI agents. Included with the Pro and Agent plans.

Authentication

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.

Allowance

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.

Endpoints

GET /me

Your account and current allowance window.

GET /sites

Every site that accepts articles, with its categories and remaining (articles you can still submit there in the current window).

POST /articles

{
  "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".

POST /ghostwrite

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.

GET /articles

Your articles, newest first, with status, URL once published, and the editor's reason if returned.

GET /articles/{id}

One article.

Webhooks

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

Errors return {"error": "message"} with status 400 (bad JSON), 401 (key), 403 (plan), 404, 422 (validation) or 429 (allowance or rate limit).