Foretell API

Build predictive simulation into your product.

The same engine behind the web console, over a simple JSON API. Submit a scenario, get a signed webhook, pull the full report. No sales call.

For developers

One wallet, no API pricing tier

API keys draw from the same prepaid credit wallet as the web app — 1 credit = 1 simulation = $199. Buy credits once, spend them from either surface. No subscription, no separate API plan to learn.

The full report, not a subset

The API returns the same structured report the web console shows: the risk verdict, five failure modes, per-cohort stance and synthetic quotes, sentiment trajectory, and the TimesFM quantitative forecast when you attach a numeric series. Only internal debug fields are stripped.

Signed webhooks, not polling

Register an HTTPS endpoint and Foretell delivers a webhook on scenario.completed / scenario.failed, signed with HMAC-SHA256 (Foretell-Signature: t=…,v1=…). Verify the signature, then pull the report — no polling loop.

Integrate in three calls

POST a scenario, receive the webhook, GET the JSON report. Bearer token or X-API-Key. 120 requests/min per key. Keys are issued free and instantly from your dashboard — no UI dependency in your integration.

For companies

Reaction-test before you publish

Wire Foretell into a comms or PR review pipeline so every major announcement is simulated automatically before it ships — instead of hoping someone remembers to check. (Our public sample report is a fictional illustration of exactly the kind of backlash this catches in advance.)

Embed it in your own product

Comms tools, PR agencies, policy and strategy consultancies, product-management platforms — embed Foretell's simulation as a feature inside your own product, so your customers never need to visit foretell.technology themselves.

Self-serve, no sales process

The same instant access as the web app: create an account, buy credits, issue a key, start calling. No contract negotiation, no procurement cycle to begin integrating.

How it works

Submit. POST your scenario documents (and an optional numeric series) to /v1/scenarios with your API key.
Get notified. Foretell runs the full 1,000-agent × 4-round simulation; on completion it fires your signed webhook.
Pull the report. GET the full JSON report — verdict, cohorts, quotes, failure modes, and the quantitative forecast.

Linked Reports & the Decision Tiebreaker, in the API

Deciding between real options? Link two or more completed simulations into one cross-analysis — $25 per linked report, any number of scenarios — ranked with a recommended winner, or as a deliberately neutral side-by-side comparison. Too close to call? The Decision Tiebreaker ($75 flat) re-runs every option independently and returns one decisive answer.

GET /v1/links/linkable — scenarios eligible for linking
POST /v1/links — create a linked report (ranked or comparison mode)
GET /v1/links — list your linked reports
GET /v1/links/{link_id} — status of one linked report
GET /v1/links/{link_id}/report — the full cross-analysis JSON
POST /v1/links/{link_id}/tiebreaker — run the Decision Tiebreaker

Full request/response schemas in the API reference · See a live sample report →

Start building.

Create an account → Read the API reference

← Back to foretell.technology

Foretell API

שלבו סימולציית חיזוי במוצר שלכם.

אותו מנוע שמאחורי קונסולת הווב, דרך API פשוט של JSON. שלחו תרחיש, קבלו webhook חתום, משכו את הדוח המלא. בלי שיחת מכירה.

למפתחים

ארנק אחד, בלי מסלול API

מפתחות ה-API מושכים מאותו ארנק קרדיטים משולם-מראש של אפליקציית הווב — קרדיט אחד = סימולציה אחת = $199. קונים קרדיטים פעם אחת, מוציאים משני המשטחים. בלי מנוי, בלי מסלול API נפרד ללמוד.

הדוח המלא, לא תת-קבוצה

ה-API מחזיר את אותו דוח מובנה שהקונסולה מציגה: פסק הסיכון, חמישה מצבי כשל, עמדה וציטוטים סינתטיים לכל פלח, מסלול סנטימנט, ותחזית TimesFM הכמותית כשמצרפים סדרה מספרית. רק שדות דיבאג פנימיים מוסרים.

Webhookים חתומים, בלי polling

רושמים נקודת קצה HTTPS ו-Foretell שולחת webhook ב-scenario.completed / scenario.failed, חתום ב-HMAC-SHA256 (Foretell-Signature: t=…,v1=…). מאמתים את החתימה ואז מושכים את הדוח — בלי לולאת polling.

אינטגרציה בשלוש קריאות

שולחים תרחיש ב-POST, מקבלים webhook, מושכים את דוח ה-JSON ב-GET. Bearer או X-API-Key. 120 בקשות/דקה למפתח. המפתחות מונפקים חינם ומיידית מלוח הבקרה — בלי תלות בממשק באינטגרציה שלכם.

לחברות

בדקו תגובה לפני הפרסום

חברו את Foretell ל-pipeline של תקשורת או יחסי ציבור כך שכל הכרזה משמעותית תעבור סימולציה אוטומטית לפני שהיא יוצאת — במקום לקוות שמישהו יזכור לבדוק. (דוח הדוגמה הציבורי שלנו הוא המחשה בדיונית בדיוק לסוג הסערה שזה תופס מראש.)

הטמיעו במוצר שלכם

כלי תקשורת, סוכנויות יח״צ, יועצי מדיניות ואסטרטגיה, פלטפורמות ניהול מוצר — הטמיעו את הסימולציה של Foretell כפיצ׳ר בתוך המוצר שלכם, כך שהלקוחות שלכם לעולם לא צריכים להיכנס ל-foretell.technology בעצמם.

שירות עצמי, בלי תהליך מכירה

אותה גישה מיידית כמו אפליקציית הווב: פותחים חשבון, קונים קרדיטים, מנפיקים מפתח, מתחילים לקרוא. בלי משא ומתן על חוזה, בלי מחזור רכש כדי להתחיל.

איך זה עובד

