API documentation. Version 1.

Start a generation, poll for the article, check your word balance and search the casinos, slots and sweepstakes casinos in our database, all from your own systems.

Base URL
https://boostway.ai
Auth
Bearer token
Format
JSON in, JSON out
Rate limit
60 requests / minute

Authentication. Bearer tokens.

Send your key in the Authorization header. Keys are shown once. Store them in a server-side secret manager.

HTTP header
Authorization: Bearer mb2b_your_api_key_here

Manage keys in Settings → API Keys. Revocation is instant.

Heads-up

POST /api/v1/generate is asynchronous. It returns a generation_id; you poll GET /api/v1/generate/{id} every few seconds until status is completed or failed. Every other endpoint is a plain request/response.

Rate limits. 60 requests / minute, per IP.

Throttled per caller IP across all v1 endpoints. When exceeded, expect 429 with a Retry-After header. Going over the limit blocks the IP for an hour, doubling with each repeat within 7 days up to 16 hours.

Limit
60req/min
Window
60sfixed
Exceeded
429Retry-After
Polling
3-5srecommended

Responses. JSON in, JSON out.

2xx returns a JSON body. Errors return { "error": string } with the matching status. Money is USD, timestamps are ISO-8601.

StatusNameMeaning
200OKRequest succeeded.
400Bad RequestInvalid or missing input.
401UnauthorizedMissing, invalid, or revoked key.
402Payment RequiredInsufficient word balance.
403ForbiddenSuspended or email not verified.
404Not FoundResource missing or not yours.
429Too Many RequestsRate limit hit. Honor the Retry-After header.
500Server ErrorRetry with exponential backoff.

Endpoints. Full reference.

Click any row to expand parameters and response payloads.

ParametersJSON body
content_typestringrequired
One of slots, casinos, sweepstakes, news, guides.
slugstringrequired
Entity slug (slots, casinos, sweepstakes) or a stable URL slug for news and guides. Max 500 chars.
languagestring
ISO code from the accepted values. Defaults to en.
tonestring
One of professional, friendly, upbeat, default. Defaults to default, which picks a tone per content type.
content_lengthstring
short or long. Defaults to long. News and guides are always long.
shortboolean
Legacy shorthand for content_length. If true and content_length is not set, short is used.
topicstring
Free-text topic, mostly for news and guides. Max 2000 chars.
source_urlstring
Reference URL for news and guides. Max 2000 chars.
marketstring
Market ISO code (e.g. SE, DE, ROW), case-insensitive, max 8 chars. Must be one of the ISOs returned by GET /api/v1/markets. Omit it for no market. Sweepstakes always use ROW.
Response
200Generation accepted and queued.
{
  "generation_id": "8f3b1c22-a4d1-4e7c-9b3d-0a1f2c3d4e5f",
  "status": "generating",
  "estimated_words": 1500,
  "word_range": { "min": 900, "max": 2200 }
}
400Invalid content_type, language, tone, slug, or market.
{ "error": "Invalid content_type. Must be one of: slots, casinos, sweepstakes, news, guides" }
402Not enough words remaining to cover the minimum estimate.
{
  "error": "Insufficient words remaining",
  "wordsRemaining": 120,
  "required": 900
}

Flow. Async lifecycle.

Generation is async: start it, poll until a terminal status. Failed generations don't consume words. Prefer push? See Webhooks.

  1. 01POST /generate
  2. 02poll every 3-5s
  3. 03GET /generate/{id}
  4. 04completed/failed

Webhooks. Get articles pushed to you.

Instead of polling, add an HTTPS endpoint under Settings → Webhooks. We POST a signed JSON event when a generation completes or fails.

EventWhen it fires
generation.completedThe article is ready. data.content holds the HTML and data.image_url the cover image.
generation.failedThe generation ended without an article. data.status is failed or no_sources, and data.error_message explains why. No words are charged.

Headers

Boostway-Webhook-Id
Event id. The same on every retry, so use it to ignore duplicates.
Boostway-Event
Event type, e.g. generation.completed.
Boostway-Signature
t=<unix seconds>,v1=<hex>. HMAC-SHA256 of <t>.<raw body> with your signing secret.
User-Agent
Boostway-Webhooks/1.0
Example payload
{
  "id": "evt_3f1c9a2e-7b4d-4c1a-9e2f-5d6a7b8c9d0e",
  "type": "generation.completed",
  "created_at": "2026-10-27T15:40:00.000Z",
  "data": {
    "generation_id": "8f3b1c22-a4d1-4e7c-9b3d-0a1f2c3d4e5f",
    "status": "completed",
    "title": "Big Bass Bonanza Review",
    "content_type": "slots",
    "language": "en",
    "market": "uk",
    "content_length": "long",
    "words_used": 1834,
    "content": "<h2>Overview</h2><p>…</p>",
    "image_url": "https://cdn.example.com/cover.jpg",
    "image_alt": "Big Bass Bonanza reels",
    "error_message": null,
    "source": "api_v1",
    "created_at": "2026-10-27T15:36:12.000Z"
  }
}
Verify the signature (Node)
import crypto from 'node:crypto';
import express from 'express';

const app = express();
const SECRET = process.env.BOOSTWAY_WEBHOOK_SECRET;

app.post('/webhooks/boostway', express.raw({ type: 'application/json' }), (req, res) => {
  const header = req.get('Boostway-Signature') ?? '';
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const expected = crypto.createHmac('sha256', SECRET).update(`${parts.t}.${req.body}`).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  const valid = parts.v1?.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected));
  if (!fresh || !valid) return res.sendStatus(400);

  const event = JSON.parse(req.body);
  // Handle event.type, dedupe on event.id, then answer quickly.
  res.sendStatus(200);
});

Retries

Up to 3 attempts: immediately, after 5 s, after 30 s. Respond with a 2xx status within 10 s. Other 4xx responses are not retried, except 408 and 429.

Up to 5 endpoints per workspace, managed by the account owner. Endpoints that fail 20 events in a row are paused; turn them back on in Settings.

Troubleshooting. Common errors.

Most real-world issues land on one of these. Check here before opening a ticket.

401

Missing or invalid Authorization header

Header must be exactly Authorization: Bearer mb2b_.... Note the space after Bearer.

401

Invalid API key

Key is revoked or has whitespace. Create a fresh one in Settings → API Keys.

402

Insufficient words remaining

Upgrade your plan in Billing, or switch to content_length: short.

403

Email not verified

Click the verification link we emailed you (check spam), then retry.

400

Invalid content_type / language / tone / slug / market

The message names the field. Cross-check the Accepted values below.

404

Generation not found

IDs are scoped to the key's account. Reuse the generation_id from POST /generate verbatim.

429

Too Many Requests

Slow down. Sleep 3-5s between polls. Honor the Retry-After header.

500

Transient backend failure

Retry with exponential backoff (1s, 2s, 4s, 8s…). If it persists, contact support.

Reference. Accepted values.

Valid enums for request parameters across v1.

content_type
slotscasinossweepstakesnewsguides
content_length
shortlong
language
endeesfritptnlsvfinodajarothvielplcskoru
tone
professionalfriendlyupbeatdefault
status
generatingcompletedfailed
market
ROWALARAUATBDBOBABRBGKHCACLCOHRCZDKECEGSVFIDEGTHTHNHUIEITJPKZKEKGLAMXNLNZNINGMKNOPAPYPEPLPTRSSKSIESSECHGBUSUYUZVEVN

Every plan includes API access. Plans from €100 a month.