Causality Graph

{
  "nodes": [
    { "id": "n1", "label": "Rising interest rates" },
    { "id": "n2", "label": "Lower consumer spending" },
    { "id": "n3", "label": "Reduced GDP growth" },
    { "id": "n4", "label": "Higher unemployment" }
  ],
  "edges": [
    { "from": "n1", "to": "n2", "label": "causes" },
    { "from": "n2", "to": "n3", "label": "leads to" },
    { "from": "n3", "to": "n4", "label": "leads to" }
  ],
  "meta": {
    "total_nodes": 4,
    "total_edges": 3,
    "executionTimeMs": 640
  }
}

POST

api

causality-graph

{
  "nodes": [
    { "id": "n1", "label": "Rising interest rates" },
    { "id": "n2", "label": "Lower consumer spending" },
    { "id": "n3", "label": "Reduced GDP growth" },
    { "id": "n4", "label": "Higher unemployment" }
  ],
  "edges": [
    { "from": "n1", "to": "n2", "label": "causes" },
    { "from": "n2", "to": "n3", "label": "leads to" },
    { "from": "n3", "to": "n4", "label": "leads to" }
  ],
  "meta": {
    "total_nodes": 4,
    "total_edges": 3,
    "executionTimeMs": 640
  }
}

Analyze cause-and-effect relationships from a URL or uploaded file (PDF, Markdown). Returns nodes (concepts/events) and directed edges (causal relationships) that can be used to visualize cause-and-effect chains.

Endpoints

Method	Path	Input
`POST`	`/api/v1/causality-graph`	JSON body with `url`
`POST`	`/api/v1/causality-graph/file`	`multipart/form-data` with `file`

POST /api/v1/causality-graph

Request Body

string

required

URL of the page or document to extract causal relationships from.

string

Language for the extracted node and edge labels (e.g. english, korean). Node id values remain in English/ASCII for graph integrity. Defaults to English.

number

default:"30"

Maximum number of nodes to extract. Range: 1–100. Edge count is naturally bounded by node count.

cURL

curl -X POST "https://api.factagora.com/api/v1/causality-graph" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/economic-analysis"}'

Python

resp = requests.post(
    "https://api.factagora.com/api/v1/causality-graph",
    headers={"Authorization": "Bearer fa_your_api_key"},
    json={"url": "https://example.com/economic-analysis"},
)
graph = resp.json()

TypeScript

const resp = await fetch("https://api.factagora.com/api/v1/causality-graph", {
  method: "POST",
  headers: {
    Authorization: "Bearer fa_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com/economic-analysis" }),
});
const graph = await resp.json();

POST /api/v1/causality-graph/file

Request Body (multipart/form-data)

file

required

PDF or Markdown file to extract causal relationships from.

curl -X POST "https://api.factagora.com/api/v1/causality-graph/file" \
  -H "Authorization: Bearer fa_your_api_key" \
  -F "file=@analysis.pdf"

Response

array

List of concept or event nodes in the graph.

Show Node fields

string

Unique node identifier

string

Human-readable label for the node

array

List of directed causal relationships between nodes.

Show Edge fields

string

Source node ID (cause)

string

Target node ID (effect)

string

Optional description of the relationship

object

Show Meta fields

number

Total number of nodes

number

Total number of edges

number

Response time in milliseconds

{
  "nodes": [
    { "id": "n1", "label": "Rising interest rates" },
    { "id": "n2", "label": "Lower consumer spending" },
    { "id": "n3", "label": "Reduced GDP growth" },
    { "id": "n4", "label": "Higher unemployment" }
  ],
  "edges": [
    { "from": "n1", "to": "n2", "label": "causes" },
    { "from": "n2", "to": "n3", "label": "leads to" },
    { "from": "n3", "to": "n4", "label": "leads to" }
  ],
  "meta": {
    "total_nodes": 4,
    "total_edges": 3,
    "executionTimeMs": 640
  }
}

Overview

Endpoints

Best Practices

Endpoints

POST /api/v1/causality-graph

Request Body

POST /api/v1/causality-graph/file

Request Body (multipart/form-data)

Response

​Endpoints

​POST /api/v1/causality-graph

​Request Body

​POST /api/v1/causality-graph/file

​Request Body (multipart/form-data)

​Response

Endpoints

POST /api/v1/causality-graph

Request Body

POST /api/v1/causality-graph/file

Request Body (multipart/form-data)

Response