AGI API - Documentation

The API for Agents That Actually Work

Stop wrestling with unreliable automation. Battle-tested, production-ready agents trusted by leading companies. No brittle scripts. No maintenance nightmares. Just natural language that works. Tasks. Purchases. Research. Complex workflows. All in plain English.

What makes AGI different? Our agents understand context, adapt to website changes, and handle edge cases automatically. They work like humans: intelligently, reliably, and at scale.

Production Ready

Battle-tested at scale by leading companies handling millions of tasks

Fast Setup

Get started in minutes. No configuration needed.

Enterprise Security

Security-first architecture with isolated sessions

Quick Start

Deploy your first agent in 5 minutes

Dashboard

Monitor sessions and manage API keys

Built for Scale

Production-ready agents handle everything from simple automation to complex workflows with enterprise-grade reliability.

99.9% Uptime

Enterprise-grade reliability

< 5 Min Setup

From zero to running

Real-Time Monitoring

Watch agents work live

Natural Language

No code required

What Can AGI Do?

From simple automation to complex multi-step workflows. AGI agents handle web navigation, form filling, data extraction, and decision-making—all through natural language.

Pro Tip: Start with simple tasks to understand agent behavior, then scale to complex workflows. Watch agents work in real-time via VNC connections.

E-commerce & Shopping

Price comparison, inventory tracking, deal finding, and automated purchases.

Research & Data Collection

Competitive intelligence, trend monitoring, and data extraction to JSON/CSV.

Travel & Bookings

Flight and hotel comparison, fare monitoring, and automated booking workflows.

Form Automation

Job applications, lead forms, and multi-step registrations with verification.

Sales & Marketing

Lead enrichment, competitor analysis, and prospect list generation.

Custom Workflows

Any web-based task with intelligent navigation, scheduling, and webhooks.

How It Works

Four steps. Zero to running in minutes.

Install Package

Install the official package for your language.

JavaScript
Python
HTTPie

npm install agi

pip install pyagi

# macOS
brew install httpie

# Linux
apt install httpie

# Windows
pip install httpie

Create a Session

Launch a new browser session. Each session runs in complete isolation.

JavaScript
Python
HTTPie

import { AGIClient } from 'agi';
const client = new AGIClient({ apiKey: 'your_api_key' });

from pyagi import AGIClient
client = AGIClient(api_key="your_api_key")

export AGI_API_KEY="your_api_key"

Open the vnc_url to watch your agent work in real-time!

Send Instructions

Give the agent instructions in plain English. No scripting required.

JavaScript
Python
HTTPie

const session = await client.createSession('agi-0');
const result = await session.runTask(
    'Find the cheapest iPhone 15 Pro on Amazon, Best Buy, and Apple Store'
);
await session.delete();

with client.session("agi-0") as session:
    result = session.run_task(
        "Find the cheapest iPhone 15 Pro on Amazon, Best Buy, and Apple Store"
    )

SESSION=$(http POST https://api.agi.tech/v1/sessions \
  Authorization:"Bearer $AGI_API_KEY" \
  agent_name=agi-0 | jq -r '.session_id')

http POST https://api.agi.tech/v1/sessions/$SESSION/message \
  Authorization:"Bearer $AGI_API_KEY" \
  message="Find the cheapest iPhone 15 Pro on Amazon, Best Buy, and Apple Store"

# Poll for results (see quickstart for full example)

Get Results

Get structured data. Stream events in real-time or poll at your own pace.

JavaScript
Python
HTTPie

// Results are automatically returned
console.log(result);  // JSON string or parsed object

# Results are automatically returned
print(result)  # JSON string or parsed object

# Poll for messages until DONE
http GET https://api.agi.tech/v1/sessions/$SESSION/messages \
  Authorization:"Bearer $AGI_API_KEY" | jq '.messages[] | select(.type=="DONE")'

Why Developers Choose AGI

Built by developers, for developers. AGI API has processed millions of tasks for leading companies. Clean APIs, comprehensive docs, world-class support.

Natural Language

