Skip to content
Figranium logo

Task Structure (JSON)

Tasks are primarily built using Action Blocks, which define the steps the browser should take. The JSON structure below represents how these tasks ...

While the JSON schema is useful for API integrations, most users will interact with tasks through the visual editor using Action Blocks.

Full Schema#

{
  "id": "task_123456789",
  "name": "My Automation Task",
  "mode": "agent", // "agent" | "scrape"
  "url": "https://example.com",
  "wait": 2, // Initial wait time in seconds
  "rotateUserAgents": false,
  "rotateProxies": false,
  "rotateViewport": false,
  "humanTyping": false, // Simulates human typing speed
  "includeShadowDom": true,
  "disableRecording": false,
  "statelessExecution": false, // If true, cookies are not saved
  "stealth": {
    "allowTypos": false,
    "idleMovements": false,
    "overscroll": false,
    "deadClicks": false,
    "fatigue": false,
    "naturalTyping": false
  },
  "actions": [
    {
      "id": "act_1",
      "type": "click",
      "selector": "#submit-button",
      "disabled": false
    },
    {
      "id": "act_2",
      "type": "wait",
      "value": "2"
    }
  ],
  "variables": {
    "query": { "type": "string", "value": "search term" }
  },
  "extractionScript": "return document.title;",
  "extractionFormat": "json" // "json" | "csv"
}

Key Fields#

mode#

  • agent: Executes a sequence of actions (click, type, etc.). Most powerful.
  • scrape: Simple "visit and extract" mode. Useful for static pages.

actions#

An array of steps to execute. See Action Blocks for details on each available block type.

variables#

Dynamic values that can be injected into url, selector, value, or scripts using {$varName} syntax.

stealth#

Configuration for bot detection evasion.

  • naturalTyping: Random delays between keystrokes.
  • idleMovements: Random mouse movements when waiting.

extractionScript#

A JavaScript snippet that runs in the browser context after all actions are complete. The return value is saved as the task result.

Previous
Next