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.
Authorization: Bearer mb2b_your_api_key_hereManage keys in Settings → API Keys. Revocation is instant.
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.
| Status | Name | Meaning |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid or missing input. |
| 401 | Unauthorized | Missing, invalid, or revoked key. |
| 402 | Payment Required | Insufficient word balance. |
| 403 | Forbidden | Suspended or email not verified. |
| 404 | Not Found | Resource missing or not yours. |
| 429 | Too Many Requests | Rate limit hit. Honor the Retry-After header. |
| 500 | Server Error | Retry with exponential backoff. |
Endpoints. Full reference.
Click any row to expand parameters and response payloads.
- 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 todefault, which picks a tone per content type. - content_lengthstring
shortorlong. Defaults tolong. News and guides are always long.- shortboolean
- Legacy shorthand for
content_length. If true andcontent_lengthis not set,shortis 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 byGET /api/v1/markets. Omit it for no market. Sweepstakes always useROW.
{
"generation_id": "8f3b1c22-a4d1-4e7c-9b3d-0a1f2c3d4e5f",
"status": "generating",
"estimated_words": 1500,
"word_range": { "min": 900, "max": 2200 }
}{ "error": "Invalid content_type. Must be one of: slots, casinos, sweepstakes, news, guides" }{
"error": "Insufficient words remaining",
"wordsRemaining": 120,
"required": 900
}- idstringrequired
- The
generation_idreturned byPOST /generate. Path parameter.
{
"generation_id": "8f3b1c22-a4d1-4e7c-9b3d-0a1f2c3d4e5f",
"status": "generating"
}{
"generation_id": "8f3b1c22-a4d1-4e7c-9b3d-0a1f2c3d4e5f",
"status": "failed",
"error": "Upstream provider timeout"
}{
"generation_id": "8f3b1c22-a4d1-4e7c-9b3d-0a1f2c3d4e5f",
"status": "completed",
"title": "Book of Dead Slot Review",
"content": "<h2>Overview</h2><p>...</p>",
"image_url": "https://cdn.marvn.io/images/book-of-dead.webp",
"image_alt": "Book of Dead slot cover art",
"words_used": 1480,
"cost_usd": 0.12,
"language": "en",
"credits_used": 1,
"credit_breakdown": { "content": 1, "image": 0 },
"content_type": "slots",
"tone": "upbeat",
"slug": "book-of-dead"
}{ "error": "Generation not found" }- contentTypestring
- Filter by
slots,casinos,sweepstakes,news,guides. - statusstring
- Filter by
generating,completed,failed. - languagestring
- Filter by ISO language code.
- contentLengthstring
- Filter by
shortorlong. - entitySlugstring
- Filter by exact slug.
- pageinteger
- Page number, 1-indexed. Default 1.
- limitinteger
- Items per page. Default 100, max 200.
{
"generations": [
{
"generation_id": "8f3b1c22-a4d1-4e7c-9b3d-0a1f2c3d4e5f",
"content_type": "slots",
"slug": "book-of-dead",
"tone": "upbeat",
"title": "Book of Dead Slot Review",
"credits_used": 1,
"words_used": 1480,
"content_length": "long",
"status": "completed",
"error": null,
"language": "en",
"created_at": "2026-04-24T10:12:30.000Z"
}
],
"pagination": { "page": 1, "limit": 100, "total": 1, "totalPages": 1 },
"stats": { "totalWords": 1480, "generating": 0, "completed": 1, "failed": 0 }
}- idstringrequired
generation_id(UUID v4). An id owned by another account returns 404, not 403, so existence is never leaked. Path parameter.
{ "deleted": true }{ "error": "Not found" }No parameters. Authenticate and call it.
{
"plan": "Growth",
"wordsUsed": 52300,
"wordsLimit": 120000,
"wordsRemaining": 67700,
"periodStart": "2026-04-01T00:00:00.000Z",
"periodEnd": "2026-05-01T00:00:00.000Z",
"wordEstimates": {
"slots": { "short": { "min": 400, "avg": 650, "max": 900 }, "long": { "min": 900, "avg": 1500, "max": 2200 } },
"casinos": { "short": { "min": 400, "avg": 650, "max": 900 }, "long": { "min": 900, "avg": 1500, "max": 2200 } },
"news": { "short": { "min": 300, "avg": 500, "max": 800 }, "long": { "min": 800, "avg": 1300, "max": 2000 } },
"guides": { "short": { "min": 400, "avg": 700, "max": 1000 }, "long": { "min": 900, "avg": 1800, "max": 2600 } }
},
"transactions": [
{ "id": "tx_1", "type": "debit", "words": 1480, "createdAt": "2026-04-24T10:13:05.000Z" }
],
"total": 1
}No parameters. Authenticate and call it.
balance is everything spendable now: plan_words (reset each month, no rollover) plus topup_words (valid 12 months, usable while a plan is active).{ "balance": 67700, "plan_words": 57700, "topup_words": 10000, "plan": "Growth" }- searchstring
- Case-insensitive name match.
- sortstring
- Sort key (e.g.
newest,name). Matches the sort options in the Generate screen. - limitinteger
- Optional hard cap on the number of results (0 = no cap).
[
{
"id": 1234,
"name": "Book of Dead",
"slug": "book-of-dead",
"articleLanguages": [
"en",
"de"
],
"articleCounts": {
"en": 2,
"de": 1
},
"hasArticle": true
}
]- searchstring
- Case-insensitive name match.
- sortstring
- Sort key (e.g.
newest,name). - limitinteger
- Optional hard cap on the number of results (0 = no cap).
[
{
"id": 987,
"name": "Example Casino",
"slug": "example-casino",
"articleLanguages": [
"en"
],
"articleCounts": {
"en": 1
},
"hasArticle": true
}
]- searchstring
- Case-insensitive name match.
- sortstring
- Sort key (e.g.
newest,name_asc,total_slots_desc). - limitinteger
- Optional hard cap on the number of results (0 = no cap).
[
{
"id": 555,
"name": "Example Sweeps",
"slug": "example-sweeps",
"articleLanguages": [
"en"
],
"articleCounts": {
"en": 1
},
"hasArticle": true
}
]No parameters. Authenticate and call it.
ROW (Rest of the World) is always first, the rest are alphabetical by name.{
"markets": [
{ "id": 1, "iso": "ROW", "name": "Rest of the World", "flag": "🌍" },
{ "id": 2, "iso": "DE", "name": "Germany", "flag": "🇩🇪" },
{ "id": 3, "iso": "SE", "name": "Sweden", "flag": "🇸🇪" },
{ "id": 4, "iso": "UK", "name": "United Kingdom", "flag": "🇬🇧" }
]
}Flow. Async lifecycle.
Generation is async: start it, poll until a terminal status. Failed generations don't consume words. Prefer push? See Webhooks.
- 01POST /generate
- 02poll every 3-5s
- 03GET /generate/{id}
- 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.
| Event | When it fires |
|---|---|
| generation.completed | The article is ready. data.content holds the HTML and data.image_url the cover image. |
| generation.failed | The 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
{
"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"
}
}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.
Missing or invalid Authorization header
Header must be exactly Authorization: Bearer mb2b_.... Note the space after Bearer.
Invalid API key
Key is revoked or has whitespace. Create a fresh one in Settings → API Keys.
Insufficient words remaining
Upgrade your plan in Billing, or switch to content_length: short.
Email not verified
Click the verification link we emailed you (check spam), then retry.
Invalid content_type / language / tone / slug / market
The message names the field. Cross-check the Accepted values below.
Generation not found
IDs are scoped to the key's account. Reuse the generation_id from POST /generate verbatim.
Too Many Requests
Slow down. Sleep 3-5s between polls. Honor the Retry-After header.
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