Backlink-API

Mit der Backlink-API von Answer the Web bestellst du redaktionelle Backlinks, Marken-Erwähnungen, Listen-Artikel und Forenlinks per REST-Aufruf und bekommst die Live-URL zurück. Abgerechnet wird aus deinem Guthaben, ohne API-Gebühr.

Kostenlos registrieren und Schlüssel erzeugen Als Markdown für KI-Agenten

Mit der Backlink-API bestellen du, deine Agentur-Software oder dein KI-Agent redaktionelle Backlinks, Marken-Erwähnungen, Listen-Artikel und Forenlinks aus dem Answer-the-Web-Portfolio (über 100 deutschsprachige Fachportale). Du schickst Ziel-URL und Ankertext, wir recherchieren, schreiben, bebildern und veröffentlichen, du bekommst die Live-URL zurück: per Abfrage oder per signiertem Webhook.

Abgerechnet wird aus deinem Answer-the-Web-Guthaben. Es gelten dieselben Preise und dasselbe Guthaben wie im Dashboard. Es gibt keine API-Gebühr.

• Basis-URL: https://answertheweb.com/wp-json/atw/v1/backlinks
• Format: JSON (UTF-8), Zeiten in ISO 8601 (UTC)
• Doku als Webseite: https://answertheweb.com/backlink-api/
• Doku als Markdown (für KI-Agenten): GET https://answertheweb.com/wp-json/atw/v1/backlinks/docs

1. Zugang

1. Einloggen auf answertheweb.com, dann Backlinks → API öffnen.
2. Schlüssel erzeugen. Er beginnt mit atwbl_ und wird nur einmal angezeigt. Wir speichern ihn nur als Hash.
3. Bei jedem Aufruf mitschicken, entweder als Authorization: Bearer <schlüssel> oder als Header X-ATW-Key: <schlüssel>.

export ATW_KEY="atwbl_123_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl -H "Authorization: Bearer $ATW_KEY" https://answertheweb.com/wp-json/atw/v1/backlinks/account

Ein neuer Schlüssel macht den alten sofort ungültig. Behandle ihn wie ein Passwort.

2. Guthaben und Preise

Jeder Auftrag verbraucht Guthaben der passenden Art. Die meisten Portale kosten 1 Credit pro Auftrag, der genaue Wert steht je Portal in price_credits (siehe GET /sites).

Guthaben lädst du im Dashboard unter Backlinks → Guthaben auf (Pakete mit Staffelrabatt oder freie Menge, Zahlung per Echtzeit-Überweisung, Karte, Apple Pay, Google Pay oder Revolut). Per API holst du dir mit GET /topup direkt den Link zur Kasse. Individuelle Konditionen für Agenturen und größere Mengen auf Anfrage an start@answertheweb.com. Sonderpreise erscheinen dann automatisch in deinem Konto und in GET /account.

3. Endpunkte

GET /account · Guthaben, Preise, Limits

{
  "user": "du@agentur.de",
  "credits": { "backlink": 25, "brand_mention": 0, "listicle": 10, "forum_link": 0, "forum_mention": 0 },
  "prices_cent": { "backlink": 1500, "brand_mention": 1200, "listicle": 1500, "forum_link": 1000, "forum_mention": 1000 },
  "limits": { "requests_per_minute": 60, "max_orders_per_request": 100, "orders_per_day": 500 },
  "webhook": { "url": "https://dein-server.de/hooks/atw", "active": true },
  "orders": { "total": 42, "done": 37, "open": 5, "failed": 0 }
}

GET /sites · Portfolio durchsuchen

{ "total": 1, "sites": [ { "domain": "beispiel-portal.de", "topics": ["Haus & Garten"], "language": "de", "country": "de", "dr": 18, "traffic": 1200, "forum": false, "price_credits": 1 } ] }

GET /forum-sites · Foren für Forenlinks und Foren-Erwähnungen

Gleiche Struktur wie /sites, nur Foren.

POST /orders · 1 bis 100 Aufträge anlegen

{
  "campaign": "Kunde Müller Q4",
  "orders": [
    { "type": "backlink", "target_url": "https://kunde.de/leistungen/", "anchor": "Gartenpflege in Köln", "topic": "Gartenpflege im Herbst", "publish_date": "2026-10-15" },
    { "type": "brand_mention", "target_url": "https://kunde.de/", "anchor": "Gartenbau Müller" },
    { "type": "listicle", "target_url": "https://kunde.de/", "anchor": "Gartenbau Müller", "topic": "Die besten Gartenbaubetriebe in Köln" },
    { "type": "forum_link", "target_url": "https://kunde.de/ratgeber/rasen/", "anchor": "Rasen vertikutieren", "site": "beispiel-forum.de" },
    { "type": "forum_mention", "target_url": "https://kunde.de/", "anchor": "Gartenbau Müller", "mention_type": "U" }
  ]
}

Antwort 201:

{
  "created": 2,
  "orders": [ { "id": 5012, "batch_id": 4711, "type": "backlink", "site": "beispiel-portal.de", "status": "queued", "...": "..." } ],
  "batches": [4711],
  "errors": [],
  "credits_charged": { "backlink": 2 },
  "credits_left": { "backlink": 23, "brand_mention": 0, "listicle": 10, "forum_link": 0, "forum_mention": 0 }
}

Gut zu wissen:

• Pro Kunden-Domain gibt es auf jedem Portal nur einen Link. Ist ein gewünschtes Portal schon belegt, lass site weg.
• Das Guthaben wird beim Anlegen abgebucht. Kann das Backend einen Auftrag gar nicht anlegen, buchen wir es sofort zurück.
• Nicht angenommen werden Glücksspiel, Erwachseneninhalte, Pharma, riskante Finanzprodukte, CBD und Tabak.
• Wir veröffentlichen aktuell für Websites aus Deutschland, Österreich und der Schweiz.