Tell agents what you need in plain English. No scripting required.

Real-Time Monitoring

Watch agents work live through VNC connections.

Persistent Sessions

Maintain login state and context across tasks.

Event Streaming

Real-time updates via Server-Sent Events (SSE).

Production Ready

Enterprise-grade reliability with automatic error recovery.

Developer First

Clean APIs, comprehensive docs, world-class support.

See It In Action

Complete example: compare prices across multiple retailers.

JavaScript
Python
HTTPie

import { AGIClient } from 'agi';

const client = new AGIClient({ apiKey: 'your_api_key' });

// Create session and run task
const session = await client.createSession('agi-0');
try {
    const result = await session.runTask(
        'Compare Sony WH-1000XM5 prices on Amazon, Best Buy, and Target. Return as JSON.'
    );
    console.log('Results:', result);
} finally {
    await session.delete();
}

from pyagi import AGIClient

client = AGIClient(api_key="your_api_key")

# Create session and run task
with client.session("agi-0") as session:
    result = session.run_task(
        "Compare Sony WH-1000XM5 prices on Amazon, Best Buy, and Target. Return as JSON."
    )
    print("Results:", result)

# Set your API key
export AGI_API_KEY="your_api_key"

# Create session
SESSION=$(http POST https://api.agi.tech/v1/sessions \
  Authorization:"Bearer $AGI_API_KEY" \
  agent_name=agi-0 | jq -r '.session_id')

# Send task
http POST https://api.agi.tech/v1/sessions/$SESSION/message \
  Authorization:"Bearer $AGI_API_KEY" \
  message="Compare Sony WH-1000XM5 prices on Amazon, Best Buy, and Target. Return as JSON."

# Poll for results
while true; do
  STATUS=$(http GET https://api.agi.tech/v1/sessions/$SESSION/status \
    Authorization:"Bearer $AGI_API_KEY" | jq -r '.status')
  
  if [ "$STATUS" = "finished" ]; then
    http GET https://api.agi.tech/v1/sessions/$SESSION/messages \
      Authorization:"Bearer $AGI_API_KEY" | jq '.messages[] | select(.type=="DONE")'
    break
  fi
  sleep 2
done

# Cleanup
http DELETE https://api.agi.tech/v1/sessions/$SESSION \
  Authorization:"Bearer $AGI_API_KEY"

Real-World Use Cases

Production-ready patterns for common use cases.

Price Intelligence
Lead Generation
Travel Booking
Data Extraction

JavaScript
Python
HTTPie

const session = await client.createSession('agi-0-fast');
const result = await session.runTask(`
    Check prices for [product] on:
    - competitor1.com
    - competitor2.com
    - competitor3.com
    
    Return comparison table with prices and availability.
`);
await session.delete();

with client.session("agi-0-fast") as session:
    result = session.run_task("""
        Check prices for [product] on:
        - competitor1.com
        - competitor2.com
        - competitor3.com
        
        Return comparison table with prices and availability.
    """)

SESSION=$(http POST https://api.agi.tech/v1/sessions \
  Authorization:"Bearer $AGI_API_KEY" \
  agent_name=agi-0-fast | jq -r '.session_id')

http POST https://api.agi.tech/v1/sessions/$SESSION/message \
  Authorization:"Bearer $AGI_API_KEY" \
  message="Check prices for [product] on competitor1.com, competitor2.com, competitor3.com. Return comparison table with prices and availability."

JavaScript
Python
HTTPie

const session = await client.createSession('agi-0');
const result = await session.runTask(`
    Research company: Acme Corp
    
    Find:
    - Employee count
    - Recent funding rounds
    - Technology stack
    - Key decision makers
    - Contact information
`);
await session.delete();

with client.session("agi-0") as session:
    result = session.run_task("""
        Research company: Acme Corp
        
        Find:
        - Employee count
        - Recent funding rounds
        - Technology stack
        - Key decision makers
        - Contact information
    """)

SESSION=$(http POST https://api.agi.tech/v1/sessions \
  Authorization:"Bearer $AGI_API_KEY" \
  agent_name=agi-0 | jq -r '.session_id')

