Forum link API

Submit orders for AI-generated forum content across 3000+ owned forums. Three product types: link placements, single comments and full thread plans.

Authentication

Every request must include a valid API key. Keys are issued per reseller and can be revoked at any time.

curl -H "x-api-key: fcc_your_key" \
  https://automated.forum/api/v1/account

Alternatively pass ?api_key=fcc_your_key.

Account

GET/account

Returns your prepaid balance, current wholesale prices and recent ledger entries.

{
  "name": "Acme Links",
  "balance_pence": 25000,
  "prices": { "comment": 50, "link_placement": 150, "thread_plan": 400 },
  "ledger": [ ... ]
}

Inventory

GET/inventory — sites, categories and forums.

GET/inventory/niches — niches with forum and site counts. Use this to populate a storefront dropdown.

GET/inventory/templates — available thread-plan templates.

{
  "niches": [
    { "niche": "casino games", "forum_count": 4, "site_count": 1 },
    { "niche": "sports betting", "forum_count": 7, "site_count": 1 }
  ]
}

Orders

POST/orders

Create one of three order types. The price is charged from your balance immediately and refunded if the order fails or is cancelled.

Common fields

type: link_placement

Places your link naturally into AI-generated forum posts over time.

curl -X POST https://automated.forum/api/v1/orders \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "link_placement",
    "url": "https://example.com/best-casinos",
    "anchor_texts": ["best online casinos", "top casino sites"],
    "niche": "casino",
    "brand_info": "Example.com reviews and ranks online casinos",
    "max_placements": 5,
    "external_id": "shop-order-456"
  }'

Fulfilment runs in the background. Poll GET /orders/:id/status.

type: comment

Posts a single reply to an existing thread. Auto-picks a relevant thread, or target one with thread_id.

curl -X POST https://automated.forum/api/v1/orders \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "comment",
    "niche": "casino",
    "instructions": "Write about the best welcome bonuses for new players in 2026",
    "url": "https://example.com/welcome-bonuses",
    "anchor_texts": ["best welcome bonuses"],
    "external_id": "shop-order-789"
  }'

Processed immediately. Returns status: "processing"; typically completes in 10-30 seconds.

type: thread_plan

Creates a full scripted thread: an original post plus replies from different users with realistic delays.

curl -X POST https://automated.forum/api/v1/orders \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "thread_plan",
    "niche": "casino",
    "topic": "Best crypto withdrawal methods for online casinos in 2026",
    "replies": 4,
    "template": "qa_promotion",
    "instructions": "Natural discussion, one reply recommends fast Bitcoin payouts",
    "url": "https://example.com/crypto-withdrawals",
    "anchor_texts": ["fast crypto withdrawals"],
    "external_id": "shop-order-012"
  }'

Replies are spread 10-60 minutes apart. A 4-reply thread usually completes in 1-3 hours.

Read and cancel

GET/orders — list, filterable by type, status, external_id.

GET/orders/:id — detail plus placement proof.

GET/orders/:id/status — lightweight poll.

DELETE/orders/:id — cancel and refund.

Thread templates

GET/inventory/templates

Storefronts use these as product options. Pass the template key as template on a thread plan.

Status lifecycle

Poll every 30s for comments, every 5 min for thread plans, every hour for link placements.

Errors

Integration guide

1. Call GET /inventory/niches to populate your order form.
2. Customer selects niche and product, then pays.
3. Your backend calls POST /orders.
4. Store id and external_id.
5. Poll GET /orders/:id/status until completed.
6. Fetch GET /orders/:id for proof URLs.

Typical completion: comments 10-30 seconds, thread plans 1-3 hours, link placements 1-7 days.

Webhooks

Set webhook_url on an order. We POST a JSON body when it completes:

{
  "id": 1042,
  "status": "completed",
  "placements": [
    { "thread_url": "https://...", "anchor_text": "best casino guide", "site": "..." }
  ]
}

Respond with any 2xx. Non-2xx responses are retried.

Billing

Balance is prepaid and charged per order. Cancelled and failed orders refund automatically. Top-ups are arranged with your account manager.