Quick start

pip install requests

import requests
import time

api_key = "YOUR_API_KEY"
api_url = "https://api.twin.so"

# Task configuration
start_url = "https://www.google.com"
goal = "Find the latest price of AAPL stock. Return the stock price, nothing else."

# Start the task
response = requests.post(
    f"{api_url}/browse",
    headers={
        'Content-Type': 'application/json',
        'x-api-key': api_key
    },
    json={
        "startUrl": start_url,
        "goal": goal,
        "outputType": "string"
    }
)

# Get the task ID
task_id = response.json().get("taskId")
if not task_id:
    print("Failed to start task.")
    exit()

print(f"Started task with ID: {task_id}")

previous_action = None

# Poll for task status
while True:
    response = requests.get(
        f"{api_url}/task/{task_id}?limit=1",
        headers={'x-api-key': api_key}
    )
    
    data = response.json()
    
    status = data.get('status')
    steps = data.get('steps', [])
    
    if steps:
        last_action = steps[-1].get('action')
        if last_action != previous_action and last_action is not None:
            print(f"Last action: {last_action}")
            previous_action = last_action
    
    if status in ['COMPLETED', 'FAILED']:
        print(f"Task {status}.")
        break
    
    time.sleep(2)

Started task with ID: 90347816-e2b3-479a-a28e-8b3a96f84916

Last action: 
  { 
  'action': 'type_and_submit', 
  'human_readable': 'the agent typed the text "AAPL stock price" and pressed enter in element with the id="typable-element-11" of an HTML type "textarea" and the textual content ""'
  }

Last action: 
  {
  'action': 'record', 
  'human_readable': 'Recording the following:\nThe latest price of AAPL (Apple Inc) stock is 220.82 USD.'
  }

Task COMPLETED.