http POST https://api.agi.tech/v1/sessions/$SESSION/message \
  Authorization:"Bearer $AGI_API_KEY" \
  message="Research company: Acme Corp. Find: Employee count, Recent funding rounds, Technology stack, Key decision makers, Contact information."

JavaScript
Python
HTTPie

const session = await client.createSession('agi-0');
const result = await session.runTask(`
    Find round-trip flights:
    - From: SFO
    - To: JFK
    - Dates: June 15-22
    - Max price: $500
    - Prefer: Morning departures
    
    Show top 3 options sorted by price.
`);
await session.delete();

with client.session("agi-0") as session:
    result = session.run_task("""
        Find round-trip flights:
        - From: SFO
        - To: JFK
        - Dates: June 15-22
        - Max price: $500
        - Prefer: Morning departures
        
        Show top 3 options sorted by price.
    """)

SESSION=$(http POST https://api.agi.tech/v1/sessions \
  Authorization:"Bearer $AGI_API_KEY" \
  agent_name=agi-0 | jq -r '.session_id')

http POST https://api.agi.tech/v1/sessions/$SESSION/message \
  Authorization:"Bearer $AGI_API_KEY" \
  message="Find round-trip flights: From SFO, To JFK, Dates June 15-22, Max price $500, Prefer morning departures. Show top 3 options sorted by price."

JavaScript
Python
HTTPie

const session = await client.createSession('agi-0-fast');
const result = await session.runTask(`
    Go to: example.com/products
    
    Extract all products with:
    - Product name
    - Price
    - Rating
    - Availability
    
    Return as JSON array.
`);
await session.delete();

with client.session("agi-0-fast") as session:
    result = session.run_task("""
        Go to: example.com/products
        
        Extract all products with:
        - Product name
        - Price
        - Rating
        - Availability
        
        Return as JSON array.
    """)

SESSION=$(http POST https://api.agi.tech/v1/sessions \
  Authorization:"Bearer $AGI_API_KEY" \
  agent_name=agi-0-fast | jq -r '.session_id')

http POST https://api.agi.tech/v1/sessions/$SESSION/message \
  Authorization:"Bearer $AGI_API_KEY" \
  message="Go to: example.com/products. Extract all products with: Product name, Price, Rating, Availability. Return as JSON array."

Security

Security built into every layer. Isolated sessions, real-time monitoring, automatic abuse prevention.

All agent activities are monitored. The system screens for malicious intent before executing commands.

Rate Limiting

Automatic throttling prevents abuse

Secure Payments

Support for 1-time-use payment tokens

Activity Monitoring

Real-time screening for malicious behavior

Data Privacy

Isolated sessions with automatic cleanup

Ready to Build?

Quick Start

Get your first agent running in 5 minutes

Get Support

Questions? We’re here to help.

API Reference

Complete endpoint documentation

Use Cases

Real-world examples and patterns

Built by AGI, Inc. - Redefining human-AI interaction to bring AGI into everyday life.

Getting Started

Use Cases

Best Practices

Advanced

Troubleshooting

​The API for Agents That Actually Work

Production Ready

Fast Setup

Enterprise Security

Quick Start

Dashboard

​Built for Scale

99.9% Uptime

< 5 Min Setup

Real-Time Monitoring

Natural Language

​What Can AGI Do?

E-commerce & Shopping

Research & Data Collection

Travel & Bookings

Form Automation

Sales & Marketing

Custom Workflows

​How It Works

​Why Developers Choose AGI

Natural Language

Real-Time Monitoring

Persistent Sessions

Event Streaming

Production Ready

Developer First

​See It In Action

​Real-World Use Cases

​Security

Rate Limiting

Secure Payments

Activity Monitoring

Data Privacy

​Ready to Build?

Quick Start

Get Support

API Reference

Use Cases

The API for Agents That Actually Work

Built for Scale

What Can AGI Do?

How It Works

Why Developers Choose AGI

See It In Action

Real-World Use Cases

Security

Ready to Build?