שולחים. שולחים ב-POST את מסמכי התרחיש (וסדרה מספרית אופציונלית) ל-/v1/scenarios עם מפתח ה-API.
מקבלים התראה. Foretell מריצה את הסימולציה המלאה של 1,000 סוכנים × 4 סבבים; בסיום היא מפעילה את ה-webhook החתום שלכם.
מושכים את הדוח. מושכים ב-GET את דוח ה-JSON המלא — פסק דין, פלחים, ציטוטים, מצבי כשל, והתחזית הכמותית.

דוחות מקושרים ושובר־השוויון — גם ב־API

מתלבטים בין אפשרויות אמיתיות? קשרו שתי סימולציות שהושלמו או יותר לניתוח־צולב אחד — ‏$25 לדוח מקושר, לכל מספר תרחישים — כדירוג עם מנצחת מומלצת, או כהשוואה ניטרלית במתכוון. צמוד מדי? שובר־השוויון (‏$75 קבוע) מריץ מחדש כל אפשרות באופן בלתי־תלוי ומחזיר תשובה מכרעת אחת.

GET /v1/links/linkable — אילו תרחישים זמינים לקישור
POST /v1/links — יצירת דוח מקושר (מצב דירוג או השוואה)
GET /v1/links — רשימת הדוחות המקושרים שלכם
GET /v1/links/{link_id} — סטטוס של דוח מקושר
GET /v1/links/{link_id}/report — ה־JSON המלא של הניתוח הצולב
POST /v1/links/{link_id}/tiebreaker — הרצת שובר־השוויון

הסכמות המלאות בתיעוד ה־API · צפו בדוח דוגמה חי ←

התחילו לבנות.

פתחו חשבון ← לתיעוד ה-API

← חזרה ל-foretell.technology

API de Foretell

Integra simulación predictiva en tu producto.

El mismo motor de la consola web, con una API JSON simple. Envía un escenario, recibe un webhook firmado, obtén el informe completo. Sin llamadas de ventas.

Para desarrolladores

Una cartera, sin plan de API

Las claves usan la misma cartera de créditos prepago que la app web — 1 crédito = 1 simulación = 199 $. Compra una vez, gasta desde ambas superficies. Sin suscripción ni plan de API aparte.

El informe completo, no un subconjunto

La API devuelve el mismo informe estructurado que muestra la consola: veredicto de riesgo, cinco modos de fallo, postura y citas por cohorte, trayectoria de sentimiento y la previsión cuantitativa TimesFM. Solo se omiten campos internos de depuración.

Webhooks firmados, sin sondeo

Registra un endpoint HTTPS y Foretell entrega un webhook en scenario.completed / scenario.failed, firmado con HMAC-SHA256 (Foretell-Signature: t=…,v1=…). Verifica la firma y obtén el informe.

Integra en tres llamadas

Envía un escenario, recibe el webhook, obtén el informe JSON. Bearer o X-API-Key. 120 solicitudes/min por clave. Claves gratis e instantáneas desde tu panel.

Para empresas

Prueba la reacción antes de publicar

Conecta Foretell a un flujo de revisión de comunicación o RR. PP. para que cada anuncio importante se simule automáticamente antes de salir. (Nuestro informe de muestra público es una ilustración ficticia del tipo de reacción que esto detecta con antelación.)

Intégralo en tu propio producto

Herramientas de comunicación, agencias de RR. PP., consultoras de estrategia, plataformas de gestión de producto — integra la simulación de Foretell como función dentro de tu producto, sin que tus clientes visiten foretell.technology.

Autoservicio, sin proceso de ventas

El mismo acceso instantáneo que la app web: crea una cuenta, compra créditos, emite una clave y empieza. Sin negociación de contratos.

Cómo funciona

Envía. Envía por POST los documentos del escenario (y una serie numérica opcional) a /v1/scenarios con tu clave.
Recibe aviso. Foretell ejecuta la simulación completa de 1.000 agentes × 4 rondas; al terminar dispara tu webhook firmado.
Obtén el informe. Obtén por GET el informe JSON completo — veredicto, cohortes, citas, modos de fallo y la previsión cuantitativa.

Linked Reports y el Decision Tiebreaker, en la API

¿Está decidiendo entre opciones reales? Vincule dos o más simulaciones completadas en un solo análisis cruzado — $25 por informe vinculado, cualquier número de escenarios — clasificado con una ganadora recomendada, o como una comparación deliberadamente neutral. ¿Demasiado reñido? El Decision Tiebreaker ($75 fijo) vuelve a ejecutar cada opción de forma independiente y devuelve una única respuesta decisiva.

GET /v1/links/linkable — escenarios que pueden vincularse
POST /v1/links — crear un informe vinculado (modo clasificado o comparación)
GET /v1/links — listar sus informes vinculados
GET /v1/links/{link_id} — estado de un informe vinculado
GET /v1/links/{link_id}/report — el JSON completo del análisis cruzado
POST /v1/links/{link_id}/tiebreaker — ejecutar el Decision Tiebreaker

Esquemas completos de solicitud/respuesta en la referencia de la API · Vea un informe de muestra en vivo →

Empieza a construir.

Crear una cuenta → Ver la referencia de la API

← Volver a foretell.technology

API Foretell

Intégrez la simulation prédictive à votre produit.

Le moteur de la console web, via une API JSON simple. Soumettez un scénario, recevez un webhook signé, récupérez le rapport complet. Sans appel commercial.

Pour les développeurs

Un seul portefeuille, aucun palier API

Les clés puisent dans le même portefeuille de crédits prépayés que l'app web — 1 crédit = 1 simulation = 199 $. Achetez une fois, dépensez depuis les deux surfaces. Ni abonnement ni offre API distincte.

Le rapport complet, pas un extrait

L'API renvoie le même rapport structuré que la console : verdict de risque, cinq modes d'échec, posture et citations par cohorte, trajectoire de sentiment et la prévision quantitative TimesFM. Seuls les champs de débogage internes sont retirés.

Webhooks signés, pas de polling