GET /orders · deine Aufträge

Parameter: status (queued, running, review, done, failed, deleted), batch, campaign, page, per_page (max. 200).

GET /orders/{id} · einzelner Auftrag

{
  "id": 5012, "batch_id": 4711, "type": "backlink", "site": "beispiel-portal.de",
  "target_url": "https://kunde.de/leistungen/", "anchor": "Gartenpflege in Köln", "topic": "Gartenpflege im Herbst",
  "status": "done", "published_url": "https://beispiel-portal.de/garten/gartenpflege-herbst/",
  "article_title": "Gartenpflege im Herbst: Was jetzt zu tun ist", "campaign": "Kunde Müller Q4",
  "created_at": "2026-10-01T09:12:00+00:00", "updated_at": "2026-10-01T13:40:00+00:00"
}

published_url ist dein Ergebnis: der Live-Artikel mit Link oder Erwähnung.

Status: queued (wartet), running (wird geschrieben), review (Prüfung), done (live), failed (nicht möglich, wir melden uns), deleted (storniert).

DELETE /orders/{id} · stornieren

Nur solange der Auftrag queued ist. Das Guthaben geht sofort zurück auf dein Konto. Laufende und veröffentlichte Aufträge lassen sich nicht stornieren (409).

GET /batches/{id} · Fortschritt einer Bestellung

{ "batch_id": 4711, "total": 2, "counts": { "queued": 0, "running": 1, "review": 0, "done": 1, "failed": 0 }, "complete": false, "orders": [ "..." ] }

Abfragen alle 10 bis 15 Minuten reicht. Artikel werden recherchiert, geschrieben, bebildert und dann veröffentlicht, je nach Warteschlange und Wunschdatum dauert das Minuten bis Stunden.

POST /articles · eigenen, fertigen Artikel veröffentlichen

Verbraucht 1 Backlink-Credit.

{
  "site": "beispiel-portal.de",
  "title": "So finden Sie den richtigen Gartenbauer",
  "html": "<p>Ihr fertiger Artikel mit mindestens 200 Zeichen Text …</p>",
  "target_url": "https://kunde.de/",
  "anchor": "Gartenbau Müller",
  "category": "Haus & Garten",
  "meta_title": "Gartenbauer finden: 7 Tipps",
  "meta_description": "Worauf Sie bei der Wahl achten sollten.",
  "generate_image": true
}

Bilder bitte nicht mitschicken: das Beitragsbild erzeugen wir selbst (generate_image, optional image_prompt). Tote Links im Text entfernen wir automatisch.

GET /topup · Guthaben aufladen

Parameter: type (z. B. backlink) und qty (1 bis 1000). Antwort enthält Preis und checkout_url. Den Link öffnest du im Browser, dort wählst du die Zahlungsart. Das Guthaben ist nach Zahlungseingang sofort da.

{ "type": "backlink", "qty": 25, "price_cent": 33700, "discount_percent": 10, "checkout_url": "https://answertheweb.com/dashboard/kasse/?item=cr_backlink_25" }

PUT /webhook · Webhook einrichten

{ "url": "https://dein-server.de/hooks/atw" }

Antwort enthält secret (nur einmal). DELETE /webhook schaltet ihn ab. Du kannst den Webhook auch im Dashboard einrichten.

4. Webhooks

Sobald ein Auftrag done oder failed ist, senden wir:

POST <deine URL>
X-ATW-Event: order.done
X-ATW-Signature: <hex HMAC-SHA256 des rohen Bodys mit deinem Secret>
Content-Type: application/json

{ "event": "order.done", "order": { …wie GET /orders/{id}… } }

Prüfen (Python):

import hmac, hashlib
def echt(raw_body: bytes, signatur: str, secret: str) -> bool:
    mac = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, signatur)

Webhooks werden einmal gesendet. Die Abfrage per GET /orders bleibt die verlässliche Quelle.

5. Fehler und Limits

Fehler kommen immer als { "code": "...", "message": "..." }.

6. Schnellstart für KI-Agenten

Kopiere diesen Block in den Kontext deines Agenten:

1. Header bei jedem Aufruf: Authorization: Bearer <ATW_KEY>.
2. GET https://answertheweb.com/wp-json/atw/v1/backlinks/account prüft Guthaben. Reicht es nicht, GET /topup?type=backlink&qty=10 und den Link an den Menschen geben.
3. Optional GET https://answertheweb.com/wp-json/atw/v1/backlinks/sites?topic=<thema> für passende Portale.
4. POST https://answertheweb.com/wp-json/atw/v1/backlinks/orders mit bis zu 100 Zeilen (target_url, anchor, optional type, site, topic, publish_date).
5. Alle 10 bis 15 Minuten GET /batches/{batch_id} bis complete: true, dann published_url je Auftrag ausgeben.

Python

import requests, time
BASE = "https://answertheweb.com/wp-json/atw/v1/backlinks"
H = {"Authorization": "Bearer " + ATW_KEY}

r = requests.post(BASE + "/orders", headers=H, json={"orders": [
    {"target_url": "https://kunde.de/", "anchor": "Gartenbau Müller", "topic": "Gartenpflege"}
]}).json()
for b in r["batches"]:
    while not (s := requests.get(f"{BASE}/batches/{b}", headers=H).json())["complete"]:
        time.sleep(900)
    for o in s["orders"]:
        print(o["status"], o["published_url"])

7. Kontakt

Fragen, Sonderkonditionen oder höhere Limits: start@answertheweb.com