Autonomous API Reference

Detailed documentation for Stelis Autonomous API endpoints

The Autonomous API allows you to perform complex web automation tasks with simple, high-level commands.

POST /browse

Automate a series of actions on a website based on a natural language prompt.

Endpoint

POST https://api.stelis.app/v1/browse

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body

Parameter	Type	Description
prompt	string	Natural language description of the task to perform
url	string	Starting URL for the automation task
maxSteps	integer	(Optional) Maximum number of steps to perform

Example Request

{
  "prompt": "Search for wireless headphones on Amazon and add the cheapest option to the cart",
  "url": "https://www.amazon.com",
  "maxSteps": 10
}

Example Response

{
  "status": "success",
  "result": {
    "finalUrl": "https://www.amazon.com/cart",
    "actions": [
      { "type": "navigate", "url": "https://www.amazon.com" },
      { "type": "input", "selector": "#twotabsearchtextbox", "value": "wireless headphones" },
      { "type": "click", "selector": "#nav-search-submit-button" },
      { "type": "click", "selector": "[data-cel-widget='search_result_1']" },
      { "type": "click", "selector": "#add-to-cart-button" }
    ],
    "screenshot": "base64_encoded_image"
  }
}

POST /retrieve

Retrieve specific information from a web page without performing actions.

Endpoint

POST https://api.stelis.app/v1/retrieve

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body

Parameter	Type	Description
url	string	URL of the page to retrieve information from
query	string	Natural language query about the page content
selector	string	(Optional) CSS selector to focus on specific page elements

Example Request

{
  "url": "https://example.com/product-page",
  "query": "What is the current price of the product?",
  "selector": "#product-price"
}

Example Response

{
  "status": "success",
  "result": {
    "answer": "The current price of the product is $49.99",
    "confidence": 0.95,
    "sourceText": "$49.99"
  }
}

For more information on error handling and rate limiting, please refer to our Error Handling guide.