Enregistrez un endpoint HTTPS et Foretell envoie un webhook sur scenario.completed / scenario.failed, signé en HMAC-SHA256 (Foretell-Signature : t=…,v1=…). Vérifiez la signature puis récupérez le rapport.

Intégration en trois appels

Soumettez un scénario, recevez le webhook, récupérez le rapport JSON. Bearer ou X-API-Key. 120 requêtes/min par clé. Clés gratuites et instantanées depuis votre tableau de bord.

Pour les entreprises

Testez la réaction avant de publier

Reliez Foretell à un pipeline de revue comms/RP pour que chaque annonce majeure soit simulée automatiquement avant diffusion. (Notre rapport d'exemple public illustre, de façon fictive, le type de réaction ainsi anticipé.)

Intégrez-le à votre propre produit

Outils de communication, agences RP, cabinets de conseil, plateformes de gestion produit — intégrez la simulation Foretell comme fonctionnalité de votre produit, sans que vos clients visitent foretell.technology.

Self-service, sans processus commercial

Le même accès instantané que l'app web : créez un compte, achetez des crédits, émettez une clé, commencez. Aucune négociation de contrat.

Comment ça marche

Soumettez. Envoyez en POST vos documents de scénario (et une série numérique facultative) à /v1/scenarios avec votre clé.
Soyez notifié. Foretell exécute la simulation complète 1 000 agents × 4 tours ; à la fin, elle déclenche votre webhook signé.
Récupérez le rapport. Récupérez en GET le rapport JSON complet — verdict, cohortes, citations, modes d'échec et prévision quantitative.

Linked Reports et le Decision Tiebreaker, dans l'API

Vous hésitez entre des options réelles ? Reliez deux simulations terminées ou plus en une seule analyse croisée — 25 $ par rapport lié, quel que soit le nombre de scénarios — classée avec une gagnante recommandée, ou en comparaison délibérément neutre. Trop serré ? Le Decision Tiebreaker (75 $ forfaitaire) relance chaque option indépendamment et renvoie une seule réponse décisive.

GET /v1/links/linkable — scénarios éligibles à la liaison
POST /v1/links — créer un rapport lié (mode classé ou comparaison)
GET /v1/links — lister vos rapports liés
GET /v1/links/{link_id} — statut d'un rapport lié
GET /v1/links/{link_id}/report — le JSON complet de l'analyse croisée
POST /v1/links/{link_id}/tiebreaker — lancer le Decision Tiebreaker

Schémas complets dans la référence de l'API · Voir un rapport d'exemple en direct →

Commencez à construire.

Créer un compte → Lire la référence de l'API

← Retour à foretell.technology

Foretell-API

Prädiktive Simulation in Ihr Produkt integrieren.

Dieselbe Engine wie die Web-Konsole, über eine einfache JSON-API. Szenario senden, signierten Webhook empfangen, vollständigen Bericht abrufen. Ohne Vertriebsgespräch.

Für Entwickler

Ein Guthaben, keine API-Stufe

API-Schlüssel nutzen dasselbe Prepaid-Guthaben wie die Web-App — 1 Credit = 1 Simulation = 199 $. Einmal kaufen, von beiden Oberflächen nutzen. Kein Abo, kein separater API-Tarif.

Der vollständige Bericht, kein Auszug

Die API liefert denselben strukturierten Bericht wie die Konsole: Risikourteil, fünf Fehlermodi, Haltung und synthetische Zitate je Kohorte, Stimmungsverlauf und die quantitative TimesFM-Prognose. Nur interne Debug-Felder werden entfernt.

Signierte Webhooks statt Polling

Registrieren Sie einen HTTPS-Endpunkt; Foretell sendet einen Webhook bei scenario.completed / scenario.failed, signiert mit HMAC-SHA256 (Foretell-Signature: t=…,v1=…). Signatur prüfen, Bericht abrufen.

Integration in drei Aufrufen

Szenario per POST senden, Webhook empfangen, JSON-Bericht per GET abrufen. Bearer oder X-API-Key. 120 Anfragen/Min pro Schlüssel. Schlüssel kostenlos und sofort aus dem Dashboard.

Für Unternehmen

Reaktion vor der Veröffentlichung testen

Binden Sie Foretell in eine Comms-/PR-Review-Pipeline ein, sodass jede große Ankündigung vor dem Versand automatisch simuliert wird. (Unser öffentlicher Beispielbericht ist eine fiktive Illustration genau dieser vorab erkannten Reaktion.)

In Ihr eigenes Produkt einbetten

Comms-Tools, PR-Agenturen, Strategieberatungen, Produktmanagement-Plattformen — betten Sie Foretells Simulation als Funktion in Ihr Produkt ein, ohne dass Ihre Kunden foretell.technology besuchen.

Self-Service, kein Vertriebsprozess

Derselbe sofortige Zugang wie die Web-App: Konto erstellen, Credits kaufen, Schlüssel ausstellen, loslegen. Keine Vertragsverhandlung.

So funktioniert es

Senden. Senden Sie Ihre Szenariodokumente (und optional eine numerische Reihe) per POST an /v1/scenarios mit Ihrem Schlüssel.
Benachrichtigt werden. Foretell führt die vollständige Simulation mit 1.000 Agenten × 4 Runden aus; am Ende löst es Ihren signierten Webhook aus.
Bericht abrufen. Rufen Sie per GET den vollständigen JSON-Bericht ab — Urteil, Kohorten, Zitate, Fehlermodi und die quantitative Prognose.

Linked Reports & der Decision Tiebreaker, in der API

Sie entscheiden zwischen realen Optionen? Verknüpfen Sie zwei oder mehr abgeschlossene Simulationen zu einer Kreuzanalyse — 25 $ pro verknüpftem Bericht, beliebig viele Szenarien — als Ranking mit empfohlener Siegerin oder als bewusst neutraler Direktvergleich. Zu knapp? Der Decision Tiebreaker (75 $ pauschal) führt jede Option unabhängig erneut aus und liefert eine einzige, entscheidende Antwort.

GET /v1/links/linkable — verknüpfbare Szenarien
POST /v1/links — einen verknüpften Bericht erstellen (Ranking- oder Vergleichsmodus)
GET /v1/links — Ihre verknüpften Berichte auflisten
GET /v1/links/{link_id} — Status eines verknüpften Berichts
GET /v1/links/{link_id}/report — das vollständige Kreuzanalyse-JSON
POST /v1/links/{link_id}/tiebreaker — den Decision Tiebreaker ausführen

Vollständige Schemata in der API-Referenz · Live-Beispielbericht ansehen →

Fangen Sie an zu bauen.

Konto erstellen → API-Referenz lesen

← Zurück zu foretell.technology

واجهة Foretell البرمجية

ادمج المحاكاة التنبؤية في منتجك.

نفس المحرك خلف وحدة التحكم على الويب، عبر واجهة JSON بسيطة. أرسل سيناريو، استقبل webhook موقّعاً، اسحب التقرير الكامل. دون مكالمة مبيعات.

للمطورين

محفظة واحدة، دون فئة أسعار للـAPI

مفاتيح الـAPI تسحب من نفس محفظة الرصيد المدفوع مسبقاً في تطبيق الويب — رصيد واحد = محاكاة واحدة = 199$. اشترِ مرة واحدة وأنفق من كلا الواجهتين. دون اشتراك أو خطة API منفصلة.

التقرير الكامل، لا جزء منه

تُعيد الـAPI نفس التقرير المنظم الذي تعرضه الوحدة: حكم المخاطر، خمسة أنماط فشل، موقف واقتباسات لكل فئة، مسار المشاعر، والتوقع الكمي من TimesFM. تُحذف فقط حقول التصحيح الداخلية.

Webhooks موقّعة، دون استطلاع

سجّل نقطة نهاية HTTPS وترسل Foretell webhook عند scenario.completed / scenario.failed، موقّعاً بـHMAC-SHA256 (Foretell-Signature: t=…,v1=…). تحقق من التوقيع ثم اسحب التقرير.

تكامل في ثلاثة نداءات

أرسل سيناريو، استقبل webhook، اسحب تقرير JSON. Bearer أو X-API-Key. 120 طلباً/دقيقة لكل مفتاح. المفاتيح مجانية وفورية من لوحتك.

للشركات

اختبر رد الفعل قبل النشر

اربط Foretell بمسار مراجعة الاتصالات/العلاقات العامة بحيث يُحاكى كل إعلان مهم تلقائياً قبل صدوره. (تقريرنا النموذجي العام توضيح خيالي لنوع رد الفعل الذي يلتقطه هذا مسبقاً.)

ادمجها في منتجك الخاص

أدوات الاتصالات، وكالات العلاقات العامة، استشارات الاستراتيجية، منصات إدارة المنتجات — ادمج محاكاة Foretell كميزة داخل منتجك، دون أن يزور عملاؤك foretell.technology.

خدمة ذاتية، دون عملية مبيعات

نفس الوصول الفوري لتطبيق الويب: أنشئ حساباً، اشترِ رصيداً، أصدر مفتاحاً، ابدأ. دون تفاوض على عقد.

كيف تعمل

أرسل. أرسل مستندات السيناريو (وسلسلة رقمية اختيارية) عبر POST إلى /v1/scenarios بمفتاحك.
استقبل إشعاراً. تشغّل Foretell المحاكاة الكاملة بـ1000 وكيل × 4 جولات؛ وعند الانتهاء تطلق webhook الموقّع.
اسحب التقرير. اسحب عبر GET تقرير JSON الكامل — الحكم، الفئات، الاقتباسات، أنماط الفشل، والتوقع الكمي.

التقارير المترابطة وحاسم القرار، في واجهة API

تفاضلون بين خيارات حقيقية؟ اربطوا محاكاتين مكتملتين أو أكثر في تحليل متقاطع واحد — ‏$25 لكل تقرير مترابط، لأي عدد من السيناريوهات — مرتّبًا مع فائز موصى به، أو كمقارنة محايدة عمدًا. النتيجة متقاربة جدًا؟ حاسم القرار (‏$75 ثابتة) يعيد تشغيل كل خيار على حدة ويعيد إجابة حاسمة واحدة.

GET /v1/links/linkable — السيناريوهات المؤهّلة للربط
POST /v1/links — إنشاء تقرير مترابط (وضع الترتيب أو المقارنة)
GET /v1/links — عرض تقاريركم المترابطة
GET /v1/links/{link_id} — حالة تقرير مترابط واحد
GET /v1/links/{link_id}/report — ملف JSON الكامل للتحليل المتقاطع
POST /v1/links/{link_id}/tiebreaker — تشغيل حاسم القرار

المخططات الكاملة في مرجع الـ API · شاهد تقريرًا نموذجيًا مباشرًا ←

ابدأ البناء.

أنشئ حساباً ← اقرأ مرجع الـAPI

← العودة إلى foretell.technology

API Foretell

Integre simulação preditiva no seu produto.

O mesmo motor da consola web, via uma API JSON simples. Envie um cenário, receba um webhook assinado, obtenha o relatório completo. Sem chamada de vendas.

Para programadores

Uma carteira, sem plano de API

As chaves usam a mesma carteira de créditos pré-pagos da app web — 1 crédito = 1 simulação = 199 $. Compre uma vez, gaste de ambas as superfícies. Sem subscrição nem plano de API à parte.

O relatório completo, não um subconjunto

A API devolve o mesmo relatório estruturado que a consola mostra: veredicto de risco, cinco modos de falha, postura e citações por coorte, trajetória de sentimento e a previsão quantitativa TimesFM. Só se removem campos internos de depuração.

Webhooks assinados, sem polling

Registe um endpoint HTTPS e a Foretell entrega um webhook em scenario.completed / scenario.failed, assinado com HMAC-SHA256 (Foretell-Signature: t=…,v1=…). Verifique a assinatura e obtenha o relatório.

Integre em três chamadas

Envie um cenário, receba o webhook, obtenha o relatório JSON. Bearer ou X-API-Key. 120 pedidos/min por chave. Chaves grátis e instantâneas no seu painel.

Para empresas

Teste a reação antes de publicar

Ligue a Foretell a um pipeline de revisão de comunicação/RP para que cada anúncio importante seja simulado automaticamente antes de sair. (O nosso relatório de amostra público é uma ilustração fictícia do tipo de reação que isto antecipa.)

Incorpore-a no seu próprio produto

Ferramentas de comunicação, agências de RP, consultoras de estratégia, plataformas de gestão de produto — incorpore a simulação da Foretell como funcionalidade no seu produto, sem os seus clientes visitarem foretell.technology.

Self-service, sem processo de vendas

O mesmo acesso instantâneo da app web: crie uma conta, compre créditos, emita uma chave e comece. Sem negociação de contrato.

Como funciona

Envie. Envie por POST os documentos do cenário (e uma série numérica opcional) para /v1/scenarios com a sua chave.
Seja notificado. A Foretell executa a simulação completa de 1.000 agentes × 4 rondas; ao concluir, dispara o seu webhook assinado.
Obtenha o relatório. Obtenha por GET o relatório JSON completo — veredicto, coortes, citações, modos de falha e a previsão quantitativa.

Linked Reports e o Decision Tiebreaker, na API

Decidindo entre opções reais? Vincule duas ou mais simulações concluídas em uma única análise cruzada — US$ 25 por relatório vinculado, qualquer número de cenários — classificada com uma vencedora recomendada, ou como comparação deliberadamente neutra. Empate técnico? O Decision Tiebreaker (US$ 75 fixo) executa novamente cada opção de forma independente e retorna uma única resposta decisiva.

GET /v1/links/linkable — cenários elegíveis para vinculação
POST /v1/links — criar um relatório vinculado (modo classificado ou comparação)
GET /v1/links — listar seus relatórios vinculados
GET /v1/links/{link_id} — status de um relatório vinculado
GET /v1/links/{link_id}/report — o JSON completo da análise cruzada
POST /v1/links/{link_id}/tiebreaker — executar o Decision Tiebreaker

Esquemas completos na referência da API · Veja um relatório de exemplo ao vivo →

Comece a construir.

Criar uma conta → Ler a referência da API

← Voltar a foretell.technology

Foretell API

将预测式模拟集成到你的产品。

与网页控制台相同的引擎，通过简单的 JSON API。提交场景，接收签名 webhook，拉取完整报告。无需销售通话。

面向开发者

同一钱包，没有 API 套餐

API 密钥与网页应用共用同一个预付点数钱包——1 点数 = 1 次模拟 = 199 美元。购买一次，两端通用。无订阅，无单独的 API 套餐。

完整报告，而非子集

API 返回与控制台相同的结构化报告：风险结论、五种失败模式、各群体立场与合成引述、情绪走势，以及附加数值序列时的 TimesFM 定量预测。仅去除内部调试字段。

签名 webhook，无需轮询

注册一个 HTTPS 端点，Foretell 会在 scenario.completed / scenario.failed 时发送 webhook，用 HMAC-SHA256 签名（Foretell-Signature: t=…,v1=…）。验证签名后拉取报告。

三次调用即可集成

POST 提交场景，接收 webhook，GET 拉取 JSON 报告。Bearer 或 X-API-Key。每个密钥 120 请求/分钟。密钥在面板中免费即时生成。

面向企业

发布前测试反应

将 Foretell 接入公关/传播审查流程，让每项重大公告在发布前自动模拟——而不是指望有人记得检查。（我们的公开示例报告正是这类可提前发现之反弹的虚构示例。）

嵌入你自己的产品

传播工具、公关公司、策略咨询、产品管理平台——将 Foretell 的模拟作为功能嵌入你的产品，你的客户无需访问 foretell.technology。

自助服务，无销售流程

与网页应用相同的即时接入：注册、购买点数、生成密钥、开始调用。无需合同谈判即可开始集成。

工作原理

提交. 用你的密钥将场景文档（及可选数值序列）POST 到 /v1/scenarios。
接收通知. Foretell 运行完整的 1,000 智能体 × 4 轮模拟；完成时触发你的签名 webhook。
拉取报告. GET 拉取完整 JSON 报告——结论、群体、引述、失败模式与定量预测。

关联报告与决策裁定器（Decision Tiebreaker）API

在真实选项之间做决定？将两次或更多已完成的模拟关联为一份交叉分析——每份关联报告 $25，场景数量不限——可输出带推荐优胜方案的排名，或刻意保持中立的并列对比。难分高下？决策裁定器（$75 固定价格）会独立重跑每个选项，并返回一个决定性的答案。

GET /v1/links/linkable — 可关联的场景
POST /v1/links — 创建关联报告（排名或对比模式）
GET /v1/links — 列出您的关联报告
GET /v1/links/{link_id} — 单份关联报告的状态
GET /v1/links/{link_id}/report — 完整的交叉分析 JSON
POST /v1/links/{link_id}/tiebreaker — 运行决策裁定器

完整架构见 API 参考文档 · 查看实时示例报告 →

开始构建。

注册账户 → 阅读 API 参考

← 返回 foretell.technology

Foretell API

予測シミュレーションを製品に組み込む。

Web コンソールと同じエンジンを、シンプルな JSON API で。シナリオを送信し、署名付き webhook を受信し、完全なレポートを取得。営業電話は不要。

開発者向け

ウォレットは一つ、API 料金プランなし

API キーは Web アプリと同じ前払いクレジットウォレットから引き落とします——1 クレジット = 1 シミュレーション = 199 ドル。一度購入すれば両方の面から利用できます。サブスクも別 API プランもありません。

完全なレポート、サブセットではない

API はコンソールと同じ構造化レポートを返します：リスク判定、5 つの失敗モード、コホート別のスタンスと合成引用、センチメント推移、数値系列を添付した際の TimesFM 定量予測。内部デバッグ項目のみ除外されます。

ポーリング不要の署名付き webhook

HTTPS エンドポイントを登録すると、Foretell が scenario.completed / scenario.failed 時に HMAC-SHA256 署名付き（Foretell-Signature: t=…,v1=…）の webhook を送信します。署名を検証してレポートを取得。

3 回の呼び出しで統合

シナリオを POST、webhook を受信、JSON レポートを GET。Bearer または X-API-Key。キーごとに 120 リクエスト/分。キーはダッシュボードから無料で即時発行。

企業向け

公開前に反応をテスト

広報・PR レビューのパイプラインに Foretell を組み込み、重要な発表を公開前に自動でシミュレーション——誰かが確認を覚えているのに頼らずに。（当社の公開サンプルレポートは、これが事前に捉える反発の架空の例です。）

自社製品に組み込む

広報ツール、PR エージェンシー、戦略コンサル、プロダクト管理プラットフォーム——Foretell のシミュレーションを自社製品の機能として組み込み、顧客が foretell.technology を訪れる必要はありません。

セルフサービス、営業プロセスなし

Web アプリと同じ即時アクセス：アカウント作成、クレジット購入、キー発行、呼び出し開始。契約交渉は不要です。

仕組み

送信. シナリオ文書（および任意の数値系列）をキーとともに /v1/scenarios へ POST。
通知を受け取る. Foretell が 1,000 エージェント × 4 ラウンドの完全なシミュレーションを実行し、完了時に署名付き webhook を発火。
レポートを取得. 完全な JSON レポートを GET——判定、コホート、引用、失敗モード、定量予測。

リンクレポートとDecision Tiebreaker、API で

実際の選択肢の間で迷っていますか？完了した2つ以上のシミュレーションを1つのクロス分析に連結できます——リンクレポート1件につき$25、シナリオ数は無制限——推奨案付きのランキング形式でも、意図的に中立な並列比較でも。僅差で決められない？Decision Tiebreaker（$75固定）が各選択肢を独立して再実行し、決定的な答えを1つ返します。

GET /v1/links/linkable — リンク可能なシナリオ
POST /v1/links — リンクレポートの作成（ランキング／比較モード）
GET /v1/links — リンクレポートの一覧
GET /v1/links/{link_id} — リンクレポートのステータス
GET /v1/links/{link_id}/report — クロス分析の完全なJSON
POST /v1/links/{link_id}/tiebreaker — Decision Tiebreakerの実行

完全なスキーマはAPIリファレンスへ · ライブサンプルレポートを見る →

構築を始める。

アカウント作成 → API リファレンスを読む

← foretell.technology へ戻る

API Foretell

Встройте прогнозную симуляцию в свой продукт.

Тот же движок, что и веб-консоль, через простой JSON API. Отправьте сценарий, получите подписанный webhook, заберите полный отчёт. Без звонка отдела продаж.

Для разработчиков

Один кошелёк, без тарифа API

Ключи API списывают средства из того же предоплаченного кошелька, что и веб-приложение — 1 кредит = 1 симуляция = 199 $. Купите один раз, тратьте с обеих поверхностей. Ни подписки, ни отдельного тарифа API.

Полный отчёт, а не подмножество

API возвращает тот же структурированный отчёт, что и консоль: вердикт риска, пять режимов отказа, позицию и синтетические цитаты по когортам, траекторию настроения и количественный прогноз TimesFM. Удаляются только внутренние отладочные поля.

Подписанные webhook, без опроса

Зарегистрируйте HTTPS-эндпоинт, и Foretell доставит webhook при scenario.completed / scenario.failed, подписанный HMAC-SHA256 (Foretell-Signature: t=…,v1=…). Проверьте подпись и заберите отчёт.

Интеграция в три вызова

POST сценарий, приём webhook, GET JSON-отчёт. Bearer или X-API-Key. 120 запросов/мин на ключ. Ключи бесплатны и выдаются мгновенно из панели.

Для компаний

Тестируйте реакцию до публикации

Подключите Foretell к конвейеру проверки коммуникаций/PR, чтобы каждое важное объявление автоматически моделировалось до выхода. (Наш публичный образец отчёта — вымышленная иллюстрация именно такой заранее выявленной реакции.)

Встройте в собственный продукт

Инструменты коммуникаций, PR-агентства, стратегические консультанты, платформы управления продуктом — встройте симуляцию Foretell как функцию своего продукта, чтобы клиентам не нужно было заходить на foretell.technology.

Самообслуживание, без отдела продаж

Тот же мгновенный доступ, что и у веб-приложения: создайте аккаунт, купите кредиты, выпустите ключ, начните вызовы. Без переговоров по договору.

Как это работает

Отправьте. Отправьте POST документы сценария (и необязательный числовой ряд) на /v1/scenarios со своим ключом.
Получите уведомление. Foretell выполняет полную симуляцию 1000 агентов × 4 раунда; по завершении срабатывает ваш подписанный webhook.
Заберите отчёт. Заберите GET полный JSON-отчёт — вердикт, когорты, цитаты, режимы отказа и количественный прогноз.

Связанные отчёты и Decision Tiebreaker — в API

Выбираете между реальными вариантами? Свяжите две или более завершённые симуляции в один кросс-анализ — $25 за связанный отчёт, любое число сценариев — с ранжированием и рекомендованным победителем или как намеренно нейтральное сравнение. Слишком близко? Decision Tiebreaker ($75 фиксированно) независимо перезапускает каждый вариант и возвращает один решающий ответ.

GET /v1/links/linkable — сценарии, доступные для связывания
POST /v1/links — создать связанный отчёт (режим ранжирования или сравнения)
GET /v1/links — список ваших связанных отчётов
GET /v1/links/{link_id} — статус связанного отчёта
GET /v1/links/{link_id}/report — полный JSON кросс-анализа
POST /v1/links/{link_id}/tiebreaker — запустить Decision Tiebreaker

Полные схемы — в справочнике API · Посмотреть живой образец отчёта →

Начните разработку.

Создать аккаунт → Читать справочник API

← Назад на foretell.technology

API Foretell

Integra la simulazione predittiva nel tuo prodotto.

Lo stesso motore della console web, tramite una semplice API JSON. Invia uno scenario, ricevi un webhook firmato, scarica il report completo. Senza chiamate commerciali.

Per gli sviluppatori

Un solo portafoglio, nessun piano API

Le chiavi attingono allo stesso portafoglio crediti prepagato dell'app web — 1 credito = 1 simulazione = 199 $. Acquista una volta, spendi da entrambe le superfici. Nessun abbonamento né piano API separato.

Il report completo, non un sottoinsieme

L'API restituisce lo stesso report strutturato mostrato dalla console: verdetto di rischio, cinque modalità di fallimento, posizione e citazioni per coorte, traiettoria del sentiment e la previsione quantitativa TimesFM. Vengono rimossi solo i campi di debug interni.

Webhook firmati, niente polling

Registra un endpoint HTTPS e Foretell consegna un webhook su scenario.completed / scenario.failed, firmato con HMAC-SHA256 (Foretell-Signature: t=…,v1=…). Verifica la firma e scarica il report.

Integrazione in tre chiamate

Invia uno scenario, ricevi il webhook, scarica il report JSON. Bearer o X-API-Key. 120 richieste/min per chiave. Chiavi gratuite e istantanee dalla tua dashboard.

Per le aziende

Testa la reazione prima di pubblicare

Collega Foretell a una pipeline di revisione comunicazione/PR così ogni annuncio importante viene simulato automaticamente prima di uscire. (Il nostro report di esempio pubblico è un'illustrazione fittizia proprio del tipo di reazione così anticipato.)

Integrala nel tuo prodotto

Strumenti di comunicazione, agenzie PR, consulenze strategiche, piattaforme di product management — integra la simulazione di Foretell come funzione nel tuo prodotto, senza che i tuoi clienti visitino foretell.technology.

Self-service, nessun processo commerciale

Lo stesso accesso istantaneo dell'app web: crea un account, acquista crediti, emetti una chiave, inizia. Nessuna negoziazione contrattuale.

Come funziona

Invia. Invia in POST i documenti dello scenario (e una serie numerica opzionale) a /v1/scenarios con la tua chiave.
Ricevi notifica. Foretell esegue la simulazione completa di 1.000 agenti × 4 round; al termine attiva il tuo webhook firmato.
Scarica il report. Scarica in GET il report JSON completo — verdetto, coorti, citazioni, modalità di fallimento e previsione quantitativa.

Linked Reports e il Decision Tiebreaker, nell'API

State decidendo tra opzioni reali? Collegate due o più simulazioni completate in un'unica analisi incrociata — 25 $ per report collegato, qualsiasi numero di scenari — classificata con una vincitrice consigliata, o come confronto volutamente neutrale. Troppo in bilico? Il Decision Tiebreaker (75 $ fissi) riesegue ogni opzione in modo indipendente e restituisce un'unica risposta decisiva.

GET /v1/links/linkable — scenari collegabili
POST /v1/links — creare un report collegato (modalità classifica o confronto)
GET /v1/links — elencare i vostri report collegati
GET /v1/links/{link_id} — stato di un report collegato
GET /v1/links/{link_id}/report — il JSON completo dell'analisi incrociata
POST /v1/links/{link_id}/tiebreaker — eseguire il Decision Tiebreaker

Schemi completi nella documentazione API · Guarda un report di esempio dal vivo →

Inizia a costruire.

Crea un account → Leggi il riferimento API

← Torna a foretell.technology

Foretell API

Integreer voorspellende simulatie in je product.

Dezelfde engine als de webconsole, via een eenvoudige JSON-API. Dien een scenario in, ontvang een ondertekende webhook, haal het volledige rapport op. Zonder verkoopgesprek.

Voor ontwikkelaars

Eén wallet, geen API-tarief

API-sleutels putten uit dezelfde vooruitbetaalde credit-wallet als de web-app — 1 credit = 1 simulatie = $199. Koop één keer, gebruik vanaf beide oppervlakken. Geen abonnement, geen apart API-plan.

Het volledige rapport, geen subset

De API retourneert hetzelfde gestructureerde rapport als de console: risicooordeel, vijf faalmodi, houding en synthetische citaten per cohort, sentimenttraject en de kwantitatieve TimesFM-prognose. Alleen interne debugvelden worden verwijderd.

Ondertekende webhooks, geen polling

Registreer een HTTPS-endpoint en Foretell levert een webhook bij scenario.completed / scenario.failed, ondertekend met HMAC-SHA256 (Foretell-Signature: t=…,v1=…). Verifieer de handtekening en haal het rapport op.

Integreer in drie aanroepen

POST een scenario, ontvang de webhook, GET het JSON-rapport. Bearer of X-API-Key. 120 verzoeken/min per sleutel. Sleutels gratis en direct vanuit je dashboard.

Voor bedrijven

Test de reactie vóór je publiceert

Koppel Foretell aan een comms-/PR-reviewpijplijn zodat elke grote aankondiging automatisch wordt gesimuleerd vóór verzending. (Ons openbare voorbeeldrapport is een fictieve illustratie van precies de reactie die dit vooraf opvangt.)

Bouw het in je eigen product in

Comms-tools, PR-bureaus, strategieconsultants, productmanagementplatforms — bouw Foretells simulatie als functie in je eigen product, zodat je klanten foretell.technology nooit hoeven te bezoeken.

Self-service, geen verkoopproces

Dezelfde directe toegang als de web-app: maak een account, koop credits, geef een sleutel uit, begin. Geen contractonderhandeling.

Hoe het werkt

Indienen. POST je scenariodocumenten (en een optionele numerieke reeks) naar /v1/scenarios met je sleutel.
Melding krijgen. Foretell voert de volledige simulatie van 1.000 agenten × 4 rondes uit; bij voltooiing activeert het je ondertekende webhook.
Rapport ophalen. GET het volledige JSON-rapport — oordeel, cohorten, citaten, faalmodi en de kwantitatieve prognose.

Linked Reports & de Decision Tiebreaker, in de API

Beslissen tussen echte opties? Koppel twee of meer voltooide simulaties tot één kruisanalyse — $25 per gekoppeld rapport, ongeacht het aantal scenario's — gerangschikt met een aanbevolen winnaar, of als bewust neutrale vergelijking. Te close? De Decision Tiebreaker ($75 vast) draait elke optie onafhankelijk opnieuw en geeft één beslissend antwoord.

GET /v1/links/linkable — scenario's die gekoppeld kunnen worden
POST /v1/links — een gekoppeld rapport aanmaken (ranglijst- of vergelijkingsmodus)
GET /v1/links — uw gekoppelde rapporten weergeven
GET /v1/links/{link_id} — status van één gekoppeld rapport
GET /v1/links/{link_id}/report — de volledige kruisanalyse-JSON
POST /v1/links/{link_id}/tiebreaker — de Decision Tiebreaker uitvoeren

Volledige schema's in de API-referentie · Bekijk een live voorbeeldrapport →

Begin met bouwen.

Account aanmaken → Lees de API-referentie

← Terug naar foretell.technology

Foretell API

예측 시뮬레이션을 제품에 통합하세요.

웹 콘솔과 동일한 엔진을 간단한 JSON API로. 시나리오를 제출하고, 서명된 webhook을 받고, 전체 리포트를 가져오세요. 영업 통화 없이.

개발자용

하나의 지갑, API 요금제 없음

API 키는 웹 앱과 동일한 선불 크레딧 지갑에서 차감됩니다 — 1 크레딧 = 1 시뮬레이션 = $199. 한 번 구매하면 양쪽에서 사용. 구독도 별도 API 요금제도 없습니다.

일부가 아닌 전체 리포트

API는 콘솔이 보여주는 것과 동일한 구조화된 리포트를 반환합니다: 위험 판정, 다섯 가지 실패 모드, 코호트별 입장과 합성 인용, 감정 추이, 수치 시계열 첨부 시 TimesFM 정량 예측. 내부 디버그 필드만 제거됩니다.

폴링 없는 서명된 webhook

HTTPS 엔드포인트를 등록하면 Foretell이 scenario.completed / scenario.failed 시 HMAC-SHA256으로 서명된(Foretell-Signature: t=…,v1=…) webhook을 전달합니다. 서명을 검증하고 리포트를 가져오세요.

세 번의 호출로 통합

시나리오를 POST하고, webhook을 받고, JSON 리포트를 GET. Bearer 또는 X-API-Key. 키당 분당 120 요청. 키는 대시보드에서 무료로 즉시 발급됩니다.

기업용

게시 전에 반응을 테스트

Foretell을 커뮤니케이션/PR 검토 파이프라인에 연결하여 모든 주요 발표가 배포 전에 자동으로 시뮬레이션되도록 하세요. (공개 샘플 리포트는 이것이 사전에 포착하는 반발의 가상 예시입니다.)

자체 제품에 내장

커뮤니케이션 도구, PR 대행사, 전략 컨설팅, 제품 관리 플랫폼 — Foretell 시뮬레이션을 자체 제품의 기능으로 내장하여 고객이 foretell.technology를 방문할 필요가 없게 하세요.

셀프서비스, 영업 절차 없음

웹 앱과 동일한 즉시 액세스: 계정 생성, 크레딧 구매, 키 발급, 호출 시작. 통합을 시작하는 데 계약 협상이 필요 없습니다.

작동 방식

제출. 키와 함께 시나리오 문서(및 선택적 수치 시계열)를 /v1/scenarios로 POST.
알림 수신. Foretell이 1,000 에이전트 × 4 라운드 전체 시뮬레이션을 실행하고 완료 시 서명된 webhook을 발동합니다.
리포트 가져오기. 전체 JSON 리포트를 GET — 판정, 코호트, 인용, 실패 모드, 정량 예측.

연결 리포트와 Decision Tiebreaker — API에서

실제 선택지 사이에서 고민 중이신가요? 완료된 시뮬레이션 두 개 이상을 하나의 교차 분석으로 연결하세요 — 연결 리포트당 $25, 시나리오 수 무제한 — 추천 우승안이 있는 랭킹 형식 또는 의도적으로 중립적인 나란히 비교 형식. 너무 막상막하인가요? Decision Tiebreaker($75 고정)가 각 선택지를 독립적으로 재실행하여 결정적인 답 하나를 돌려드립니다.

GET /v1/links/linkable — 연결 가능한 시나리오
POST /v1/links — 연결 리포트 생성(랭킹 또는 비교 모드)
GET /v1/links — 내 연결 리포트 목록
GET /v1/links/{link_id} — 연결 리포트 상태
GET /v1/links/{link_id}/report — 교차 분석 전체 JSON
POST /v1/links/{link_id}/tiebreaker — Decision Tiebreaker 실행

전체 스키마는 API 레퍼런스에서 · 라이브 샘플 리포트 보기 →

구축을 시작하세요.

계정 만들기 → API 레퍼런스 읽기

← foretell.technology로 돌아가기